google-api-client 0.42.0 → 0.43.0

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

@@ -48,33 +48,27 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a Folder in the resource hierarchy.
-        # Returns an Operation which can be used to track the progress of the
-        # folder creation workflow.
-        # Upon success the Operation.response field will be populated with the
-        # created Folder.
-        # In order to succeed, the addition of this new Folder must not violate
-        # the Folder naming, height or fanout constraints.
-        # + The Folder's display_name must be distinct from all other Folder's that
-        # share its parent.
-        # + The addition of the Folder must not cause the active Folder hierarchy
-        # to exceed a height of 4. Note, the full active + deleted Folder hierarchy
-        # is allowed to reach a height of 8; this provides additional headroom when
-        # moving folders that contain deleted folders.
-        # + The addition of the Folder must not cause the total number of Folders
-        # under its parent to exceed 100.
-        # If the operation fails due to a folder constraint violation, some errors
-        # may be returned by the CreateFolder request, with status code
-        # FAILED_PRECONDITION and an error description. Other folder constraint
-        # violations will be communicated in the Operation, with the specific
-        # PreconditionFailure returned via the details list in the Operation.error
-        # field.
+        # Creates a Folder in the resource hierarchy. Returns an Operation which can be
+        # used to track the progress of the folder creation workflow. Upon success the
+        # Operation.response field will be populated with the created Folder. In order
+        # to succeed, the addition of this new Folder must not violate the Folder naming,
+        # height or fanout constraints. + The Folder's display_name must be distinct
+        # from all other Folder's that share its parent. + The addition of the Folder
+        # must not cause the active Folder hierarchy to exceed a height of 4. Note, the
+        # full active + deleted Folder hierarchy is allowed to reach a height of 8; this
+        # provides additional headroom when moving folders that contain deleted folders.
+        # + The addition of the Folder must not cause the total number of Folders under
+        # its parent to exceed 100. If the operation fails due to a folder constraint
+        # violation, some errors may be returned by the CreateFolder request, with
+        # status code FAILED_PRECONDITION and an error description. Other folder
+        # constraint violations will be communicated in the Operation, with the specific
+        # PreconditionFailure returned via the details list in the Operation.error field.
         # The caller must have `resourcemanager.folders.create` permission on the
         # identified parent.
         # @param [Google::Apis::CloudresourcemanagerV2::Folder] folder_object
         # @param [String] parent
-        #   Required. The resource name of the new Folder's parent.
-        #   Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
+        #   Required. The resource name of the new Folder's parent. Must be of the form `
+        #   folders/`folder_id`` or `organizations/`org_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -104,18 +98,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests deletion of a Folder. The Folder is moved into the
-        # DELETE_REQUESTED state
-        # immediately, and is deleted approximately 30 days later. This method may
-        # only be called on an empty Folder in the
-        # ACTIVE state, where a Folder is empty if
-        # it doesn't contain any Folders or Projects in the
-        # ACTIVE state.
-        # The caller must have `resourcemanager.folders.delete` permission on the
-        # identified folder.
+        # Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED
+        # state immediately, and is deleted approximately 30 days later. This method may
+        # only be called on an empty Folder in the ACTIVE state, where a Folder is empty
+        # if it doesn't contain any Folders or Projects in the ACTIVE state. The caller
+        # must have `resourcemanager.folders.delete` permission on the identified folder.
         # @param [String] name
-        #   Required. the resource name of the Folder to be deleted.
-        #   Must be of the form `folders/`folder_id``.
+        #   Required. the resource name of the Folder to be deleted. Must be of the form `
+        #   folders/`folder_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -143,14 +133,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a Folder identified by the supplied resource name.
-        # Valid Folder resource names have the format `folders/`folder_id``
-        # (for example, `folders/1234`).
-        # The caller must have `resourcemanager.folders.get` permission on the
+        # Retrieves a Folder identified by the supplied resource name. Valid Folder
+        # resource names have the format `folders/`folder_id`` (for example, `folders/
+        # 1234`). The caller must have `resourcemanager.folders.get` permission on the
         # identified folder.
         # @param [String] name
-        #   Required. The resource name of the Folder to retrieve.
-        #   Must be of the form `folders/`folder_id``.
+        #   Required. The resource name of the Folder to retrieve. Must be of the form `
+        #   folders/`folder_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -178,14 +167,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Folder. The returned policy may be
-        # empty if no such policy or resource exists. The `resource` field should
-        # be the Folder's resource name, e.g. "folders/1234".
-        # The caller must have `resourcemanager.folders.getIamPolicy` permission
-        # on the identified folder.
+        # Gets the access control policy for a Folder. The returned policy may be empty
+        # if no such policy or resource exists. The `resource` field should be the
+        # Folder's resource name, e.g. "folders/1234". The caller must have `
+        # resourcemanager.folders.getIamPolicy` permission on the identified folder.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV2::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -217,12 +205,10 @@ module Google
         end
         
         # Lists the Folders that are direct descendants of supplied parent resource.
-        # List provides a strongly consistent view of the Folders underneath
-        # the specified parent resource.
-        # List returns Folders sorted based upon the (ascending) lexical ordering
-        # of their display_name.
-        # The caller must have `resourcemanager.folders.list` permission on the
-        # identified parent.
+        # List provides a strongly consistent view of the Folders underneath the
+        # specified parent resource. List returns Folders sorted based upon the (
+        # ascending) lexical ordering of their display_name. The caller must have `
+        # resourcemanager.folders.list` permission on the identified parent.
         # @param [Fixnum] page_size
         #   Optional. The maximum number of Folders to return in the response.
         # @param [String] page_token
@@ -230,14 +216,12 @@ module Google
         #   that indicates where this listing should continue from.
         # @param [String] parent
         #   Required. The resource name of the Organization or Folder whose Folders are
-        #   being listed.
-        #   Must be of the form `folders/`folder_id`` or `organizations/`org_id``.
-        #   Access to this method is controlled by checking the
-        #   `resourcemanager.folders.list` permission on the `parent`.
+        #   being listed. Must be of the form `folders/`folder_id`` or `organizations/`
+        #   org_id``. Access to this method is controlled by checking the `resourcemanager.
+        #   folders.list` permission on the `parent`.
         # @param [Boolean] show_deleted
-        #   Optional. Controls whether Folders in the
-        #   DELETE_REQUESTED
-        #   state should be returned. Defaults to false.
+        #   Optional. Controls whether Folders in the DELETE_REQUESTED state should be
+        #   returned. Defaults to false.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -268,26 +252,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Moves a Folder under a new resource parent.
-        # Returns an Operation which can be used to track the progress of the
-        # folder move workflow.
-        # Upon success the Operation.response field will be populated with the
-        # moved Folder.
-        # Upon failure, a FolderOperationError categorizing the failure cause will
-        # be returned - if the failure occurs synchronously then the
-        # FolderOperationError will be returned via the Status.details field
-        # and if it occurs asynchronously then the FolderOperation will be returned
-        # via the Operation.error field.
-        # In addition, the Operation.metadata field will be populated with a
-        # FolderOperation message as an aid to stateless clients.
-        # Folder moves will be rejected if they violate either the naming, height
-        # or fanout constraints described in the
-        # CreateFolder documentation.
-        # The caller must have `resourcemanager.folders.move` permission on the
-        # folder's current and proposed new parent.
+        # Moves a Folder under a new resource parent. Returns an Operation which can be
+        # used to track the progress of the folder move workflow. Upon success the
+        # Operation.response field will be populated with the moved Folder. Upon failure,
+        # a FolderOperationError categorizing the failure cause will be returned - if
+        # the failure occurs synchronously then the FolderOperationError will be
+        # returned via the Status.details field and if it occurs asynchronously then the
+        # FolderOperation will be returned via the Operation.error field. In addition,
+        # the Operation.metadata field will be populated with a FolderOperation message
+        # as an aid to stateless clients. Folder moves will be rejected if they violate
+        # either the naming, height or fanout constraints described in the CreateFolder
+        # documentation. The caller must have `resourcemanager.folders.move` permission
+        # on the folder's current and proposed new parent.
         # @param [String] name
-        #   Required. The resource name of the Folder to move.
-        #   Must be of the form folders/`folder_id`
+        #   Required. The resource name of the Folder to move. Must be of the form folders/
+        #   `folder_id`
         # @param [Google::Apis::CloudresourcemanagerV2::MoveFolderRequest] move_folder_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -318,26 +297,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a Folder, changing its display_name.
-        # Changes to the folder display_name will be rejected if they violate either
-        # the display_name formatting rules or naming constraints described in
-        # the CreateFolder documentation.
-        # The Folder's display name must start and end with a letter or digit,
-        # may contain letters, digits, spaces, hyphens and underscores and can be
-        # no longer than 30 characters. This is captured by the regular expression:
-        # [\p`L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?.
-        # The caller must have `resourcemanager.folders.update` permission on the
-        # identified folder.
-        # If the update fails due to the unique name constraint then a
-        # PreconditionFailure explaining this violation will be returned
-        # in the Status.details field.
+        # Updates a Folder, changing its display_name. Changes to the folder
+        # display_name will be rejected if they violate either the display_name
+        # formatting rules or naming constraints described in the CreateFolder
+        # documentation. The Folder's display name must start and end with a letter or
+        # digit, may contain letters, digits, spaces, hyphens and underscores and can be
+        # no longer than 30 characters. This is captured by the regular expression: [\p`
+        # L`\p`N`]([\p`L`\p`N`_- ]`0,28`[\p`L`\p`N`])?. The caller must have `
+        # resourcemanager.folders.update` permission on the identified folder. If the
+        # update fails due to the unique name constraint then a PreconditionFailure
+        # explaining this violation will be returned in the Status.details field.
         # @param [String] name
-        #   Output only. The resource name of the Folder.
-        #   Its format is `folders/`folder_id``, for example: "folders/1234".
+        #   Output only. The resource name of the Folder. Its format is `folders/`
+        #   folder_id``, for example: "folders/1234".
         # @param [Google::Apis::CloudresourcemanagerV2::Folder] folder_object
         # @param [String] update_mask
-        #   Required. Fields to be updated.
-        #   Only the `display_name` can be updated.
+        #   Required. Fields to be updated. Only the `display_name` can be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -368,11 +343,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search for folders that match specific filter criteria.
-        # Search provides an eventually consistent view of the folders a user has
-        # access to which meet the specified filter criteria.
-        # This will only return folders on which the caller has the
-        # permission `resourcemanager.folders.get`.
+        # Search for folders that match specific filter criteria. Search provides an
+        # eventually consistent view of the folders a user has access to which meet the
+        # specified filter criteria. This will only return folders on which the caller
+        # has the permission `resourcemanager.folders.get`.
         # @param [Google::Apis::CloudresourcemanagerV2::SearchFoldersRequest] search_folders_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -402,14 +376,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on a Folder, replacing any existing policy.
-        # The `resource` field should be the Folder's resource name, e.g.
-        # "folders/1234".
-        # The caller must have `resourcemanager.folders.setIamPolicy` permission
-        # on the identified folder.
+        # Sets the access control policy on a Folder, replacing any existing policy. The
+        # `resource` field should be the Folder's resource name, e.g. "folders/1234".
+        # The caller must have `resourcemanager.folders.setIamPolicy` permission on the
+        # identified folder.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV2::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -440,13 +413,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified Folder.
-        # The `resource` field should be the Folder's resource name,
-        # e.g. "folders/1234".
-        # There are no permissions required for making this API call.
+        # Returns permissions that a caller has on the specified Folder. The `resource`
+        # field should be the Folder's resource name, e.g. "folders/1234". There are no
+        # permissions required for making this API call.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV2::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -477,19 +449,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Cancels the deletion request for a Folder. This method may only be
-        # called on a Folder in the
-        # DELETE_REQUESTED state.
-        # In order to succeed, the Folder's parent must be in the
-        # ACTIVE state.
-        # In addition, reintroducing the folder into the tree must not violate
-        # folder naming, height and fanout constraints described in the
-        # CreateFolder documentation.
-        # The caller must have `resourcemanager.folders.undelete` permission on the
-        # identified folder.
+        # Cancels the deletion request for a Folder. This method may only be called on a
+        # Folder in the DELETE_REQUESTED state. In order to succeed, the Folder's parent
+        # must be in the ACTIVE state. In addition, reintroducing the folder into the
+        # tree must not violate folder naming, height and fanout constraints described
+        # in the CreateFolder documentation. The caller must have `resourcemanager.
+        # folders.undelete` permission on the identified folder.
         # @param [String] name
-        #   Required. The resource name of the Folder to undelete.
-        #   Must be of the form `folders/`folder_id``.
+        #   Required. The resource name of the Folder to undelete. Must be of the form `
+        #   folders/`folder_id``.
         # @param [Google::Apis::CloudresourcemanagerV2::UndeleteFolderRequest] undelete_folder_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -520,9 +488,8 @@ module Google
           execute_or_queue_command(command, &block)
         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.
+        # 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

data/generated/google/apis/cloudresourcemanager_v2.rb

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