Api-roll 45: 2017-02-13

generated/googleapis/lib/deploymentmanager/v2.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.deploymentmanager.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 336 matching lines @@
    * results based on label values.
    *
    * To filter on multiple expressions, provide each separate expression within
    * parentheses. For example, (scheduling.automaticRestart eq true) (zone eq
    * us-central1-f). Multiple expressions are treated as AND expressions,
    * meaning that resources must match all expressions to pass the filters.
    *
    * [maxResults] - The maximum number of results per page that should be
    * returned. If the number of available results is larger than maxResults,
    * Compute Engine returns a nextPageToken that can be used to get the next
-   * page of results in subsequent list requests.
-   * Value must be between "0" and "500".
+   * page of results in subsequent list requests. Acceptable values are 0 to
+   * 500, inclusive. (Default: 500)
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
    * returned in alphanumerical order based on the resource name.
    *
    * You can also sort results in descending order based on the creation
    * timestamp using orderBy="creationTimestamp desc". This sorts results based
    * on the creationTimestamp field in reverse chronological order (newest
    * result first). Use this to sort resources like operations so that the
    * newest operation is returned first.
    *
@@ skipping 466 matching lines @@
    * results based on label values.
    *
    * To filter on multiple expressions, provide each separate expression within
    * parentheses. For example, (scheduling.automaticRestart eq true) (zone eq
    * us-central1-f). Multiple expressions are treated as AND expressions,
    * meaning that resources must match all expressions to pass the filters.
    *
    * [maxResults] - The maximum number of results per page that should be
    * returned. If the number of available results is larger than maxResults,
    * Compute Engine returns a nextPageToken that can be used to get the next
-   * page of results in subsequent list requests.
-   * Value must be between "0" and "500".
+   * page of results in subsequent list requests. Acceptable values are 0 to
+   * 500, inclusive. (Default: 500)
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
    * returned in alphanumerical order based on the resource name.
    *
    * You can also sort results in descending order based on the creation
    * timestamp using orderBy="creationTimestamp desc". This sorts results based
    * on the creationTimestamp field in reverse chronological order (newest
    * result first). Use this to sort resources like operations so that the
    * newest operation is returned first.
    *
@@ skipping 135 matching lines @@
    * results based on label values.
    *
    * To filter on multiple expressions, provide each separate expression within
    * parentheses. For example, (scheduling.automaticRestart eq true) (zone eq
    * us-central1-f). Multiple expressions are treated as AND expressions,
    * meaning that resources must match all expressions to pass the filters.
    *
    * [maxResults] - The maximum number of results per page that should be
    * returned. If the number of available results is larger than maxResults,
    * Compute Engine returns a nextPageToken that can be used to get the next
-   * page of results in subsequent list requests.
-   * Value must be between "0" and "500".
+   * page of results in subsequent list requests. Acceptable values are 0 to
+   * 500, inclusive. (Default: 500)
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
    * returned in alphanumerical order based on the resource name.
    *
    * You can also sort results in descending order based on the creation
    * timestamp using orderBy="creationTimestamp desc". This sorts results based
    * on the creationTimestamp field in reverse chronological order (newest
    * result first). Use this to sort resources like operations so that the
    * newest operation is returned first.
    *
@@ skipping 141 matching lines @@
    * results based on label values.
    *
    * To filter on multiple expressions, provide each separate expression within
    * parentheses. For example, (scheduling.automaticRestart eq true) (zone eq
    * us-central1-f). Multiple expressions are treated as AND expressions,
    * meaning that resources must match all expressions to pass the filters.
    *
    * [maxResults] - The maximum number of results per page that should be
    * returned. If the number of available results is larger than maxResults,
    * Compute Engine returns a nextPageToken that can be used to get the next
-   * page of results in subsequent list requests.
-   * Value must be between "0" and "500".
+   * page of results in subsequent list requests. Acceptable values are 0 to
+   * 500, inclusive. (Default: 500)
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
    * returned in alphanumerical order based on the resource name.
    *
    * You can also sort results in descending order based on the creation
    * timestamp using orderBy="creationTimestamp desc". This sorts results based
    * on the creationTimestamp field in reverse chronological order (newest
    * result first). Use this to sort resources like operations so that the
    * newest operation is returned first.
    *
@@ skipping 89 matching lines @@
    * results based on label values.
    *
    * To filter on multiple expressions, provide each separate expression within
    * parentheses. For example, (scheduling.automaticRestart eq true) (zone eq
    * us-central1-f). Multiple expressions are treated as AND expressions,
    * meaning that resources must match all expressions to pass the filters.
    *
    * [maxResults] - The maximum number of results per page that should be
    * returned. If the number of available results is larger than maxResults,
    * Compute Engine returns a nextPageToken that can be used to get the next
-   * page of results in subsequent list requests.
-   * Value must be between "0" and "500".
+   * page of results in subsequent list requests. Acceptable values are 0 to
+   * 500, inclusive. (Default: 500)
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
    * returned in alphanumerical order based on the resource name.
    *
    * You can also sort results in descending order based on the creation
    * timestamp using orderBy="creationTimestamp desc". This sorts results based
    * on the creationTimestamp field in reverse chronological order (newest
    * result first). Use this to sort resources like operations so that the
    * newest operation is returned first.
    *
@@ skipping 45 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new TypesListResponse.fromJson(data));
   }
 
 }
 
 
 
 /**
- * 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. */
   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.
+   * 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
-   * Follows the same format of Binding.members.
+   * 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. */
   core.String logType;
 
   AuditLogConfig();
 
   AuditLogConfig.fromJson(core.Map _json) {
     if (_json.containsKey("exemptedMembers")) {
       exemptedMembers = _json["exemptedMembers"];
@@ skipping 329 matching lines @@
     }
     if (value != null) {
       _json["value"] = value;
     }
     return _json;
   }
 }
 
 class DeploymentUpdate {
   /**
+   * [Output Only] An optional user-provided description of the deployment after
+   * the current update has been applied.
+   */
+  core.String description;
+  /**
    * [Output Only] Map of labels; provided by the client when the resource is
    * created or updated. Specifically: Label keys must be between 1 and 63
    * characters long and must conform to the following regular expression:
    * [a-z]([-a-z0-9]*[a-z0-9])? Label values must be between 0 and 63 characters
    * long and must conform to the regular expression
    * ([a-z]([-a-z0-9]*[a-z0-9])?)?
    */
   core.List<DeploymentUpdateLabelEntry> labels;
   /**
    * [Output Only] URL of the manifest representing the update configuration of
    * this deployment.
    */
   core.String manifest;
 
   DeploymentUpdate();
 
   DeploymentUpdate.fromJson(core.Map _json) {
+    if (_json.containsKey("description")) {
+      description = _json["description"];
+    }
     if (_json.containsKey("labels")) {
       labels = _json["labels"].map((value) => new DeploymentUpdateLabelEntry.fromJson(value)).toList();
     }
     if (_json.containsKey("manifest")) {
       manifest = _json["manifest"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
+    if (description != null) {
+      _json["description"] = description;
+    }
     if (labels != null) {
       _json["labels"] = labels.map((value) => (value).toJson()).toList();
     }
     if (manifest != null) {
       _json["manifest"] = manifest;
     }
     return _json;
   }
 }
 
@@ skipping 480 matching lines @@
       _json["message"] = message;
     }
     return _json;
   }
 }
 
 /** An Operation resource, used to manage asynchronous API requests. */
 class Operation {
   /** [Output Only] Reserved for future use. */
   core.String clientOperationId;
-  /** [Output Only] Creation timestamp in RFC3339 text format. */
+  /** [Deprecated] This field is deprecated. */
   core.String creationTimestamp;
   /**
    * [Output Only] A textual description of the operation, which is set when the
    * operation is created.
    */
   core.String description;
   /**
    * [Output Only] The time that this operation was completed. This value is in
    * RFC3339 text format.
    */
@@ skipping 290 matching lines @@
  *
  * { "bindings": [ { "role": "roles/owner", "members": [
  * "user:mike@example.com", "group:admins@example.com", "domain:google.com",
  * "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "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. It is
@@ skipping 841 matching lines @@
     var _json = new core.Map();
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     if (types != null) {
       _json["types"] = types.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }