Api-roll 33: 2016-03-14

generated/googleapis_beta/lib/clouduseraccounts/beta.dart

Index: generated/googleapis_beta/lib/clouduseraccounts/beta.dart
diff --git a/generated/googleapis_beta/lib/clouduseraccounts/beta.dart b/generated/googleapis_beta/lib/clouduseraccounts/beta.dart
index a4fe01ec2bf209fc16875a17bd5da302044220e7..99b567281af4c7a90ffa8aee04b387e66aec5beb 100644
--- a/generated/googleapis_beta/lib/clouduseraccounts/beta.dart
+++ b/generated/googleapis_beta/lib/clouduseraccounts/beta.dart
@@ -14,7 +14,10 @@ export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
 
 const core.String USER_AGENT = 'dart-api-client clouduseraccounts/beta';
 
-/** API for the Google Cloud User Accounts service. */
+/**
+ * Creates and manages users and groups for accessing Google Compute Engine
+ * virtual machines.
+ */
 class ClouduseraccountsApi {
   /** View and manage your data across Google Cloud Platform services */
   static const CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform";
@@ -153,19 +156,35 @@ class GlobalAccountsOperationsResourceApi {
    *
    * [filter] - Sets a filter expression for filtering listed resources, in the
    * form filter={expression}. Your {expression} must be in the format:
-   * FIELD_NAME COMPARISON_STRING LITERAL_STRING.
+   * field_name comparison_string literal_string.
    *
-   * The FIELD_NAME is the name of the field you want to compare. Only atomic
-   * field types are supported (string, number, boolean). The COMPARISON_STRING
-   * must be either eq (equals) or ne (not equals). The LITERAL_STRING is the
+   * The field_name is the name of the field you want to compare. Only atomic
+   * field types are supported (string, number, boolean). The comparison_string
+   * must be either eq (equals) or ne (not equals). The literal_string is the
    * string value to filter to. The literal value must be valid for the type of
-   * field (string, number, boolean). For string fields, the literal value is
-   * interpreted as a regular expression using RE2 syntax. The literal value
-   * must match the entire field.
-   *
-   * For example, filter=name ne example-instance.
-   *
-   * [maxResults] - Maximum count of results to be returned.
+   * field you are filtering by (string, number, boolean). For string fields,
+   * the literal value is interpreted as a regular expression using RE2 syntax.
+   * The literal value must match the entire field.
+   *
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
+   *
+   * Compute Engine Beta API Only: If you use filtering in the Beta API, you can
+   * also filter on nested fields. For example, you could filter on instances
+   * that have set the scheduling.automaticRestart field to true. In particular,
+   * use filtering on nested fields to take advantage of instance labels to
+   * organize and filter results based on label values.
+   *
+   * The Beta API also supports filtering on multiple expressions by providing
+   * 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".
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
@@ -179,9 +198,9 @@ class GlobalAccountsOperationsResourceApi {
    *
    * Currently, only sorting by name or creationTimestamp desc is supported.
    *
-   * [pageToken] - Specifies a page token to use. Use this parameter if you want
-   * to list the next page of results. Set pageToken to the nextPageToken
-   * returned by a previous list request.
+   * [pageToken] - Specifies a page token to use. Set pageToken to the
+   * nextPageToken returned by a previous list request to get the next page of
+   * results.
    *
    * Completes with a [OperationList].
    *
@@ -440,19 +459,35 @@ class GroupsResourceApi {
    *
    * [filter] - Sets a filter expression for filtering listed resources, in the
    * form filter={expression}. Your {expression} must be in the format:
-   * FIELD_NAME COMPARISON_STRING LITERAL_STRING.
+   * field_name comparison_string literal_string.
    *
-   * The FIELD_NAME is the name of the field you want to compare. Only atomic
-   * field types are supported (string, number, boolean). The COMPARISON_STRING
-   * must be either eq (equals) or ne (not equals). The LITERAL_STRING is the
+   * The field_name is the name of the field you want to compare. Only atomic
+   * field types are supported (string, number, boolean). The comparison_string
+   * must be either eq (equals) or ne (not equals). The literal_string is the
    * string value to filter to. The literal value must be valid for the type of
-   * field (string, number, boolean). For string fields, the literal value is
-   * interpreted as a regular expression using RE2 syntax. The literal value
-   * must match the entire field.
-   *
-   * For example, filter=name ne example-instance.
-   *
-   * [maxResults] - Maximum count of results to be returned.
+   * field you are filtering by (string, number, boolean). For string fields,
+   * the literal value is interpreted as a regular expression using RE2 syntax.
+   * The literal value must match the entire field.
+   *
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
+   *
+   * Compute Engine Beta API Only: If you use filtering in the Beta API, you can
+   * also filter on nested fields. For example, you could filter on instances
+   * that have set the scheduling.automaticRestart field to true. In particular,
+   * use filtering on nested fields to take advantage of instance labels to
+   * organize and filter results based on label values.
+   *
+   * The Beta API also supports filtering on multiple expressions by providing
+   * 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".
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
@@ -466,9 +501,9 @@ class GroupsResourceApi {
    *
    * Currently, only sorting by name or creationTimestamp desc is supported.
    *
-   * [pageToken] - Specifies a page token to use. Use this parameter if you want
-   * to list the next page of results. Set pageToken to the nextPageToken
-   * returned by a previous list request.
+   * [pageToken] - Specifies a page token to use. Set pageToken to the
+   * nextPageToken returned by a previous list request to get the next page of
+   * results.
    *
    * Completes with a [GroupList].
    *
@@ -659,19 +694,35 @@ class LinuxResourceApi {
    *
    * [filter] - Sets a filter expression for filtering listed resources, in the
    * form filter={expression}. Your {expression} must be in the format:
-   * FIELD_NAME COMPARISON_STRING LITERAL_STRING.
+   * field_name comparison_string literal_string.
    *
-   * The FIELD_NAME is the name of the field you want to compare. Only atomic
-   * field types are supported (string, number, boolean). The COMPARISON_STRING
-   * must be either eq (equals) or ne (not equals). The LITERAL_STRING is the
+   * The field_name is the name of the field you want to compare. Only atomic
+   * field types are supported (string, number, boolean). The comparison_string
+   * must be either eq (equals) or ne (not equals). The literal_string is the
    * string value to filter to. The literal value must be valid for the type of
-   * field (string, number, boolean). For string fields, the literal value is
-   * interpreted as a regular expression using RE2 syntax. The literal value
-   * must match the entire field.
-   *
-   * For example, filter=name ne example-instance.
-   *
-   * [maxResults] - Maximum count of results to be returned.
+   * field you are filtering by (string, number, boolean). For string fields,
+   * the literal value is interpreted as a regular expression using RE2 syntax.
+   * The literal value must match the entire field.
+   *
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
+   *
+   * Compute Engine Beta API Only: If you use filtering in the Beta API, you can
+   * also filter on nested fields. For example, you could filter on instances
+   * that have set the scheduling.automaticRestart field to true. In particular,
+   * use filtering on nested fields to take advantage of instance labels to
+   * organize and filter results based on label values.
+   *
+   * The Beta API also supports filtering on multiple expressions by providing
+   * 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".
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
@@ -685,9 +736,9 @@ class LinuxResourceApi {
    *
    * Currently, only sorting by name or creationTimestamp desc is supported.
    *
-   * [pageToken] - Specifies a page token to use. Use this parameter if you want
-   * to list the next page of results. Set pageToken to the nextPageToken
-   * returned by a previous list request.
+   * [pageToken] - Specifies a page token to use. Set pageToken to the
+   * nextPageToken returned by a previous list request to get the next page of
+   * results.
    *
    * Completes with a [LinuxGetLinuxAccountViewsResponse].
    *
@@ -954,19 +1005,35 @@ class UsersResourceApi {
    *
    * [filter] - Sets a filter expression for filtering listed resources, in the
    * form filter={expression}. Your {expression} must be in the format:
-   * FIELD_NAME COMPARISON_STRING LITERAL_STRING.
+   * field_name comparison_string literal_string.
    *
-   * The FIELD_NAME is the name of the field you want to compare. Only atomic
-   * field types are supported (string, number, boolean). The COMPARISON_STRING
-   * must be either eq (equals) or ne (not equals). The LITERAL_STRING is the
+   * The field_name is the name of the field you want to compare. Only atomic
+   * field types are supported (string, number, boolean). The comparison_string
+   * must be either eq (equals) or ne (not equals). The literal_string is the
    * string value to filter to. The literal value must be valid for the type of
-   * field (string, number, boolean). For string fields, the literal value is
-   * interpreted as a regular expression using RE2 syntax. The literal value
-   * must match the entire field.
-   *
-   * For example, filter=name ne example-instance.
-   *
-   * [maxResults] - Maximum count of results to be returned.
+   * field you are filtering by (string, number, boolean). For string fields,
+   * the literal value is interpreted as a regular expression using RE2 syntax.
+   * The literal value must match the entire field.
+   *
+   * For example, to filter for instances that do not have a name of
+   * example-instance, you would use filter=name ne example-instance.
+   *
+   * Compute Engine Beta API Only: If you use filtering in the Beta API, you can
+   * also filter on nested fields. For example, you could filter on instances
+   * that have set the scheduling.automaticRestart field to true. In particular,
+   * use filtering on nested fields to take advantage of instance labels to
+   * organize and filter results based on label values.
+   *
+   * The Beta API also supports filtering on multiple expressions by providing
+   * 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".
    *
    * [orderBy] - Sorts list results by a certain order. By default, results are
@@ -980,9 +1047,9 @@ class UsersResourceApi {
    *
    * Currently, only sorting by name or creationTimestamp desc is supported.
    *
-   * [pageToken] - Specifies a page token to use. Use this parameter if you want
-   * to list the next page of results. Set pageToken to the nextPageToken
-   * returned by a previous list request.
+   * [pageToken] - Specifies a page token to use. Set pageToken to the
+   * nextPageToken returned by a previous list request to get the next page of
+   * results.
    *
    * Completes with a [UserList].
    *
@@ -1496,7 +1563,7 @@ class OperationErrorErrors {
   /** [Output Only] The error type identifier for this error. */
   core.String code;
   /**
-   * [Output Only] Indicates the field in the request which caused the error.
+   * [Output Only] Indicates the field in the request that caused the error.
    * This property is optional.
    */
   core.String location;
@@ -1561,7 +1628,15 @@ class OperationError {
 }
 
 class OperationWarningsData {
-  /** [Output Only] A key for the warning data. */
+  /**
+   * [Output Only] A key that provides more detail on the warning being
+   * returned. For example, for warnings where there are no results in a list
+   * request for a particular zone, this key might be scope and the key value
+   * might be the zone name. Other examples might be a key indicating a
+   * deprecated resource and a suggested replacement, or a warning about invalid
+   * network settings (for example, if an instance attempts to perform IP
+   * forwarding but is not enabled for IP forwarding).
+   */
   core.String key;
   /** [Output Only] A warning data value corresponding to the key. */
   core.String value;
@@ -1591,8 +1666,10 @@ class OperationWarningsData {
 
 class OperationWarnings {
   /**
-   * [Output Only] The warning type identifier for this warning.
+   * [Output Only] A warning code, if applicable. For example, Compute Engine
+   * returns NO_RESULTS_ON_PAGE if there are no results in the response.
    * Possible string values are:
+   * - "CLEANUP_FAILED"
    * - "DEPRECATED_RESOURCE_USED"
    * - "DISK_SIZE_LARGER_THAN_IMAGE_SIZE"
    * - "INJECTED_KERNELS_DEPRECATED"
@@ -1609,9 +1686,13 @@ class OperationWarnings {
    * - "UNREACHABLE"
    */
   core.String code;
-  /** [Output Only] Metadata for this warning in key: value format. */
+  /**
+   * [Output Only] Metadata about this warning in key: value format. For
+   * example:
+   * "data": [ { "key": "scope", "value": "zones/us-east1-d" }
+   */
   core.List<OperationWarningsData> data;
-  /** [Output Only] Optional human-readable details for this warning. */
+  /** [Output Only] A human-readable description of the warning code. */
   core.String message;
 
   OperationWarnings();
@@ -1645,16 +1726,17 @@ class OperationWarnings {
 
 /** An Operation resource, used to manage asynchronous API requests. */
 class Operation {
-  /**
-   * [Output Only] An optional identifier specified by the client when the
-   * mutation was initiated. Must be unique for all Operation resources in the
-   * project.
-   */
+  /** [Output Only] Reserved for future use. */
   core.String clientOperationId;
   /** [Output Only] Creation timestamp in RFC3339 text format. */
   core.String creationTimestamp;
   /**
-   * [Output Only] The time that this operation was completed. This is in
+   * [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.
    */
   core.String endTime;
@@ -1670,53 +1752,55 @@ class Operation {
   core.String httpErrorMessage;
   /**
    * [Output Only] If the operation fails, this field contains the HTTP error
-   * message that was returned, such as 404.
+   * status code that was returned. For example, a 404 means the resource was
+   * not found.
    */
   core.int httpErrorStatusCode;
   /**
-   * [Output Only] Unique identifier for the resource; defined by the server.
+   * [Output Only] The unique identifier for the resource. This identifier is
+   * defined by the server.
    */
   core.String id;
   /**
-   * [Output Only] The time that this operation was requested. This is in
+   * [Output Only] The time that this operation was requested. This value is in
    * RFC3339 text format.
    */
   core.String insertTime;
   /**
-   * [Output Only] Type of the resource. Always compute#operation for Operation
+   * [Output Only] Type of the resource. Always compute#operation for operation
    * resources.
    */
   core.String kind;
   /** [Output Only] Name of the resource. */
   core.String name;
   /**
-   * [Output Only] Type of the operation, such as insert,
-   * compute.instanceGroups.update, or compute.instanceGroups.delete.
+   * [Output Only] The type of operation, such as insert, update, or delete, and
+   * so on.
    */
   core.String operationType;
   /**
    * [Output Only] An optional progress indicator that ranges from 0 to 100.
    * There is no requirement that this be linear or support any granularity of
-   * operations. This should not be used to guess at when the operation will be
+   * operations. This should not be used to guess when the operation will be
    * complete. This number should monotonically increase as the operation
    * progresses.
    */
   core.int progress;
   /**
-   * [Output Only] URL of the region where the operation resides. Only
-   * applicable for regional resources.
+   * [Output Only] The URL of the region where the operation resides. Only
+   * available when performing regional operations.
    */
   core.String region;
   /** [Output Only] Server-defined URL for the resource. */
   core.String selfLink;
   /**
    * [Output Only] The time that this operation was started by the server. This
-   * is in RFC3339 text format.
+   * value is in RFC3339 text format.
    */
   core.String startTime;
   /**
-   * [Output Only] Status of the operation. Can be one of the following:
-   * PENDING, RUNNING, or DONE.
+   * [Output Only] The status of the operation, which can be one of the
+   * following: PENDING, RUNNING, or DONE.
    * Possible string values are:
    * - "DONE"
    * - "PENDING"
@@ -1729,11 +1813,11 @@ class Operation {
    */
   core.String statusMessage;
   /**
-   * [Output Only] Unique target ID which identifies a particular incarnation of
-   * the target.
+   * [Output Only] The unique target ID, which identifies a specific incarnation
+   * of the target resource.
    */
   core.String targetId;
-  /** [Output Only] URL of the resource the operation is mutating. */
+  /** [Output Only] The URL of the resource that the operation modifies. */
   core.String targetLink;
   /**
    * [Output Only] User who requested the operation, for example:
@@ -1745,7 +1829,10 @@ class Operation {
    * operation, this field will be populated.
    */
   core.List<OperationWarnings> warnings;
-  /** [Output Only] URL of the zone where the operation resides. */
+  /**
+   * [Output Only] The URL of the zone where the operation resides. Only
+   * available when performing per-zone operations.
+   */
   core.String zone;
 
   Operation();
@@ -1757,6 +1844,9 @@ class Operation {
     if (_json.containsKey("creationTimestamp")) {
       creationTimestamp = _json["creationTimestamp"];
     }
+    if (_json.containsKey("description")) {
+      description = _json["description"];
+    }
     if (_json.containsKey("endTime")) {
       endTime = _json["endTime"];
     }
@@ -1827,6 +1917,9 @@ class Operation {
     if (creationTimestamp != null) {
       _json["creationTimestamp"] = creationTimestamp;
     }
+    if (description != null) {
+      _json["description"] = description;
+    }
     if (endTime != null) {
       _json["endTime"] = endTime;
     }
@@ -1894,17 +1987,24 @@ class Operation {
 /** Contains a list of Operation resources. */
 class OperationList {
   /**
-   * [Output Only] Unique identifier for the resource; defined by the server.
+   * [Output Only] The unique identifier for the resource. This identifier is
+   * defined by the server.
    */
   core.String id;
-  /** [Output Only] The Operation resources. */
+  /** [Output Only] A list of Operation resources. */
   core.List<Operation> items;
   /**
    * [Output Only] Type of resource. Always compute#operations for Operations
    * resource.
    */
   core.String kind;
-  /** [Output Only] A token used to continue a truncate. */
+  /**
+   * [Output Only] This token allows you to get the next page of results for
+   * list requests. If the number of results is larger than maxResults, use the
+   * nextPageToken as a value for the query parameter pageToken in the next list
+   * request. Subsequent list requests will have their own nextPageToken to
+   * continue paging through the results.
+   */
   core.String nextPageToken;
   /** [Output Only] Server-defined URL for this resource. */
   core.String selfLink;