Api-roll 46: 2017-03-06

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 372 matching lines @@
 
   /**
    * Gets a service configuration (version) for a managed service.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the
    * [overview](/service-management/overview)
    * for naming requirements.  For example: `example.googleapis.com`.
    *
+   * [view] - Specifies which parts of the Service Config should be returned in
+   * the
+   * response.
+   * Possible string values are:
+   * - "BASIC" : A BASIC.
+   * - "FULL" : A FULL.
+   *
    * [configId] - The id of the service configuration resource.
    *
    * Completes with a [Service].
    *
    * 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<Service> getConfig(core.String serviceName, {core.String configId}) {
+  async.Future<Service> getConfig(core.String serviceName, {core.String view, core.String configId}) {
     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 (view != null) {
+      _queryParams["view"] = [view];
+    }
     if (configId != null) {
       _queryParams["configId"] = [configId];
     }
 
     _url = 'v1/services/' + commons.Escaper.ecapeVariable('$serviceName') + '/config';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Service.fromJson(data));
   }
 
   /**
    * Gets the access control policy for a resource.
    * Returns an empty policy if the resource exists and does not have a policy
    * set.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^services/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * 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.
    */
@@ skipping 20 matching lines @@
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
    * 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.
+   * Returns all public services. For authenticated users, also returns all
+   * services the calling user 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:
    *
    * [consumerId] - Include services consumed by the specified consumer.
    *
    * The Google Service Management implementation accepts the following
@@ skipping 52 matching lines @@
   /**
    * Sets the access control policy on the specified resource. Replaces any
    * existing policy.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
    * specified.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^services/[^/]+$".
    *
    * Completes with a [Policy].
    *
    * 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.
    */
@@ skipping 22 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Policy.fromJson(data));
   }
 
   /**
    * Returns permissions that a caller has on the specified resource.
    * If the resource does not exist, this will return an empty set of
    * permissions, not a NOT_FOUND error.
    *
+   * Note: This operation is designed to be used for building permission-aware
+   * UIs and command-line tools, not for authorization checking. This operation
+   * may "fail open" without warning.
+   *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
    * requested.
-   * `resource` is usually specified as a path. For example, a Project
-   * resource is specified as `projects/{project}`.
+   * See the operation documentation for the appropriate value for this field.
    * Value must have pattern "^services/[^/]+$".
    *
    * Completes with a [TestIamPermissionsResponse].
    *
    * 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.
    */
@@ skipping 132 matching lines @@
    * Gets a service configuration (version) for a managed service.
    *
    * Request parameters:
    *
    * [serviceName] - The name of the service.  See the
    * [overview](/service-management/overview)
    * for naming requirements.  For example: `example.googleapis.com`.
    *
    * [configId] - The id of the service configuration resource.
    *
+   * [view] - Specifies which parts of the Service Config should be returned in
+   * the
+   * response.
+   * Possible string values are:
+   * - "BASIC" : A BASIC.
+   * - "FULL" : A FULL.
+   *
    * Completes with a [Service].
    *
    * 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<Service> get(core.String serviceName, core.String configId) {
+  async.Future<Service> get(core.String serviceName, core.String configId, {core.String view}) {
     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 (configId == null) {
       throw new core.ArgumentError("Parameter configId is required.");
     }
+    if (view != null) {
+      _queryParams["view"] = [view];
+    }
 
     _url = 'v1/services/' + commons.Escaper.ecapeVariable('$serviceName') + '/configs/' + commons.Escaper.ecapeVariable('$configId');
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 219 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`.
    *
+   * [pageSize] - The max number of items to include in the response list.
+   *
    * [pageToken] - The token of the page to retrieve.
    *
-   * [pageSize] - The max number of items to include in the response list.
-   *
    * 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.String pageToken, core.int pageSize}) {
+  async.Future<ListServiceRolloutsResponse> list(core.String serviceName, {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 (serviceName == null) {
       throw new core.ArgumentError("Parameter serviceName is required.");
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
 
     _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 132 matching lines @@
     }
     return _json;
   }
 }
 
 /**
  * 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.
+ *
+ * If there are AuditConfigs for both `allServices` and a specific service,
+ * the union of the two AuditConfigs is used for that service: the log_types
+ * specified in each AuditConfig are enabled, and the exempted_members in each
+ * AuditConfig are exempted.
+ * Example Policy with multiple AuditConfigs:
+ * {
+ *   "audit_configs": [
+ *     {
+ *       "service": "allServices"
+ *       "audit_log_configs": [
+ *         {
+ *           "log_type": "DATA_READ",
+ *           "exempted_members": [
+ *             "user:foo@gmail.com"
+ *           ]
+ *         },
+ *         {
+ *           "log_type": "DATA_WRITE",
+ *         },
+ *         {
+ *           "log_type": "ADMIN_READ",
+ *         }
+ *       ]
+ *     },
+ *     {
+ *       "service": "fooservice@googleapis.com"
+ *       "audit_log_configs": [
+ *         {
+ *           "log_type": "DATA_READ",
+ *         },
+ *         {
+ *           "log_type": "DATA_WRITE",
+ *           "exempted_members": [
+ *             "user:bar@gmail.com"
+ *           ]
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * }
+ * For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+ * logging. It also exempts foo@gmail.com from DATA_READ logging, and
+ * bar@gmail.com from DATA_WRITE logging.
  */
 class AuditConfig {
   /**
    * 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 341 matching lines @@
     if (requirements != null) {
       _json["requirements"] = requirements.map((value) => (value).toJson()).toList();
     }
     if (selector != null) {
       _json["selector"] = selector;
     }
     return _json;
   }
 }
 
+/**
+ * Configuration of authorization.
+ *
+ * This section determines the authorization provider, if unspecified, then no
+ * authorization check will be done.
+ *
+ * Example:
+ *
+ *     experimental:
+ *       authorization:
+ *         provider: firebaserules.googleapis.com
+ */
+class AuthorizationConfig {
+  /**
+   * The name of the authorization provider, such as
+   * firebaserules.googleapis.com.
+   */
+  core.String provider;
+
+  AuthorizationConfig();
+
+  AuthorizationConfig.fromJson(core.Map _json) {
+    if (_json.containsKey("provider")) {
+      provider = _json["provider"];
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (provider != null) {
+      _json["provider"] = provider;
+    }
+    return _json;
+  }
+}
+
 /** `Backend` defines the backend configuration for a service. */
 class Backend {
   /**
    * A list of API backend rules that apply to individual API methods.
    *
    * **NOTE:** All service configuration rules follow "last one wins" order.
    */
   core.List<BackendRule> rules;
 
   Backend();
@@ skipping 164 matching lines @@
 /** A condition to be met. */
 class Condition {
   /**
    * Trusted attributes supplied by the IAM system.
    * Possible string values are:
    * - "NO_ATTR" : Default non-attribute.
    * - "AUTHORITY" : Either principal or (if present) authority selector.
    * - "ATTRIBUTION" : The principal (even if an authority selector is present),
    * which
    * must only be used for attribution, not authorization.
+   * - "APPROVER" : An approver (distinct from the requester) that has
+   * authorized this
+   * request.
+   * When used with IN, the condition indicates that one of the approvers
+   * associated with the request matches the specified principal, or is a
+   * member of the specified group. Approvers can only grant additional
+   * access, and are thus only used in a strictly positive context
+   * (e.g. ALLOW/IN or DENY/NOT_IN).
+   * See: go/rpc-security-policy-dynamicauth.
+   * - "JUSTIFICATION_TYPE" : What types of justifications have been supplied
+   * with this request.
+   * String values should match enum names from tech.iam.JustificationType,
+   * e.g. "MANUAL_STRING". It is not permitted to grant access based on
+   * the *absence* of a justification, so justification conditions can only
+   * be used in a "positive" context (e.g., ALLOW/IN or DENY/NOT_IN).
+   *
+   * Multiple justifications, e.g., a Buganizer ID and a manually-entered
+   * reason, are normal and supported.
    */
   core.String iam;
   /**
    * An operator to apply the subject with.
    * Possible string values are:
    * - "NO_OP" : Default no-op.
    * - "EQUALS" : DEPRECATED. Use IN instead.
    * - "NOT_EQUALS" : DEPRECATED. Use NOT_IN instead.
-   * - "IN" : Set-inclusion check.
-   * - "NOT_IN" : Set-exclusion check.
+   * - "IN" : The condition is true if the subject (or any element of it if it
+   * is
+   * a set) matches any of the supplied values.
+   * - "NOT_IN" : The condition is true if the subject (or every element of it
+   * if it is
+   * a set) matches none of the supplied values.
    * - "DISCHARGED" : Subject is discharged
    */
   core.String op;
   /** Trusted attributes discharged by the service. */
   core.String svc;
   /**
    * Trusted attributes supplied by any service that owns resources and uses
    * the IAM system for access control.
    * Possible string values are:
    * - "NO_ATTR" : Default non-attribute type
@@ skipping 1029 matching lines @@
     if (number != null) {
       _json["number"] = number;
     }
     if (options != null) {
       _json["options"] = options.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
+/**
+ * Experimental service configuration. These configuration options can
+ * only be used by whitelisted users.
+ */
+class Experimental {
+  /** Authorization configuration. */
+  AuthorizationConfig authorization;
+
+  Experimental();
+
+  Experimental.fromJson(core.Map _json) {
+    if (_json.containsKey("authorization")) {
+      authorization = new AuthorizationConfig.fromJson(_json["authorization"]);
+    }
+  }
+
+  core.Map toJson() {
+    var _json = new core.Map();
+    if (authorization != null) {
+      _json["authorization"] = (authorization).toJson();
+    }
+    return _json;
+  }
+}
+
 /** A single field of a message type. */
 class Field {
   /**
    * The field cardinality.
    * Possible string values are:
    * - "CARDINALITY_UNKNOWN" : For fields with unknown cardinality.
    * - "CARDINALITY_OPTIONAL" : For optional fields.
    * - "CARDINALITY_REQUIRED" : For required fields. Proto2 syntax only.
    * - "CARDINALITY_REPEATED" : For repeated fields.
    */
@@ skipping 492 matching lines @@
    * present at the top-level of request message type.
    */
   core.String body;
   /** Custom pattern is used for defining custom verbs. */
   CustomHttpPattern custom;
   /** Used for deleting a resource. */
   core.String delete;
   /** Used for listing and getting information about resources. */
   core.String get;
   /**
-   * Do not use this. For media support, add instead
-   * [][google.bytestream.RestByteStream] as an API to your
-   * configuration.
+   * Use this only for Scotty Requests. Do not use this for bytestream methods.
+   * For media support, add instead [][google.bytestream.RestByteStream] as an
+   * API to your configuration.
    */
   MediaDownload mediaDownload;
   /**
-   * Do not use this. For media support, add instead
+   * Use this only for Scotty Requests. Do not use this for media support using
+   * Bytestream, add instead
    * [][google.bytestream.RestByteStream] as an API to your
-   * configuration.
+   * configuration for Bytestream methods.
    */
   MediaUpload mediaUpload;
   /** Used for updating a resource. */
   core.String patch;
   /** Used for creating a resource. */
   core.String post;
   /** Used for updating a resource. */
   core.String put;
   /**
    * The name of the response field whose value is mapped to the HTTP body of
@@ skipping 502 matching lines @@
       _json["producerProjectId"] = producerProjectId;
     }
     if (serviceName != null) {
       _json["serviceName"] = serviceName;
     }
     return _json;
   }
 }
 
 /**
- * Do not use this. For media support, add instead
- * [][google.bytestream.RestByteStream] as an API to your
- * configuration.
+ * Use this only for Scotty Requests. Do not use this for media support using
+ * Bytestream, add instead [][google.bytestream.RestByteStream] as an API to
+ * your configuration for Bytestream methods.
  */
 class MediaDownload {
+  /**
+   * DO NOT USE THIS FIELD UNTIL THIS WARNING IS REMOVED.
+   *
+   * Specify name of the download service if one is used for download.
+   */
+  core.String downloadService;
   /** Whether download is enabled. */
   core.bool enabled;
 
   MediaDownload();
 
   MediaDownload.fromJson(core.Map _json) {
+    if (_json.containsKey("downloadService")) {
+      downloadService = _json["downloadService"];
+    }
     if (_json.containsKey("enabled")) {
       enabled = _json["enabled"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (downloadService != null) {
+      _json["downloadService"] = downloadService;
+    }
     if (enabled != null) {
       _json["enabled"] = enabled;
     }
     return _json;
   }
 }
 
 /**
- * Do not use this. For media support, add instead
- * [][google.bytestream.RestByteStream] as an API to your
- * configuration.
+ * Use this only for Scotty Requests. Do not use this for media support using
+ * Bytestream, add instead [][google.bytestream.RestByteStream] as an API to
+ * your configuration for Bytestream methods.
  */
 class MediaUpload {
   /** Whether upload is enabled. */
   core.bool enabled;
+  /**
+   * DO NOT USE THIS FIELD UNTIL THIS WARNING IS REMOVED.
+   *
+   * Specify name of the upload service if one is used for upload.
+   */
+  core.String uploadService;
 
   MediaUpload();
 
   MediaUpload.fromJson(core.Map _json) {
     if (_json.containsKey("enabled")) {
       enabled = _json["enabled"];
     }
+    if (_json.containsKey("uploadService")) {
+      uploadService = _json["uploadService"];
+    }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (enabled != null) {
       _json["enabled"] = enabled;
     }
+    if (uploadService != null) {
+      _json["uploadService"] = uploadService;
+    }
     return _json;
   }
 }
 
 /** Method represents a method of an api. */
 class Method {
   /** The simple name of this method. */
   core.String name;
   /** Any metadata attached to the method. */
   core.List<Option> options;
@@ skipping 1262 matching lines @@
   /**
    * A list of all enum types included in this API service.  Enums
    * referenced directly or indirectly by the `apis` are automatically
    * included.  Enums which are not referenced but shall be included
    * should be listed here by name. Example:
    *
    *     enums:
    *     - name: google.someapi.v1.SomeEnum
    */
   core.List<Enum> enums;
+  /** Experimental configuration. */
+  Experimental experimental;
   /** HTTP configuration. */
   Http http;
   /**
    * A unique ID for a specific instance of this message, typically assigned
    * by the client for tracking purpose. If empty, the server may choose to
    * generate one instead.
    */
   core.String id;
   /** Logging configuration. */
   Logging logging;
@@ skipping 73 matching lines @@
     }
     if (_json.containsKey("documentation")) {
       documentation = new Documentation.fromJson(_json["documentation"]);
     }
     if (_json.containsKey("endpoints")) {
       endpoints = _json["endpoints"].map((value) => new Endpoint.fromJson(value)).toList();
     }
     if (_json.containsKey("enums")) {
       enums = _json["enums"].map((value) => new Enum.fromJson(value)).toList();
     }
+    if (_json.containsKey("experimental")) {
+      experimental = new Experimental.fromJson(_json["experimental"]);
+    }
     if (_json.containsKey("http")) {
       http = new Http.fromJson(_json["http"]);
     }
     if (_json.containsKey("id")) {
       id = _json["id"];
     }
     if (_json.containsKey("logging")) {
       logging = new Logging.fromJson(_json["logging"]);
     }
     if (_json.containsKey("logs")) {
@@ skipping 59 matching lines @@
     }
     if (documentation != null) {
       _json["documentation"] = (documentation).toJson();
     }
     if (endpoints != null) {
       _json["endpoints"] = endpoints.map((value) => (value).toJson()).toList();
     }
     if (enums != null) {
       _json["enums"] = enums.map((value) => (value).toJson()).toList();
     }
+    if (experimental != null) {
+      _json["experimental"] = (experimental).toJson();
+    }
     if (http != null) {
       _json["http"] = (http).toJson();
     }
     if (id != null) {
       _json["id"] = id;
     }
     if (logging != null) {
       _json["logging"] = (logging).toJson();
     }
     if (logs != null) {
@@ skipping 863 matching lines @@
     var _json = new core.Map();
     if (restriction != null) {
       _json["restriction"] = restriction;
     }
     if (selector != null) {
       _json["selector"] = selector;
     }
     return _json;
   }
 }