google-api-client 0.9.8 → 0.9.20

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

@@ -22,37 +22,43 @@ module Google
   module Apis
     module CloudresourcemanagerV1
       
-      class Project
+      class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class ResourceId
+      class Status
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class ListProjectsResponse
+      class SearchOrganizationsRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Empty
+      class SearchOrganizationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class UndeleteProjectRequest
+      class Organization
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class GetIamPolicyRequest
+      class OrganizationOwner
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class SetIamPolicyRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
@@ -70,7 +76,7 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class SetIamPolicyRequest
+      class GetIamPolicyRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
@@ -89,51 +95,116 @@ module Google
       end
       
       class Project
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ResourceId
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListProjectsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Empty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UndeleteProjectRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ProjectCreationStatus
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FolderOperation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class FolderOperationError
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :project_number, as: 'projectNumber'
-          property :project_id, as: 'projectId'
-          property :lifecycle_state, as: 'lifecycleState'
           property :name, as: 'name'
-          property :create_time, as: 'createTime'
-          hash :labels, as: 'labels'
-          property :parent, as: 'parent', class: Google::Apis::CloudresourcemanagerV1::ResourceId, decorator: Google::Apis::CloudresourcemanagerV1::ResourceId::Representation
+          hash :metadata, as: 'metadata'
+          property :done, as: 'done'
+          property :error, as: 'error', class: Google::Apis::CloudresourcemanagerV1::Status, decorator: Google::Apis::CloudresourcemanagerV1::Status::Representation
       
+          hash :response, as: 'response'
         end
       end
       
-      class ResourceId
+      class Status
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :type, as: 'type'
-          property :id, as: 'id'
+          property :code, as: 'code'
+          property :message, as: 'message'
+          collection :details, as: 'details'
         end
       end
       
-      class ListProjectsResponse
+      class SearchOrganizationsRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :projects, as: 'projects', class: Google::Apis::CloudresourcemanagerV1::Project, decorator: Google::Apis::CloudresourcemanagerV1::Project::Representation
+          property :page_size, as: 'pageSize'
+          property :page_token, as: 'pageToken'
+          property :filter, as: 'filter'
+        end
+      end
+      
+      class SearchOrganizationsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :organizations, as: 'organizations', class: Google::Apis::CloudresourcemanagerV1::Organization, decorator: Google::Apis::CloudresourcemanagerV1::Organization::Representation
       
           property :next_page_token, as: 'nextPageToken'
         end
       end
       
-      class Empty
+      class Organization
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+          property :display_name, as: 'displayName'
+          property :owner, as: 'owner', class: Google::Apis::CloudresourcemanagerV1::OrganizationOwner, decorator: Google::Apis::CloudresourcemanagerV1::OrganizationOwner::Representation
+      
+          property :creation_time, as: 'creationTime'
+          property :lifecycle_state, as: 'lifecycleState'
         end
       end
       
-      class UndeleteProjectRequest
+      class OrganizationOwner
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :directory_customer_id, as: 'directoryCustomerId'
         end
       end
       
-      class GetIamPolicyRequest
+      class SetIamPolicyRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :policy, as: 'policy', class: Google::Apis::CloudresourcemanagerV1::Policy, decorator: Google::Apis::CloudresourcemanagerV1::Policy::Representation
+      
         end
       end
       
@@ -155,11 +226,9 @@ module Google
         end
       end
       
-      class SetIamPolicyRequest
+      class GetIamPolicyRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :policy, as: 'policy', class: Google::Apis::CloudresourcemanagerV1::Policy, decorator: Google::Apis::CloudresourcemanagerV1::Policy::Representation
-      
         end
       end
       
@@ -176,6 +245,75 @@ module Google
           collection :permissions, as: 'permissions'
         end
       end
+      
+      class Project
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :project_number, as: 'projectNumber'
+          property :project_id, as: 'projectId'
+          property :lifecycle_state, as: 'lifecycleState'
+          property :name, as: 'name'
+          property :create_time, as: 'createTime'
+          hash :labels, as: 'labels'
+          property :parent, as: 'parent', class: Google::Apis::CloudresourcemanagerV1::ResourceId, decorator: Google::Apis::CloudresourcemanagerV1::ResourceId::Representation
+      
+        end
+      end
+      
+      class ResourceId
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :type, as: 'type'
+          property :id, as: 'id'
+        end
+      end
+      
+      class ListProjectsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :projects, as: 'projects', class: Google::Apis::CloudresourcemanagerV1::Project, decorator: Google::Apis::CloudresourcemanagerV1::Project::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Empty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class UndeleteProjectRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class ProjectCreationStatus
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :gettable, as: 'gettable'
+          property :ready, as: 'ready'
+        end
+      end
+      
+      class FolderOperation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :display_name, as: 'displayName'
+          property :operation_type, as: 'operationType'
+          property :source_parent, as: 'sourceParent'
+          property :destination_parent, as: 'destinationParent'
+        end
+      end
+      
+      class FolderOperationError
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :error_message_id, as: 'errorMessageId'
+        end
+      end
     end
   end
 end

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

@@ -47,6 +47,210 @@ module Google
           super('https://cloudresourcemanager.googleapis.com/', '')
         end
         
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @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::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Operation]
+        #
+        # @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_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Operation::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Searches Organization resources that are visible to the user and satisfy the
+        # specified filter. This method returns Organizations in an unspecified order.
+        # New Organizations do not necessarily appear at the end of the results.
+        # @param [Google::Apis::CloudresourcemanagerV1::SearchOrganizationsRequest] search_organizations_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::SearchOrganizationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::SearchOrganizationsResponse]
+        #
+        # @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 search_organizations(search_organizations_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/organizations:search', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::SearchOrganizationsRequest::Representation
+          command.request_object = search_organizations_request_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::SearchOrganizationsResponse::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::SearchOrganizationsResponse
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Fetches an Organization resource identified by the specified resource name.
+        # @param [String] name
+        #   The resource name of the Organization to fetch, e.g. "organizations/1234".
+        # @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::Organization] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Organization]
+        #
+        # @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_organization(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Organization::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Organization
+          command.params['name'] = name unless name.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 access control policy on an Organization resource. Replaces any
+        # existing policy. The `resource` field should be the organization's resource
+        # name, e.g. "organizations/123".
+        # @param [String] 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``.
+        # @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_organization_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+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
+        
+        # Gets the access control policy for an Organization resource. May be empty if
+        # no such policy or resource exists. The `resource` field should be the
+        # organization's resource name, e.g. "organizations/123".
+        # @param [String] 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``.
+        # @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_organization_iam_policy(resource, get_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+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
+        
+        # Returns permissions that a caller has on the specified Organization. The `
+        # resource` field should be the organization's resource name, e.g. "
+        # organizations/123".
+        # @param [String] 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``.
+        # @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_organization_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+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
+        
         # 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
@@ -127,6 +331,42 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Request that a new Project be created. The result is an Operation which can be
+        # used to track the creation process. It is automatically deleted after a few
+        # hours, so there is no need to call DeleteOperation. Our SLO permits Project
+        # creation to take up to 30 seconds at the 90th percentile. As of 2016-08-29, we
+        # are observing 6 seconds 50th percentile latency. 95th percentile latency is
+        # around 11 seconds. We recommend polling at the 5th second with an exponential
+        # backoff.
+        # @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::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::CloudresourcemanagerV1::Operation]
+        #
+        # @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 create_project(project_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/projects', options)
+          command.request_representation = Google::Apis::CloudresourcemanagerV1::Project::Representation
+          command.request_object = project_object
+          command.response_representation = Google::Apis::CloudresourcemanagerV1::Operation::Representation
+          command.response_class = Google::Apis::CloudresourcemanagerV1::Operation
+          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.
@@ -167,13 +407,12 @@ module Google
         # 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.
+        # deletion starts at an unspecified time, at which point the Project is no
+        # longer accessible. 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
@@ -205,9 +444,8 @@ module Google
         
         # 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.
+        # lifecycle state of DELETE_REQUESTED. After deletion starts, 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
@@ -244,9 +482,8 @@ module Google
         # 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.
+        #   usually specified as a path. For example, a Project resource is specified as `
+        #   projects/`project``.
         # @param [Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -279,22 +516,30 @@ module Google
         
         # 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.
+        # Project does not support `allUsers` and `allAuthenticatedUsers` as `members`
+        # in a `Binding` of a `Policy`. + The owner role can be granted only to `user`
+        # and `serviceAccount`. + Service accounts can be made owners of a project
+        # directly without any restrictions. However, to be added as an owner, a user
+        # must be invited via Cloud Platform console and must accept the invitation. + A
+        # user cannot be granted the owner role using `setIamPolicy()`. The user must be
+        # granted the owner role using the Cloud Platform Console and must explicitly
+        # accept the invitation. + Invitations to grant the owner role cannot be sent
+        # using `setIamPolicy()`; they must be sent only using the Cloud Platform
+        # Console. + Membership changes that leave the project without any owners that
+        # have accepted the Terms of Service (ToS) will be rejected. + 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. This restriction also applies to legacy projects that no
+        # longer have owners who have accepted the ToS. Edits to IAM policies will be
+        # rejected until the lack of a ToS-accepting owner is rectified. + 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.
+        #   usually specified as a path. For example, a Project resource is specified as `
+        #   projects/`project``.
         # @param [Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -328,9 +573,8 @@ module Google
         # 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.
+        #   resource` is usually specified as a path. For example, a Project resource is
+        #   specified as `projects/`project``.
         # @param [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.