Api-roll 44: 2017-01-23

generated/googleapis/lib/servicemanagement/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.servicemanagement.v1;
 
 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_1;
@@ skipping 460 matching lines @@
                                        "POST",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
-   * Lists all managed services. The result is limited to services that the
-   * caller has "servicemanagement.services.get" permission for. If the request
-   * is made without authentication, it returns only public services that are
-   * available to everyone.
+   * Lists managed services.
+   *
+   * If called without any authentication, it returns only the public services.
+   * If called with authentication, it returns all services that the caller has
+   * "servicemanagement.services.get" permission for.
+   *
+   * **BETA:** If the caller specifies the `consumer_id`, it returns only the
+   * services enabled on the consumer. The `consumer_id` must have the format
+   * of "project:{PROJECT-ID}".
    *
    * Request parameters:
    *
-   * [pageSize] - Requested size of the next page of data.
-   *
-   * [producerProjectId] - Include services produced by the specified project.
-   *
-   * [pageToken] - Token identifying which result to start with; returned by a
-   * previous list
-   * call.
-   *
    * [consumerId] - Include services consumed by the specified consumer.
    *
    * The Google Service Management implementation accepts the following
    * forms:
    * - project:<project_id>
    *
+   * [pageToken] - Token identifying which result to start with; returned by a
+   * previous list
+   * call.
+   *
+   * [pageSize] - Requested size of the next page of data.
+   *
+   * [producerProjectId] - Include services produced by the specified project.
+   *
    * Completes with a [ListServicesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
-  async.Future<ListServicesResponse> list({core.int pageSize, core.String producerProjectId, core.String pageToken, core.String consumerId}) {
+  async.Future<ListServicesResponse> list({core.String consumerId, core.String pageToken, core.int pageSize, core.String producerProjectId}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
+    if (consumerId != null) {
+      _queryParams["consumerId"] = [consumerId];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (producerProjectId != null) {
       _queryParams["producerProjectId"] = [producerProjectId];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
-    if (consumerId != null) {
-      _queryParams["consumerId"] = [consumerId];
-    }
 
     _url = 'v1/services';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 252 matching lines @@
   /**
    * Lists the history of the service configuration for a managed service,
    * from the newest to the oldest.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the
    * [overview](/service-management/overview)
    * for naming requirements.  For example: `example.googleapis.com`.
    *
+   * [pageToken] - The token of the page to retrieve.
+   *
    * [pageSize] - The max number of items to include in the response list.
    *
-   * [pageToken] - The token of the page to retrieve.
-   *
    * Completes with a [ListServiceConfigsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
-  async.Future<ListServiceConfigsResponse> list(core.String serviceName, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListServiceConfigsResponse> list(core.String serviceName, {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 (serviceName == null) {
       throw new core.ArgumentError("Parameter serviceName is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1/services/' + commons.Escaper.ecapeVariable('$serviceName') + '/configs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 167 matching lines @@
   /**
    * Lists the history of the service configuration rollouts for a managed
    * service, from the newest to the oldest.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the
    * [overview](/service-management/overview)
    * for naming requirements.  For example: `example.googleapis.com`.
    *
+   * [pageToken] - The token of the page to retrieve.
+   *
    * [pageSize] - The max number of items to include in the response list.
    *
-   * [pageToken] - The token of the page to retrieve.
-   *
    * Completes with a [ListServiceRolloutsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http_1.Client] completes with an error when making a REST
    * call, this method will complete with the same error.
    */
-  async.Future<ListServiceRolloutsResponse> list(core.String serviceName, {core.int pageSize, core.String pageToken}) {
+  async.Future<ListServiceRolloutsResponse> list(core.String serviceName, {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 (serviceName == null) {
       throw new core.ArgumentError("Parameter serviceName is required.");
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
 
     _url = 'v1/services/' + commons.Escaper.ecapeVariable('$serviceName') + '/rollouts';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 128 matching lines @@
       _json["syntax"] = syntax;
     }
     if (version != null) {
       _json["version"] = version;
     }
     return _json;
   }
 }
 
 /**
- * Provides the configuration for non-admin_activity logging for a service.
- * Controls exemptions and specific log sub-types.
+ * Specifies the audit configuration for a service.
+ * It consists of which permission types are logged, and what identities, if
+ * any, are exempted from logging.
+ * An AuditConifg must have one or more AuditLogConfigs.
  */
 class AuditConfig {
   /**
-   * The configuration for each type of logging
+   * The configuration for logging of each type of permission.
    * Next ID: 4
    */
   core.List<AuditLogConfig> auditLogConfigs;
   /**
    * Specifies the identities that are exempted from "data access" audit
    * logging for the `service` specified above.
    * Follows the same format of Binding.members.
+   * This field is deprecated in favor of per-permission-type exemptions.
    */
   core.List<core.String> exemptedMembers;
   /**
    * Specifies a service that will be enabled for audit logging.
    * For example, `resourcemanager`, `storage`, `compute`.
    * `allServices` is a special value that covers all services.
    */
   core.String service;
 
   AuditConfig();
@@ skipping 18 matching lines @@
     if (exemptedMembers != null) {
       _json["exemptedMembers"] = exemptedMembers;
     }
     if (service != null) {
       _json["service"] = service;
     }
     return _json;
   }
 }
 
-/** Provides the configuration for a sub-type of logging. */
+/**
+ * Provides the configuration for logging a type of permissions.
+ * Example:
+ *
+ *     {
+ *       "audit_log_configs": [
+ *         {
+ *           "log_type": "DATA_READ",
+ *           "exempted_members": [
+ *             "user:foo@gmail.com"
+ *           ]
+ *         },
+ *         {
+ *           "log_type": "DATA_WRITE",
+ *         }
+ *       ]
+ *     }
+ *
+ * This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+ * foo@gmail.com from DATA_READ logging.
+ */
 class AuditLogConfig {
   /**
-   * Specifies the identities that are exempted from this type of logging
+   * Specifies the identities that do not cause logging for this type of
+   * permission.
    * Follows the same format of Binding.members.
    */
   core.List<core.String> exemptedMembers;
   /**
    * The log type that this config enables.
    * Possible string values are:
    * - "LOG_TYPE_UNSPECIFIED" : Default case. Should never be this.
-   * - "ADMIN_READ" : Log admin reads
-   * - "DATA_WRITE" : Log data writes
-   * - "DATA_READ" : Log data reads
+   * - "ADMIN_READ" : Admin reads. Example: CloudIAM getIamPolicy
+   * - "DATA_WRITE" : Data writes. Example: CloudSQL Users create
+   * - "DATA_READ" : Data reads. Example: CloudSQL Users list
    */
   core.String logType;
 
   AuditLogConfig();
 
   AuditLogConfig.fromJson(core.Map _json) {
     if (_json.containsKey("exemptedMembers")) {
       exemptedMembers = _json["exemptedMembers"];
     }
     if (_json.containsKey("logType")) {
@@ skipping 2725 matching lines @@
    * value to zero and sets a new start time for the following
    * points.
    */
   core.String metricKind;
   /**
    * The resource name of the metric descriptor. Depending on the
    * implementation, the name typically includes: (1) the parent resource name
    * that defines the scope of the metric type or of its data; and (2) the
    * metric's URL-encoded type, which also appears in the `type` field of this
    * descriptor. For example, following is the resource name of a custom
-   * metric within the GCP project 123456789:
+   * metric within the GCP project `my-project-id`:
    *
-   * "projects/123456789/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
+   * "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"
    */
   core.String name;
   /**
    * The metric type, including its DNS name prefix. The type is not
-   * URL-encoded.  All user-defined metric types have the DNS name
+   * URL-encoded.  All user-defined custom metric types have the DNS name
    * `custom.googleapis.com`.  Metric types should use a natural hierarchical
    * grouping. For example:
    *
    *     "custom.googleapis.com/invoice/paid/amount"
    *     "appengine.googleapis.com/http/server/response_latencies"
    */
   core.String type;
   /**
    * The unit in which the metric value is reported. It is only applicable
    * if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
@@ skipping 770 matching lines @@
  *           "role": "roles/viewer",
  *           "members": ["user:sean@example.com"]
  *         }
  *       ]
  *     }
  *
  * For a description of IAM and its features, see the
  * [IAM developer's guide](https://cloud.google.com/iam).
  */
 class Policy {
-  /**
-   * Specifies audit logging configs for "data access".
-   * "data access": generally refers to data reads/writes and admin reads.
-   * "admin activity": generally refers to admin writes.
-   *
-   * Note: `AuditConfig` doesn't apply to "admin activity", which always
-   * enables audit logging.
-   */
+  /** Specifies cloud audit logging configuration for this policy. */
   core.List<AuditConfig> auditConfigs;
   /**
    * Associates a list of `members` to a `role`.
    * Multiple `bindings` must not be specified for the same `role`.
    * `bindings` with no members will result in an error.
    */
   core.List<Binding> bindings;
   /**
    * `etag` is used for optimistic concurrency control as a way to help
    * prevent simultaneous updates of a policy from overwriting each other.
@@ skipping 570 matching lines @@
 
 /** Request message for `SetIamPolicy` method. */
 class SetIamPolicyRequest {
   /**
    * REQUIRED: The complete policy to be applied to the `resource`. The size of
    * the policy is limited to a few 10s of KB. An empty policy is a
    * valid policy but certain Cloud Platform services (such as Projects)
    * might reject them.
    */
   Policy policy;
+  /**
+   * OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+   * the fields in the mask will be modified. If no mask is provided, a default
+   * mask is used:
+   * paths: "bindings, etag"
+   * This field is only used by Cloud IAM.
+   */
+  core.String updateMask;
 
   SetIamPolicyRequest();
 
   SetIamPolicyRequest.fromJson(core.Map _json) {
     if (_json.containsKey("policy")) {
       policy = new Policy.fromJson(_json["policy"]);
     }
+    if (_json.containsKey("updateMask")) {
+      updateMask = _json["updateMask"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (policy != null) {
       _json["policy"] = (policy).toJson();
     }
+    if (updateMask != null) {
+      _json["updateMask"] = updateMask;
+    }
     return _json;
   }
 }
 
 /**
  * `SourceContext` represents information about the source of a
  * protobuf element, like the file in which it is defined.
  */
 class SourceContext {
   /**
@@ skipping 777 matching lines @@
     var _json = new core.Map();
     if (restriction != null) {
       _json["restriction"] = restriction;
     }
     if (selector != null) {
       _json["selector"] = selector;
     }
     return _json;
   }
 }