google-api-client 0.9.3 → 0.9.4

data/generated/google/apis/cloudresourcemanager_v1/service.rb

@@ -0,0 +1,373 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module CloudresourcemanagerV1
+      # Google Cloud Resource Manager API
+      #
+      # The Google Cloud Resource Manager API provides methods for creating, reading,
+      #  and updating project metadata.
+      #
+      # @example
+      #    require 'google/apis/cloudresourcemanager_v1'
+      #
+      #    Cloudresourcemanager = Google::Apis::CloudresourcemanagerV1 # Alias the module
+      #    service = Cloudresourcemanager::CloudresourcemanagerService.new
+      #
+      # @see https://cloud.google.com/resource-manager
+      class CloudresourcemanagerService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  Available to use for quota purposes for server-side applications. Can be any
+        #  arbitrary string assigned to a user, but should not exceed 40 characters.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://cloudresourcemanager.googleapis.com/', '')
+        end
+        
+        # Retrieves the Project identified by the specified `project_id` (for example, `
+        # my-project-123`). The caller must have read permissions for this Project.
+        # @param [String] project_id
+        #   The Project ID (for example, `my-project-123`). Required.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::Project] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Project]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project(project_id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/projects/{projectId}', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Project::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Project
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists Projects that are visible to the user and satisfy the specified filter.
+        # This method returns Projects in an unspecified order. New Projects do not
+        # necessarily appear at the end of the list.
+        # @param [String] page_token
+        #   A pagination token returned from a previous call to ListProjects that
+        #   indicates from where listing should continue. Optional.
+        # @param [Fixnum] page_size
+        #   The maximum number of Projects to return in the response. The server can
+        #   return fewer Projects than requested. If unspecified, server picks an
+        #   appropriate default. Optional.
+        # @param [String] filter
+        #   An expression for filtering the results of the request. Filter rules are case
+        #   insensitive. The fields eligible for filtering are: + `name` + `id` + labels.
+        #   key where *key* is the name of a label Some examples of using labels as
+        #   filters: |Filter|Description| |------|-----------| |name:*|The project has a
+        #   name.| |name:Howl|The project's name is `Howl` or `howl`.| |name:HOWL|
+        #   Equivalent to above.| |NAME:howl|Equivalent to above.| |labels.color:*|The
+        #   project has the label `color`.| |labels.color:red|The project's label `color`
+        #   has the value `red`.| |labels.color:red label.size:big|The project's label `
+        #   color` has the value `red` and its label `size` has the value `big`. Optional.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::ListProjectsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::ListProjectsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_projects(page_token: nil, page_size: nil, filter: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/projects', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::ListProjectsResponse::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::ListProjectsResponse
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the attributes of the Project identified by the specified `project_id`
+        # (for example, `my-project-123`). The caller must have modify permissions for
+        # this Project.
+        # @param [String] project_id
+        #   The project ID (for example, `my-project-123`). Required.
+        # @param [Google::Apis::CloudresourcemanagerV1::Project] project_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::Project] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Project]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_project(project_id, project_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'v1/projects/{projectId}', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::Project::Representation
+          command.request_object = project_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Project::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Project
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Marks the Project identified by the specified `project_id` (for example, `my-
+        # project-123`) for deletion. This method will only affect the Project if the
+        # following criteria are met: + The Project does not have a billing account
+        # associated with it. + The Project has a lifecycle state of ACTIVE. This method
+        # changes the Project's lifecycle state from ACTIVE to DELETE_REQUESTED. The
+        # deletion starts at an unspecified time, at which point the lifecycle state
+        # changes to DELETE_IN_PROGRESS. Until the deletion completes, you can check the
+        # lifecycle state checked by retrieving the Project with GetProject, and the
+        # Project remains visible to ListProjects. However, you cannot update the
+        # project. After the deletion completes, the Project is not retrievable by the
+        # GetProject and ListProjects methods. The caller must have modify permissions
+        # for this Project.
+        # @param [String] project_id
+        #   The Project ID (for example, `foo-bar-123`). Required.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_project(project_id, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1/projects/{projectId}', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Empty::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Empty
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Restores the Project identified by the specified `project_id` (for example, `
+        # my-project-123`). You can only use this method for a Project that has a
+        # lifecycle state of DELETE_REQUESTED. After deletion starts, as indicated by a
+        # lifecycle state of DELETE_IN_PROGRESS, the Project cannot be restored. The
+        # caller must have modify permissions for this Project.
+        # @param [String] project_id
+        #   The project ID (for example, `foo-bar-123`). Required.
+        # @param [Google::Apis::CloudresourcemanagerV1::UndeleteProjectRequest] undelete_project_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Empty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def undelete_project(project_id, undelete_project_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects/{projectId}:undelete', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::UndeleteProjectRequest::Representation
+          command.request_object = undelete_project_request_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Empty::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Empty
+          command.params['projectId'] = project_id unless project_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns the IAM access control policy for the specified Project. Permission is
+        # denied if the policy or the resource does not exist.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being requested. `resource` is
+        #   usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*
+        #   disk*`. The format for the path specified in this value is resource specific
+        #   and is specified in the `getIamPolicy` documentation.
+        # @param [Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest] get_iam_policy_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects/{resource}:getIamPolicy', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest::Representation
+          command.request_object = get_iam_policy_request_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Policy::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sets the IAM access control policy for the specified Project. Replaces any
+        # existing policy. The following constraints apply when using `setIamPolicy()`: +
+        # Project currently supports only `user:`emailid`` and `serviceAccount:`emailid`
+        # ` members in a `Binding` of a `Policy`. + To be added as an `owner`, a user
+        # must be invited via Cloud Platform console and must accept the invitation. +
+        # Members cannot be added to more than one role in the same policy. + There must
+        # be at least one owner who has accepted the Terms of Service (ToS) agreement in
+        # the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted owner
+        # from the policy will fail. + Calling this method requires enabling the App
+        # Engine Admin API. Note: Removing service accounts from policies or changing
+        # their roles can render services completely inoperable. It is important to
+        # understand how the service account is being used before removing or updating
+        # its roles.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being specified. `resource` is
+        #   usually specified as a path, such as `projects/*project*/zones/*zone*/disks/*
+        #   disk*`. The format for the path specified in this value is resource specific
+        #   and is specified in the `setIamPolicy` documentation.
+        # @param [Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest] set_iam_policy_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def set_project_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects/{resource}:setIamPolicy', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest::Representation
+          command.request_object = set_iam_policy_request_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Policy::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns permissions that a caller has on the specified Project.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy detail is being requested. `
+        #   resource` is usually specified as a path, such as `projects/*project*/zones/*
+        #   zone*/disks/*disk*`. The format for the path specified in this value is
+        #   resource specific and is specified in the `testIamPermissions` documentation.
+        # @param [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def test_project_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects/{resource}:testIamPermissions', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest::Representation
+          command.request_object = test_iam_permissions_request_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::TestIamPermissionsResponse::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::TestIamPermissionsResponse
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/cloudresourcemanager_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/resource-manager
     module CloudresourcemanagerV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20160224'
+      REVISION = '20160225'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/clouduseraccounts_beta.rb

@@ -20,12 +20,13 @@ module Google
   module Apis
     # Cloud User Accounts API
     #
-    # API for the Google Cloud User Accounts service.
+    # Creates and manages users and groups for accessing Google Compute Engine
+    # virtual machines.
     #
     # @see https://cloud.google.com/compute/docs/access/user-accounts/api/latest/
     module ClouduseraccountsBeta
       VERSION = 'Beta'
-      REVISION = '20150924'
+      REVISION = '20160301'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/clouduseraccounts_beta/classes.rb

@@ -348,8 +348,7 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # [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.
         # Corresponds to the JSON property `clientOperationId`
         # @return [String]
         attr_accessor :client_operation_id
@@ -359,8 +358,14 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # [Output Only] The time that this operation was completed. This is in RFC3339
-        # text format.
+        # [Output Only] A textual description of the operation, which is set when the
+        # operation is created.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # [Output Only] The time that this operation was completed. This value is in
+        # RFC3339 text format.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
@@ -378,23 +383,25 @@ module Google
         attr_accessor :http_error_message
       
         # [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.
         # Corresponds to the JSON property `httpErrorStatusCode`
         # @return [Fixnum]
         attr_accessor :http_error_status_code
       
-        # [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.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # [Output Only] The time that this operation was requested. This is in RFC3339
-        # text format.
+        # [Output Only] The time that this operation was requested. This value is in
+        # RFC3339 text format.
         # Corresponds to the JSON property `insertTime`
         # @return [String]
         attr_accessor :insert_time
       
-        # [Output Only] Type of the resource. Always compute#operation for Operation
+        # [Output Only] Type of the resource. Always compute#operation for operation
         # resources.
         # Corresponds to the JSON property `kind`
         # @return [String]
@@ -405,22 +412,22 @@ module Google
         # @return [String]
         attr_accessor :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.
         # Corresponds to the JSON property `operationType`
         # @return [String]
         attr_accessor :operation_type
       
         # [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 complete. This
+        # This should not be used to guess when the operation will be complete. This
         # number should monotonically increase as the operation progresses.
         # Corresponds to the JSON property `progress`
         # @return [Fixnum]
         attr_accessor :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.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -430,14 +437,14 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # [Output Only] The time that this operation was started by the server. This is
-        # in RFC3339 text format.
+        # [Output Only] The time that this operation was started by the server. This
+        # value is in RFC3339 text format.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # [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.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -448,13 +455,13 @@ module Google
         # @return [String]
         attr_accessor :status_message
       
-        # [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.
         # Corresponds to the JSON property `targetId`
         # @return [String]
         attr_accessor :target_id
       
-        # [Output Only] URL of the resource the operation is mutating.
+        # [Output Only] The URL of the resource that the operation modifies.
         # Corresponds to the JSON property `targetLink`
         # @return [String]
         attr_accessor :target_link
@@ -470,7 +477,8 @@ module Google
         # @return [Array<Google::Apis::ClouduseraccountsBeta::Operation::Warning>]
         attr_accessor :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.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -483,6 +491,7 @@ module Google
         def update!(**args)
           @client_operation_id = args[:client_operation_id] if args.key?(:client_operation_id)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
+          @description = args[:description] if args.key?(:description)
           @end_time = args[:end_time] if args.key?(:end_time)
           @error = args[:error] if args.key?(:error)
           @http_error_message = args[:http_error_message] if args.key?(:http_error_message)
@@ -533,7 +542,7 @@ module Google
             # @return [String]
             attr_accessor :code
           
-            # [Output Only] Indicates the field in the request which caused the error. This
+            # [Output Only] Indicates the field in the request that caused the error. This
             # property is optional.
             # Corresponds to the JSON property `location`
             # @return [String]
@@ -561,17 +570,19 @@ module Google
         class Warning
           include Google::Apis::Core::Hashable
         
-          # [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.
           # Corresponds to the JSON property `code`
           # @return [String]
           attr_accessor :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" `
           # Corresponds to the JSON property `data`
           # @return [Array<Google::Apis::ClouduseraccountsBeta::Operation::Warning::Datum>]
           attr_accessor :data
         
-          # [Output Only] Optional human-readable details for this warning.
+          # [Output Only] A human-readable description of the warning code.
           # Corresponds to the JSON property `message`
           # @return [String]
           attr_accessor :message
@@ -591,7 +602,13 @@ module Google
           class Datum
             include Google::Apis::Core::Hashable
           
-            # [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).
             # Corresponds to the JSON property `key`
             # @return [String]
             attr_accessor :key
@@ -618,12 +635,13 @@ module Google
       class OperationList
         include Google::Apis::Core::Hashable
       
-        # [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.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # [Output Only] The Operation resources.
+        # [Output Only] A list of Operation resources.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::ClouduseraccountsBeta::Operation>]
         attr_accessor :items
@@ -634,7 +652,11 @@ module Google
         # @return [String]
         attr_accessor :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.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token