Api-roll 45: 2017-02-13

generated/googleapis_beta/lib/logging/v2beta1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis_beta.logging.v2beta1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 45 matching lines @@
 
 
 class BillingAccountsLogsResourceApi {
   final commons.ApiRequester _requester;
 
   BillingAccountsLogsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Deletes all the log entries in a log. The log reappears if it receives new
-   * entries.
+   * entries. Log entries written shortly before the delete operation might not
+   * be deleted.
    *
    * Request parameters:
    *
    * [logName] - Required. The resource name of the log to delete:
    * "projects/[PROJECT_ID]/logs/[LOG_ID]"
    * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+   * "folders/[FOLDER_ID]/logs/[LOG_ID]"
    * [LOG_ID] must be URL-encoded. For example,
    * "projects/my-project-id/logs/syslog",
    * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
    * For more information about log names, see LogEntry.
    * Value must have pattern "^billingAccounts/[^/]+/logs/[^/]+$".
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 19 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Empty.fromJson(data));
   }
 
   /**
-   * Lists the logs in projects or organizations. Only logs that have entries
-   * are listed.
+   * Lists the logs in projects, organizations, folders, or billing accounts.
+   * Only logs that have entries are listed.
    *
    * Request parameters:
    *
    * [parent] - Required. The resource name that owns the logs:
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]"
+   * "folders/[FOLDER_ID]"
    *
    * Value must have pattern "^billingAccounts/[^/]+$".
    *
    * [pageToken] - Optional. If present, then retrieve the next batch of results
    * from the preceding call to this method. pageToken must be the value of
    * nextPageToken from the previous response. The values of other method
    * parameters should be identical to those in the previous call.
    *
    * [pageSize] - Optional. The maximum number of results to return from this
    * request. Non-positive values are ignored. The presence of nextPageToken in
@@ skipping 199 matching lines @@
 
 
 class OrganizationsLogsResourceApi {
   final commons.ApiRequester _requester;
 
   OrganizationsLogsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Deletes all the log entries in a log. The log reappears if it receives new
-   * entries.
+   * entries. Log entries written shortly before the delete operation might not
+   * be deleted.
    *
    * Request parameters:
    *
    * [logName] - Required. The resource name of the log to delete:
    * "projects/[PROJECT_ID]/logs/[LOG_ID]"
    * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+   * "folders/[FOLDER_ID]/logs/[LOG_ID]"
    * [LOG_ID] must be URL-encoded. For example,
    * "projects/my-project-id/logs/syslog",
    * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
    * For more information about log names, see LogEntry.
    * Value must have pattern "^organizations/[^/]+/logs/[^/]+$".
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 19 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Empty.fromJson(data));
   }
 
   /**
-   * Lists the logs in projects or organizations. Only logs that have entries
-   * are listed.
+   * Lists the logs in projects, organizations, folders, or billing accounts.
+   * Only logs that have entries are listed.
    *
    * Request parameters:
    *
    * [parent] - Required. The resource name that owns the logs:
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]"
+   * "folders/[FOLDER_ID]"
    *
    * Value must have pattern "^organizations/[^/]+$".
    *
    * [pageToken] - Optional. If present, then retrieve the next batch of results
    * from the preceding call to this method. pageToken must be the value of
    * nextPageToken from the previous response. The values of other method
    * parameters should be identical to those in the previous call.
    *
    * [pageSize] - Optional. The maximum number of results to return from this
    * request. Non-positive values are ignored. The presence of nextPageToken in
@@ skipping 53 matching lines @@
 
 
 class ProjectsLogsResourceApi {
   final commons.ApiRequester _requester;
 
   ProjectsLogsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Deletes all the log entries in a log. The log reappears if it receives new
-   * entries.
+   * entries. Log entries written shortly before the delete operation might not
+   * be deleted.
    *
    * Request parameters:
    *
    * [logName] - Required. The resource name of the log to delete:
    * "projects/[PROJECT_ID]/logs/[LOG_ID]"
    * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+   * "folders/[FOLDER_ID]/logs/[LOG_ID]"
    * [LOG_ID] must be URL-encoded. For example,
    * "projects/my-project-id/logs/syslog",
    * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
    * For more information about log names, see LogEntry.
    * Value must have pattern "^projects/[^/]+/logs/[^/]+$".
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
@@ skipping 19 matching lines @@
                                        "DELETE",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Empty.fromJson(data));
   }
 
   /**
-   * Lists the logs in projects or organizations. Only logs that have entries
-   * are listed.
+   * Lists the logs in projects, organizations, folders, or billing accounts.
+   * Only logs that have entries are listed.
    *
    * Request parameters:
    *
    * [parent] - Required. The resource name that owns the logs:
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]"
+   * "folders/[FOLDER_ID]"
    *
    * Value must have pattern "^projects/[^/]+$".
    *
    * [pageToken] - Optional. If present, then retrieve the next batch of results
    * from the preceding call to this method. pageToken must be the value of
    * nextPageToken from the previous response. The values of other method
    * parameters should be identical to those in the previous call.
    *
    * [pageSize] - Optional. The maximum number of results to return from this
    * request. Non-positive values are ignored. The presence of nextPageToken in
@@ skipping 180 matching lines @@
   /**
    * Lists logs-based metrics.
    *
    * Request parameters:
    *
    * [parent] - Required. The name of the project containing the metrics:
    * "projects/[PROJECT_ID]"
    *
    * Value must have pattern "^projects/[^/]+$".
    *
-   * [pageSize] - Optional. The maximum number of results to return from this
-   * request. Non-positive values are ignored. The presence of nextPageToken in
-   * the response indicates that more results might be available.
-   *
    * [pageToken] - Optional. If present, then retrieve the next batch of results
    * from the preceding call to this method. pageToken must be the value of
    * nextPageToken from the previous response. The values of other method
    * parameters should be identical to those in the previous call.
    *
+   * [pageSize] - Optional. The maximum number of results to return from this
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
+   *
    * Completes with a [ListLogMetricsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListLogMetricsResponse> list(core.String parent, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListLogMetricsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v2beta1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/metrics';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 65 matching lines @@
    * writer_identity is not permitted to write to the destination. A sink can
    * export log entries only from the resource owning the sink.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [parent] - Required. The resource in which to create the sink:
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]"
+   * "folders/[FOLDER_ID]"
    * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^projects/[^/]+$".
    *
    * [uniqueWriterIdentity] - Optional. Determines the kind of IAM identity
    * returned as writer_identity in the new sink. If this value is omitted or
    * set to false, and if the sink's parent is a project, then the value
-   * returned as writer_identity is cloud-logs@google.com, the same identity
-   * used before the addition of writer identities to this API. The sink's
-   * destination must be in the same project as the sink itself.If this field is
-   * set to true, or if the sink is owned by a non-project resource such as an
-   * organization, then the value of writer_identity will be a unique service
-   * account used only for exports from the new sink. For more information, see
-   * writer_identity in LogSink.
+   * returned as writer_identity is cloud-logs@system.gserviceaccount.com, the
+   * same identity used before the addition of writer identities to this API.
+   * The sink's destination must be in the same project as the sink itself.If
+   * this field is set to true, or if the sink is owned by a non-project
+   * resource such as an organization, then the value of writer_identity will be
+   * a unique service account used only for exports from the new sink. For more
+   * information, see writer_identity in LogSink.
    *
    * Completes with a [LogSink].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<LogSink> create(LogSink request, core.String parent, {core.bool uniqueWriterIdentity}) {
@@ skipping 29 matching lines @@
   /**
    * Deletes a sink. If the sink has a unique writer_identity, then that service
    * account is also deleted.
    *
    * Request parameters:
    *
    * [sinkName] - Required. The full resource name of the sink to delete,
    * including the parent resource and the sink identifier:
    * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
    * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
-   * It is an error if the sink does not exist. Example:
-   * "projects/my-project-id/sinks/my-sink-id". It is an error if the sink does
-   * not exist.
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+   * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
+   * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
@@ skipping 19 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Empty.fromJson(data));
   }
 
   /**
    * Gets a sink.
    *
    * Request parameters:
    *
-   * [sinkName] - Required. The parent resource name of the sink:
+   * [sinkName] - Required. The resource name of the sink:
    * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
    * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+   * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
    * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
    *
    * Completes with a [LogSink].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
@@ skipping 20 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new LogSink.fromJson(data));
   }
 
   /**
    * Lists sinks.
    *
    * Request parameters:
    *
-   * [parent] - Required. The parent resource whose sinks are to be listed.
-   * Examples: "projects/my-logging-project", "organizations/123456789".
+   * [parent] - Required. The parent resource whose sinks are to be listed:
+   * "projects/[PROJECT_ID]"
+   * "organizations/[ORGANIZATION_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]"
+   * "folders/[FOLDER_ID]"
+   *
    * Value must have pattern "^projects/[^/]+$".
    *
+   * [pageSize] - Optional. The maximum number of results to return from this
+   * request. Non-positive values are ignored. The presence of nextPageToken in
+   * the response indicates that more results might be available.
+   *
    * [pageToken] - Optional. If present, then retrieve the next batch of results
    * from the preceding call to this method. pageToken must be the value of
    * nextPageToken from the previous response. The values of other method
    * parameters should be identical to those in the previous call.
    *
-   * [pageSize] - Optional. The maximum number of results to return from this
-   * request. Non-positive values are ignored. The presence of nextPageToken in
-   * the response indicates that more results might be available.
-   *
    * Completes with a [ListSinksResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListSinksResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+  async.Future<ListSinksResponse> list(core.String parent, {core.int pageSize, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _url = 'v2beta1/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListSinksResponse.fromJson(data));
   }
 
   /**
    * Updates a sink. If the named sink doesn't exist, then this method is
    * identical to sinks.create. If the named sink does exist, then this method
    * replaces the following fields in the existing sink with values from the new
    * sink: destination, filter, output_version_format, start_time, and end_time.
    * The updated filter might also have a new writer_identity; see the
    * unique_writer_identity field.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [sinkName] - Required. The full resource name of the sink to update,
    * including the parent resource and the sink identifier:
    * "projects/[PROJECT_ID]/sinks/[SINK_ID]"
    * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+   * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
    * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^projects/[^/]+/sinks/[^/]+$".
    *
    * [uniqueWriterIdentity] - Optional. See sinks.create for a description of
    * this field. When updating a sink, the effect of this field on the value of
    * writer_identity in the updated sink depends on both the old and new values
    * of this field:
    * If the old and new values of this field are both false or both true, then
    * there is no change to the sink's writer_identity.
    * If the old value was false and the new value is true, then writer_identity
@@ skipping 309 matching lines @@
    */
   core.String pageToken;
   /**
    * Deprecated. Use resource_names instead. One or more project identifiers or
    * project numbers from which to retrieve log entries. Example:
    * "my-project-1A". If present, these project identifiers are converted to
    * resource name format and added to the list of resources in resource_names.
    */
   core.List<core.String> projectIds;
   /**
-   * Required. Names of one or more resources from which to retrieve log
+   * Required. Names of one or more parent resources from which to retrieve log
    * entries:
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]"
+   * "folders/[FOLDER_ID]"
    * Projects listed in the project_ids field are added to this list.
    */
   core.List<core.String> resourceNames;
 
   ListLogEntriesRequest();
 
   ListLogEntriesRequest.fromJson(core.Map _json) {
     if (_json.containsKey("filter")) {
       filter = _json["filter"];
     }
@@ skipping 241 matching lines @@
   core.Map<core.String, core.Object> jsonPayload;
   /**
    * Optional. A set of user-defined (key, value) data that provides additional
    * information about the log entry.
    */
   core.Map<core.String, core.String> labels;
   /**
    * Required. The resource name of the log to which this log entry belongs:
    * "projects/[PROJECT_ID]/logs/[LOG_ID]"
    * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+   * "folders/[FOLDER_ID]/logs/[LOG_ID]"
    * [LOG_ID] must be URL-encoded within log_name. Example:
    * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
    * [LOG_ID] must be less than 512 characters long and can only include the
    * following characters: upper and lower case alphanumeric characters,
    * forward-slash, underscore, hyphen, and period.For backward compatibility,
    * if log_name begins with a forward-slash, such as /projects/..., then the
    * log entry is ingested as usual but the forward-slash is removed. Listing
    * the log entry will not show the leading slash and filtering for a log name
    * with a leading slash will never return any results.
    */
@@ skipping 388 matching lines @@
       _json["version"] = version;
     }
     return _json;
   }
 }
 
 /**
  * Describes a sink used to export log entries to one of the following
  * destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
  * Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
- * The sink must be created within a project or organization.
+ * The sink must be created within a project, organization, billing account, or
+ * folder.
  */
 class LogSink {
   /**
    * Required. The export destination:
    * "storage.googleapis.com/[GCS_BUCKET]"
    * "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
    * "pubsub.googleapis.com/projects/[PROJECT_ID]/topics/[TOPIC_ID]"
    * The sink's writer_identity, set when the sink is created, must have
    * permission to write to the destination or else the log entries are not
    * exported. For more information, see Exporting Logs With Sinks.
@@ skipping 646 matching lines @@
    * entries in entries. If a log entry already has a label with the same key as
    * a label in this parameter, then the log entry's label is not changed. See
    * LogEntry.
    */
   core.Map<core.String, core.String> labels;
   /**
    * Optional. A default log resource name that is assigned to all log entries
    * in entries that do not specify a value for log_name:
    * "projects/[PROJECT_ID]/logs/[LOG_ID]"
    * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+   * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+   * "folders/[FOLDER_ID]/logs/[LOG_ID]"
    * [LOG_ID] must be URL-encoded. For example,
    * "projects/my-project-id/logs/syslog" or
    * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity".
    * For more information about log names, see LogEntry.
    */
   core.String logName;
   /**
    * Optional. Whether valid entries should be written even if some other
    * entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
    * entry is not written, the response status will be the error associated with
@@ skipping 58 matching lines @@
   WriteLogEntriesResponse();
 
   WriteLogEntriesResponse.fromJson(core.Map _json) {
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     return _json;
   }
 }