google-apis-cloudresourcemanager_v3 0.5.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84f11cb1a7ffb186c67d681ace4ec73786303173a05c62d9d442c66fc273989c
-  data.tar.gz: 62da0944ef623708a190b8b1e1f2660e285637d13641434b93319a8f173a9c18
+  metadata.gz: 0fabe62b3161b86f545fad3695e40d20d0612c5bc9964daf73ac5a391ee2b50a
+  data.tar.gz: 8e04ca979aeb5e4be06ce61baad700f4c3977865496f09cb3817f05e6bd45976
 SHA512:
-  metadata.gz: 013006c288eeaee943ca119a16413f8d6d689e3088560a3fbf3a5c1c42f9162a5aafb244dd31c695951c8d27c1b3f1f30e59391a882fbbb312a5b4ae525a15dd
-  data.tar.gz: 7a31d9fe3a7d84909d760a77ff68c7d8f599f0fff32a4e7b9371fd3c1fb4470c0634fb14389df0bbd5953be251054395a6e8462bc000e2df1ed4417f76b6a44e
+  metadata.gz: 74e9f2b47233dd7cbbfdc0d80e21101e7232d47cb5368627e68f0a6ee5e2e6419c0986e17c148455f035bcc2d2d3845de96307f501f7322cd688656d2ae62edb
+  data.tar.gz: 8f0f7683a86cd34400812ff924d568266fc42c8a3cdd305a2e24e5542a01d62908c71a66b4e129bf4c1bb9d1f64f9dd10a6a751aeab42d40f031cb9b13c6c2f8

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Release history for google-apis-cloudresourcemanager_v3
 
+### v0.10.0 (2021-06-03)
+
+* Regenerated from discovery document revision 20210601
+* Regenerated using generator version 0.3.0
+
+### v0.9.0 (2021-05-19)
+
+* Unspecified changes
+
+### v0.8.0 (2021-04-20)
+
+* Regenerated from discovery document revision 20210411
+
+### v0.7.0 (2021-04-02)
+
+* Regenerated from discovery document revision 20210328
+
+### v0.6.0 (2021-03-27)
+
+* Regenerated from discovery document revision 20210322
+
 ### v0.5.0 (2021-03-19)
 
 * Regenerated from discovery document revision 20210314

data/lib/google/apis/cloudresourcemanager_v3/classes.rb

@@ -279,8 +279,8 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # True if the project can be retrieved using GetProject. No other operations on
-        # the project are guaranteed to work until the project creation is complete.
+        # True if the project can be retrieved using `GetProject`. No other operations
+        # on the project are guaranteed to work until the project creation is complete.
         # Corresponds to the JSON property `gettable`
         # @return [Boolean]
         attr_accessor :gettable
@@ -304,6 +304,19 @@ module Google
         end
       end
       
+      # Runtime operation information for creating a TagValue.
+      class CreateTagBindingMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Runtime operation information for creating a TagKey.
       class CreateTagKeyMetadata
         include Google::Apis::Core::Hashable
@@ -330,8 +343,8 @@ module Google
         end
       end
       
-      # A status object which is used as the `metadata` field for the Operation
-      # returned by DeleteFolder.
+      # A status object which is used as the `metadata` field for the `Operation`
+      # returned by `DeleteFolder`.
       class DeleteFolderMetadata
         include Google::Apis::Core::Hashable
       
@@ -344,7 +357,7 @@ module Google
         end
       end
       
-      # A status object which is used as the `metadata` field for the Operation
+      # A status object which is used as the `metadata` field for the operation
       # returned by DeleteOrganization.
       class DeleteOrganizationMetadata
         include Google::Apis::Core::Hashable
@@ -359,7 +372,7 @@ module Google
       end
       
       # A status object which is used as the `metadata` field for the Operation
-      # returned by DeleteProject.
+      # returned by `DeleteProject`.
       class DeleteProjectMetadata
         include Google::Apis::Core::Hashable
       
@@ -372,6 +385,19 @@ module Google
         end
       end
       
+      # Runtime operation information for deleting a TagBinding.
+      class DeleteTagBindingMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Runtime operation information for deleting a TagKey.
       class DeleteTagKeyMetadata
         include Google::Apis::Core::Hashable
@@ -469,57 +495,57 @@ module Google
         end
       end
       
-      # A Folder in an Organization's resource hierarchy, used to organize that
-      # Organization's resources.
+      # A folder in an organization's resource hierarchy, used to organize that
+      # organization's resources.
       class Folder
         include Google::Apis::Core::Hashable
       
-        # Output only. Timestamp when the Folder was created.
+        # Output only. Timestamp when the folder was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # Output only. Timestamp when the Folder was requested to be deleted.
+        # Output only. Timestamp when the folder was requested to be deleted.
         # Corresponds to the JSON property `deleteTime`
         # @return [String]
         attr_accessor :delete_time
       
         # The folder's display name. A folder's display name must be unique amongst its
-        # siblings, e.g. no two folders with the same parent can share the same display
-        # name. The 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`])?`.
+        # siblings. For example, no two folders with the same parent can share the same
+        # display name. The 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`])?`.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
         # Output only. A checksum computed by the server based on the current value of
-        # the Folder resource. This may be sent on update and delete requests to ensure
+        # the folder resource. This may be sent on update and delete requests to ensure
         # the client has an up-to-date value before proceeding.
         # Corresponds to the JSON property `etag`
         # @return [String]
         attr_accessor :etag
       
-        # Output only. The resource name of the Folder. Its format is `folders/`
+        # Output only. The resource name of the folder. Its format is `folders/`
         # folder_id``, for example: "folders/1234".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Required. The Folder's parent's resource name. Updates to the folder's parent
-        # must be performed via MoveFolder.
+        # Required. The folder's parent's resource name. Updates to the folder's parent
+        # must be performed using MoveFolder.
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
       
         # Output only. The lifecycle state of the folder. Updates to the state must be
-        # performed via DeleteFolder and UndeleteFolder.
+        # performed using DeleteFolder and UndeleteFolder.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
       
-        # Output only. Timestamp when the Folder was last modified.
+        # Output only. Timestamp when the folder was last modified.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -705,7 +731,7 @@ module Google
       class ListFoldersResponse
         include Google::Apis::Core::Hashable
       
-        # A possibly paginated list of Folders that are direct descendants of the
+        # A possibly paginated list of folders that are direct descendants of the
         # specified parent resource.
         # Corresponds to the JSON property `folders`
         # @return [Array<Google::Apis::CloudresourcemanagerV3::Folder>]
@@ -792,14 +818,17 @@ module Google
       class ListTagBindingsResponse
         include Google::Apis::Core::Hashable
       
-        # A pagination token returned from a previous call to `ListTagBindings` that
-        # indicates from where listing should continue.
+        # Pagination token. If the result set is too large to fit in a single response,
+        # this token is returned. It encodes the position of the current result cursor.
+        # Feeding this value into a new list request with the `page_token` parameter
+        # gives the next page of the results. When `next_page_token` is not filled in,
+        # there is no next page and the list returned is the last page in the result set.
+        # Pagination tokens have a limited lifetime.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # A possibly paginated list of TagBindings for the specified TagValue or
-        # resource.
+        # A possibly paginated list of TagBindings for the specified resource.
         # Corresponds to the JSON property `tagBindings`
         # @return [Array<Google::Apis::CloudresourcemanagerV3::TagBinding>]
         attr_accessor :tag_bindings
@@ -869,7 +898,7 @@ module Google
         end
       end
       
-      # Metadata pertaining to the Folder move process.
+      # Metadata pertaining to the folder move process.
       class MoveFolderMetadata
         include Google::Apis::Core::Hashable
       
@@ -904,9 +933,9 @@ module Google
       class MoveFolderRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The resource name of the Folder or Organization to reparent the
-        # folder under. Must be of the form `folders/`folder_id`` or `organizations/`
-        # org_id``.
+        # Required. The resource name of the folder or organization which should be the
+        # folder's new parent. Must be of the form `folders/`folder_id`` or `
+        # organizations/`org_id``.
         # Corresponds to the JSON property `destinationParent`
         # @return [String]
         attr_accessor :destination_parent
@@ -1016,8 +1045,8 @@ module Google
         end
       end
       
-      # The root node in the resource hierarchy to which a particular entity's (e.g.,
-      # company) resources belong.
+      # The root node in the resource hierarchy to which a particular entity's (a
+      # company, for example) resources belong.
       class Organization
         include Google::Apis::Core::Hashable
       
@@ -1036,10 +1065,10 @@ module Google
         # @return [String]
         attr_accessor :directory_customer_id
       
-        # Output only. A human-readable string that refers to the Organization in the
-        # GCP Console UI. This string is set by the server and cannot be changed. The
-        # string will be set to the primary domain (for example, "google.com") of the G
-        # Suite customer that owns the organization.
+        # Output only. A human-readable string that refers to the organization in the
+        # Google Cloud Console. This string is set by the server and cannot be changed.
+        # The string will be set to the primary domain (for example, "google.com") of
+        # the Google Workspace customer that owns the organization.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -1175,8 +1204,8 @@ module Google
         end
       end
       
-      # A Project is a high-level Google Cloud Platform entity. It is a container for
-      # ACLs, APIs, App Engine Apps, VMs, and other Google Cloud Platform resources.
+      # A project is a high-level Google Cloud entity. It is a container for ACLs,
+      # APIs, App Engine Apps, VMs, and other Google Cloud Platform resources.
       class Project
         include Google::Apis::Core::Hashable
       
@@ -1190,7 +1219,7 @@ module Google
         # @return [String]
         attr_accessor :delete_time
       
-        # Optional. A user-assigned display name of the Project. When present it must be
+        # Optional. A user-assigned display name of the project. When present it must be
         # between 4 to 30 characters. Allowed characters are: lowercase and uppercase
         # letters, numbers, hyphen, single-quote, double-quote, space, and exclamation
         # point. Example: `My Project`
@@ -1205,7 +1234,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Optional. The labels associated with this Project. Label keys must be between
+        # Optional. The labels associated with this project. Label keys must be between
         # 1 and 63 characters long and must conform to the following regular expression:
         # \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63
         # characters long and must conform to the regular expression (\[a-z\](\[-a-z0-9\]
@@ -1217,7 +1246,7 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Output only. The unique resource name of the Project. It is an int64 generated
+        # Output only. The unique resource name of the project. It is an int64 generated
         # number prefixed by "projects/". Example: `projects/415104041262`
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -1229,14 +1258,14 @@ module Google
         # @return [String]
         attr_accessor :parent
       
-        # Immutable. The unique, user-assigned id of the Project. It must be 6 to 30
+        # Immutable. The unique, user-assigned id of the project. It must be 6 to 30
         # lowercase ASCII letters, digits, or hyphens. It must start with a letter.
         # Trailing hyphens are prohibited. Example: `tokyo-rain-123`
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
       
-        # Output only. The Project lifecycle state.
+        # Output only. The project lifecycle state.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -1696,8 +1725,8 @@ module Google
         end
       end
       
-      # A status object which is used as the `metadata` field for the Operation
-      # returned by UndeleteFolder.
+      # A status object which is used as the `metadata` field for the `Operation`
+      # returned by `UndeleteFolder`.
       class UndeleteFolderMetadata
         include Google::Apis::Core::Hashable
       
@@ -1738,7 +1767,7 @@ module Google
       end
       
       # A status object which is used as the `metadata` field for the Operation
-      # returned by UndeleteProject.
+      # returned by `UndeleteProject`.
       class UndeleteProjectMetadata
         include Google::Apis::Core::Hashable
       

data/lib/google/apis/cloudresourcemanager_v3/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module CloudresourcemanagerV3
       # Version of the google-apis-cloudresourcemanager_v3 gem
-      GEM_VERSION = "0.5.0"
+      GEM_VERSION = "0.10.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.2.0"
+      GENERATOR_VERSION = "0.3.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210314"
+      REVISION = "20210601"
     end
   end
 end

data/lib/google/apis/cloudresourcemanager_v3/representations.rb

@@ -64,6 +64,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CreateTagBindingMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CreateTagKeyMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -94,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DeleteTagBindingMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class DeleteTagKeyMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -422,6 +434,12 @@ module Google
         end
       end
       
+      class CreateTagBindingMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class CreateTagKeyMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -452,6 +470,12 @@ module Google
         end
       end
       
+      class DeleteTagBindingMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class DeleteTagKeyMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/cloudresourcemanager_v3/service.rb

@@ -50,23 +50,23 @@ 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 Folders that share its parent. + The addition of the Folder
-        # must not cause the active Folder hierarchy to exceed a height of 10. Note, the
-        # full active + deleted Folder hierarchy is allowed to reach a height of 20;
-        # 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 300. 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.
+        # 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 folders that share its parent. + The addition of the
+        # folder must not cause the active folder hierarchy to exceed a height of 10.
+        # Note, the full active + deleted folder hierarchy is allowed to reach a height
+        # of 20; 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 300. 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 in the details list in the `
+        # Operation.error` field. The caller must have `resourcemanager.folders.create`
+        # permission on the identified parent.
         # @param [Google::Apis::CloudresourcemanagerV3::Folder] folder_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -96,14 +96,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED
+        # 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, where a Folder is empty if it doesn't
-        # contain any Folders or Projects in the ACTIVE state. If called on a folder in
-        # DELETE_REQUESTED state the result will be a no-op success. The caller must
-        # have `resourcemanager.folders.delete` permission on the identified folder.
+        # only be called on an empty folder, where a folder is empty if it doesn't
+        # contain any folders or projects in the ACTIVE state. If called on a folder in
+        # DELETE_REQUESTED state the operation will result in a no-op success. 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 `
+        #   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.
@@ -132,12 +133,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a Folder identified by the supplied resource name. Valid Folder
+        # 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 `
+        #   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.
@@ -166,9 +167,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Folder. The returned policy may be empty
+        # 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 `
+        # folder's resource name, for example: "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
@@ -203,24 +204,24 @@ module Google
           execute_or_queue_command(command, &block)
         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 (
+        # 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.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of Folders to return in the response. If
+        #   Optional. The maximum number of folders to return in the response. If
         #   unspecified, server picks an appropriate default.
         # @param [String] page_token
         #   Optional. A pagination token returned from a previous call to `ListFolders`
         #   that indicates where this listing should continue from.
         # @param [String] parent
-        #   Required. The resource name of the Organization or Folder whose Folders are
+        #   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`.
         # @param [Boolean] show_deleted
-        #   Optional. Controls whether Folders in the DELETE_REQUESTED state should be
+        #   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.
@@ -252,18 +253,19 @@ 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 in the `Status.details` field. If it occurs asynchronously,
+        # then the FolderOperation will be returned in 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`
@@ -297,18 +299,18 @@ 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
+        # 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 the 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
         # between 3 and 30 characters. This is captured by the regular expression: `\p`L`
         # \p`N``1,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
+        # 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/`
+        #   Output only. The resource name of the folder. Its format is `folders/`
         #   folder_id``, for example: "folders/1234".
         # @param [Google::Apis::CloudresourcemanagerV3::Folder] folder_object
         # @param [String] update_mask
@@ -343,7 +345,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search for folders that match specific filter criteria. Search provides an
+        # 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`.
@@ -354,16 +356,16 @@ module Google
         #   Optional. A pagination token returned from a previous call to `SearchFolders`
         #   that indicates from where search should continue.
         # @param [String] query
-        #   Optional. Search criteria used to select the Folders to return. If no search
+        #   Optional. Search criteria used to select the folders to return. If no search
         #   criteria is specified then all accessible folders will be returned. Query
         #   expressions can be used to restrict results based upon displayName, state and
         #   parent, where the operators `=` (`:`) `NOT`, `AND` and `OR` can be used along
-        #   with the suffix wildcard symbol `*`. The displayName field in a query
+        #   with the suffix wildcard symbol `*`. The `displayName` field in a query
         #   expression should use escaped quotes for values that include whitespace to
         #   prevent unexpected behavior. | Field | Description | |-------------------------
         #   |----------------------------------------| | displayName | Filters by
-        #   displayName. | | parent | Filters by parent (e.g. folders/123). | | state,
-        #   lifecycleState | Filters by state. | Some example queries are: * Query `
+        #   displayName. | | parent | Filters by parent (for example: folders/123). | |
+        #   state, lifecycleState | Filters by state. | Some example queries are: * Query `
         #   displayName=Test*` returns Folder resources whose display name starts with "
         #   Test". * Query `state=ACTIVE` returns Folder resources with `state` set to `
         #   ACTIVE`. * Query `parent=folders/123` returns Folder resources that have `
@@ -400,10 +402,10 @@ 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, for example: "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.
@@ -437,9 +439,9 @@ 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, for example: "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.
@@ -473,15 +475,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Cancels the deletion request for a Folder. This method may be called on a
-        # Folder in any state. If Folder is in ACTIVE state the result will be a no-op
-        # success. 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
+        # Cancels the deletion request for a folder. This method may be called on a
+        # folder in any state. If the folder is in the ACTIVE state the result will be a
+        # no-op success. 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 `
+        #   Required. The resource name of the folder to undelete. Must be of the form `
         #   folders/`folder_id``.
         # @param [Google::Apis::CloudresourcemanagerV3::UndeleteFolderRequest] undelete_folder_request_object
         # @param [String] fields
@@ -683,7 +685,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Fetches an Organization resource identified by the specified resource name.
+        # Fetches an organization resource identified by the specified resource name.
         # @param [String] name
         #   Required. The resource name of the Organization to fetch. This is the
         #   organization's relative path in the API, formatted as "organizations/[
@@ -715,11 +717,11 @@ module Google
           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". Authorization requires
-        # the Google IAM permission `resourcemanager.organizations.getIamPolicy` on the
-        # specified organization
+        # Gets the access control policy for an organization resource. The policy may be
+        # empty if no such policy or resource exists. The `resource` field should be the
+        # organization's resource name, for example: "organizations/123". Authorization
+        # requires the IAM permission `resourcemanager.organizations.getIamPolicy` on
+        # the specified organization.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being requested. See the
         #   operation documentation for the appropriate value for this field.
@@ -753,13 +755,13 @@ module Google
           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, and may
+        # 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, and may
         # take a small amount of time to appear. Search will only return organizations
         # on which the user has the permission `resourcemanager.organizations.get`
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of Organizations to return in the response. If
+        #   Optional. The maximum number of organizations to return in the response. If
         #   unspecified, server picks an appropriate default.
         # @param [String] page_token
         #   Optional. A pagination token returned from a previous call to `
@@ -804,11 +806,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on an Organization resource. Replaces any
+        # 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". Authorization requires the Google IAM
+        # name, for example: "organizations/123". Authorization requires the IAM
         # permission `resourcemanager.organizations.setIamPolicy` on the specified
-        # organization
+        # organization.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being specified. See the
         #   operation documentation for the appropriate value for this field.
@@ -842,8 +844,8 @@ module Google
           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. "
+        # Returns the permissions that a caller has on the specified organization. The `
+        # resource` field should be the organization's resource name, for example: "
         # organizations/123". 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
@@ -878,10 +880,11 @@ 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. This process usually takes a few seconds,
-        # but can sometimes take much longer. The tracking Operation is automatically
-        # deleted after a few hours, so there is no need to call DeleteOperation.
+        # Request that a new project be created. The result is an `Operation` which can
+        # be used to track the creation process. This process usually takes a few
+        # seconds, but can sometimes take much longer. The tracking `Operation` is
+        # automatically deleted after a few hours, so there is no need to call `
+        # DeleteOperation`.
         # @param [Google::Apis::CloudresourcemanagerV3::Project] project_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -911,18 +914,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Marks the Project identified by the specified `name` (for example, `projects/
-        # 415104041262`) for deletion. This method will only affect the Project if it
+        # Marks the project identified by the specified `name` (for example, `projects/
+        # 415104041262`) for deletion. This method will only affect the project if it
         # 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 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
+        # 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, ListProjects, and SearchProjects methods. This
-        # method behaves idempotently (eg., deleting a `DELETE_REQUESTED` project will
-        # not be an error, but also won't do anything). The caller must have delete
-        # permissions for this Project.
+        # method behaves idempotently, such that deleting a `DELETE_REQUESTED` project
+        # will not cause an error, but also won't do anything. The caller must have `
+        # resourcemanager.projects.delete` permissions for this project.
         # @param [String] name
         #   Required. The name of the Project (for example, `projects/415104041262`).
         # @param [String] fields
@@ -952,9 +955,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the Project identified by the specified `name` (for example, `
-        # projects/415104041262`). The caller must have read permissions for this
-        # Project.
+        # Retrieves the project identified by the specified `name` (for example, `
+        # projects/415104041262`). The caller must have `resourcemanager.projects.get`
+        # permission for this project.
         # @param [String] name
         #   Required. The name of the project (for example, `projects/415104041262`).
         # @param [String] fields
@@ -984,8 +987,8 @@ module Google
           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.
+        # Returns the IAM access control policy for the specified project. Permission is
+        # denied if the policy or the resource do not exist.
         # @param [String] resource
         #   REQUIRED: The resource for which the policy is being requested. See the
         #   operation documentation for the appropriate value for this field.
@@ -1019,15 +1022,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists Projects that are direct children of the specified folder or
-        # organization resource. List provides a strongly consistent view of the
-        # Projects underneath the specified parent resource. List returns Projects
+        # Lists projects that are direct children of the specified folder or
+        # organization resource. `list()` provides a strongly consistent view of the
+        # projects underneath the specified parent resource. `list()` returns projects
         # sorted based upon the (ascending) lexical ordering of their `display_name`.
         # The caller must have `resourcemanager.projects.list` permission on the
         # identified parent.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of Projects to return in the response. The server
-        #   can return fewer Projects than requested. If unspecified, server picks an
+        #   Optional. 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.
         # @param [String] page_token
         #   Optional. A pagination token returned from a previous call to ListProjects
@@ -1037,7 +1040,7 @@ module Google
         #   setting this field to 'folders/1234' would list all projects directly under
         #   that folder.
         # @param [Boolean] show_deleted
-        #   Optional. Indicate that Projects in the `DELETE_REQUESTED` state should also
+        #   Optional. Indicate that projects in the `DELETE_REQUESTED` state should also
         #   be returned. Normally only `ACTIVE` projects are returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1069,12 +1072,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Move a Project under a new resource parent. Returns an operation which can be
-        # used to track the process of the Project move workflow. Upon success, the
-        # Operation.response field will be populated with the moved Project. The caller
-        # must have `resourcemanager.projects.update` permission on the Project and have
-        # `resourcemanager.projects.move` permission on the Project's current and
-        # proposed new parent.
+        # Move a project to another place in your resource hierarchy, under a new
+        # resource parent. Returns an operation which can be used to track the process
+        # of the project move workflow. Upon success, the `Operation.response` field
+        # will be populated with the moved project. The caller must have `
+        # resourcemanager.projects.update` permission on the project and have `
+        # resourcemanager.projects.move` permission on the project's current and
+        # proposed new parent. If project has no current parent, or it currently does
+        # not have an associated organization resource, you will also need the `
+        # resourcemanager.projects.setIamPolicy` permission in the project.
         # @param [String] name
         #   Required. The name of the project to move.
         # @param [Google::Apis::CloudresourcemanagerV3::MoveProjectRequest] move_project_request_object
@@ -1107,12 +1113,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the attributes of the Project identified by the specified `name` (for
-        # example, `projects/415104041262`). At present this is only useful for updating
-        # the display_name and labels. Deleting all labels requires an update mask for
-        # labels field. The caller must have modify permissions for this Project.
+        # Updates the `display_name` and labels of the project identified by the
+        # specified `name` (for example, `projects/415104041262`). Deleting all labels
+        # requires an update mask for labels field. The caller must have `
+        # resourcemanager.projects.update` permission for this project.
         # @param [String] name
-        #   Output only. The unique resource name of the Project. It is an int64 generated
+        #   Output only. The unique resource name of the project. It is an int64 generated
         #   number prefixed by "projects/". Example: `projects/415104041262`
         # @param [Google::Apis::CloudresourcemanagerV3::Project] project_object
         # @param [String] update_mask
@@ -1147,15 +1153,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Search for Projects that the caller has the `resourcemanager.projects.get`
-        # permission on and satisfy the specified query. This method returns Projects in
-        # an unspecified order. This method is eventually consistent with project
-        # mutations; this means that a newly created project may not appear in the
-        # results or recent updates to an existing project may not be reflected in the
-        # results. To retrieve the latest state of a project, use the GetProject method.
+        # Search for projects that the caller has both `resourcemanager.projects.get`
+        # permission on, and also satisfy the specified query. This method returns
+        # projects in an unspecified order. This method is eventually consistent with
+        # project mutations; this means that a newly created project may not appear in
+        # the results or recent updates to an existing project may not be reflected in
+        # the results. To retrieve the latest state of a project, use the GetProject
+        # method.
         # @param [Fixnum] page_size
-        #   Optional. The maximum number of Projects to return in the response. The server
-        #   can return fewer Projects than requested. If unspecified, server picks an
+        #   Optional. 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.
         # @param [String] page_token
         #   Optional. A pagination token returned from a previous call to ListProjects
@@ -1166,22 +1173,22 @@ module Google
         #   in the query, the it will return results that match any of the fields. Some
         #   eligible fields are: | Field | Description | |-------------------------|-------
         #   ---------------------------------------| | displayName, name | Filters by
-        #   displayName. | | parent.type | Parent's type: `folder` or `organization`. | |
-        #   parent.id | Parent's id number (e.g. 123) | | parent | Project's parent. (e.g.
-        #   folders/123, organizations/*) Prefer parent field over parent.id and parent.
-        #   type. | | id, projectId | Filters by projectId. | | state, lifecycleState |
-        #   Filters by state. | | labels | Filters by label name or value. | | labels. (
-        #   where *key* is the name of a label) | Filters by label name. | Search
-        #   expressions are case insensitive. Some examples queries: | Query | Description
-        #   | |------------------|-----------------------------------------------------| |
-        #   name:how* | The project's name starts with "how". | | 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 labels.size:big | The project's label `color` has the value `
-        #   red` and its label `size` has the value `big`. | If no query is specified, the
-        #   call will return projects for which the user has the `resourcemanager.projects.
-        #   get` permission.
+        #   displayName. | | parent | Project's parent (for example: folders/123,
+        #   organizations/*). Prefer parent field over parent.type and parent.id.| |
+        #   parent.type | Parent's type: `folder` or `organization`. | | parent.id |
+        #   Parent's id number (for example: 123) | | id, projectId | Filters by projectId.
+        #   | | state, lifecycleState | Filters by state. | | labels | Filters by label
+        #   name or value. | | labels.\ (where *key* is the name of a label) | Filters by
+        #   label name.| Search expressions are case insensitive. Some examples queries: |
+        #   Query | Description | |------------------|-------------------------------------
+        #   ----------------| | name:how* | The project's name starts with "how". | | 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 labels.size:big | The project's label `
+        #   color` has the value `red` and its label `size` has the value `big`.| If no
+        #   query is specified, the call will return projects for which the user has the `
+        #   resourcemanager.projects.get` permission.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1211,9 +1218,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the IAM access control policy for the specified Project. CAUTION: This
+        # Sets the IAM access control policy for the specified project. CAUTION: This
         # method will replace the existing policy, and cannot be used to append
-        # additional IAM settings. NOTE: Removing service accounts from policies or
+        # additional IAM settings. 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. The following constraints apply when using `
@@ -1224,11 +1231,11 @@ module Google
         # an owner to a project in the myownpersonaldomain.com organization, but not the
         # examplepetstore.com organization. + 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
+        # user must be invited using the 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. + If
         # the project is not part of an organization, there must be at least one owner
@@ -1271,7 +1278,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified Project.
+        # Returns permissions that a caller has on the specified project.
         # @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.
@@ -1305,12 +1312,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Restores the Project identified by the specified `name` (for example, `
-        # projects/415104041262`). You can only use this method for a Project that has a
-        # lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot
-        # be restored. The caller must have undelete permissions for this Project.
+        # Restores the project identified by the specified `name` (for example, `
+        # projects/415104041262`). You can only use this method for a project that has a
+        # lifecycle state of DELETE_REQUESTED. After deletion starts, the project cannot
+        # be restored. The caller must have `resourcemanager.projects.undelete`
+        # permission for this project.
         # @param [String] name
-        #   Required. The name of the Project (for example, `projects/415104041262`).
+        #   Required. The name of the project (for example, `projects/415104041262`).
         #   Required.
         # @param [Google::Apis::CloudresourcemanagerV3::UndeleteProjectRequest] undelete_project_request_object
         # @param [String] fields

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-cloudresourcemanager_v3
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-22 00:00:00.000000000 Z
+date: 2021-06-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-cloudresourcemanager_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.5.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.10.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-cloudresourcemanager_v3
 post_install_message: 
 rdoc_options: []
@@ -69,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Resource Manager API V3