Api-roll 46: 2017-03-06

generated/googleapis/lib/logging/v2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.logging.v2;
 
 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 109 matching lines @@
    * 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/[^/]+$".
    *
-   * [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 [ListLogsResponse].
    *
    * 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<ListLogsResponse> list(core.String parent, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListLogsResponse> 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 = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 24 matching lines @@
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
    * "billingAccounts/[BILLING_ACCOUNT_ID]"
    * "folders/[FOLDER_ID]"
    * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^billingAccounts/[^/]+$".
    *
    * [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@system.gserviceaccount.com, the
-   * same identity used before the addition of writer identities to this API.
+   * returned as writer_identity is the same group or service account used by
+   * Stackdriver Logging 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.
@@ skipping 203 matching lines @@
    * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
    * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^billingAccounts/[^/]+/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
+   * If the old value is false and the new value is true, then writer_identity
    * is changed to a unique service account.
-   * It is an error if the old value was true and the new value is false.
+   * It is an error if the old value is true and the new value is false.
    *
    * 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> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
@@ skipping 270 matching lines @@
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
    * "billingAccounts/[BILLING_ACCOUNT_ID]"
    * "folders/[FOLDER_ID]"
    * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^folders/[^/]+$".
    *
    * [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@system.gserviceaccount.com, the
-   * same identity used before the addition of writer identities to this API.
+   * returned as writer_identity is the same group or service account used by
+   * Stackdriver Logging 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.
@@ skipping 203 matching lines @@
    * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
    * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^folders/[^/]+/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
+   * If the old value is false and the new value is true, then writer_identity
    * is changed to a unique service account.
-   * It is an error if the old value was true and the new value is false.
+   * It is an error if the old value is true and the new value is false.
    *
    * 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> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
@@ skipping 34 matching lines @@
 
   MonitoredResourceDescriptorsResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Lists the descriptors for monitored resource types used by Stackdriver
    * Logging.
    *
    * Request parameters:
    *
+   * [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 [ListMonitoredResourceDescriptorsResponse].
    *
    * 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<ListMonitoredResourceDescriptorsResponse> list({core.String pageToken, core.int pageSize}) {
+  async.Future<ListMonitoredResourceDescriptorsResponse> list({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 (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _url = 'v2/monitoredResourceDescriptors';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 77 matching lines @@
    * 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/[^/]+$".
    *
-   * [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 [ListLogsResponse].
    *
    * 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<ListLogsResponse> list(core.String parent, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListLogsResponse> 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 = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 24 matching lines @@
    * "projects/[PROJECT_ID]"
    * "organizations/[ORGANIZATION_ID]"
    * "billingAccounts/[BILLING_ACCOUNT_ID]"
    * "folders/[FOLDER_ID]"
    * Examples: "projects/my-logging-project", "organizations/123456789".
    * Value must have pattern "^organizations/[^/]+$".
    *
    * [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@system.gserviceaccount.com, the
-   * same identity used before the addition of writer identities to this API.
+   * returned as writer_identity is the same group or service account used by
+   * Stackdriver Logging 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.
@@ skipping 129 matching lines @@
    * Request parameters:
    *
    * [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 "^organizations/[^/]+$".
    *
-   * [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.int pageSize, core.String pageToken}) {
+  async.Future<ListSinksResponse> 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 = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/sinks';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 20 matching lines @@
    * "folders/[FOLDER_ID]/sinks/[SINK_ID]"
    * Example: "projects/my-project-id/sinks/my-sink-id".
    * Value must have pattern "^organizations/[^/]+/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
+   * If the old value is false and the new value is true, then writer_identity
    * is changed to a unique service account.
-   * It is an error if the old value was true and the new value is false.
+   * It is an error if the old value is true and the new value is false.
    *
    * 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> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
@@ skipping 104 matching lines @@
    * 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/[^/]+$".
    *
+   * [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 [ListLogsResponse].
    *
    * 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<ListLogsResponse> list(core.String parent, {core.String pageToken, core.int pageSize}) {
+  async.Future<ListLogsResponse> 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 = 'v2/' + commons.Escaper.ecapeVariableReserved('$parent') + '/logs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 270 matching lines @@
    * "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@system.gserviceaccount.com, the
-   * same identity used before the addition of writer identities to this API.
+   * returned as writer_identity is the same group or service account used by
+   * Stackdriver Logging 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.
@@ skipping 203 matching lines @@
    * "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
+   * If the old value is false and the new value is true, then writer_identity
    * is changed to a unique service account.
-   * It is an error if the old value was true and the new value is false.
+   * It is an error if the old value is true and the new value is false.
    *
    * 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> update(LogSink request, core.String sinkName, {core.bool uniqueWriterIdentity}) {
@@ skipping 1722 matching lines @@
   WriteLogEntriesResponse();
 
   WriteLogEntriesResponse.fromJson(core.Map _json) {
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     return _json;
   }
 }