google-apis-cloudresourcemanager_v3 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0660968bc9562d5cdae53529fb4ecbe3c99faeea59e891f007012ab1f071b5a2'
-  data.tar.gz: ee6f12ff029b6d2f56048588c2358e6385097e7ce48133a0d27cb0c73f93faaa
+  metadata.gz: e6388aadea374b5da741c1ffc6e777afe141de6a2dda2e725433e7f57dcff95a
+  data.tar.gz: f3d562fc117be6c0213cdaf696d3d42c9df33d686999264f2f9ea2ad46d178ba
 SHA512:
-  metadata.gz: 7cf01f16114d76de971a2f8158dd7725c1d0d5a796f2ca397c883a48cd39ef6963fb43c696ed807ead9132bc6b7ca71eedb8c706680d25b0ad8effbee2219a7c
-  data.tar.gz: fc7b4a96d3f48248500d18b6a093a3cbfe14e7fba4951399e09c7463c069402cb5b89c14b58755e9d581049c9e7b539d92bff96f93dc52ac1fe20fd63b62518a
+  metadata.gz: ad5ce9abafb39afe1ee3eb04f1e1335c122abbd2b2bba846351074e5448522d60bfa6d2ecd369fa2217fe07374dbe1a7a8c6f88ee00b84590666c07e01f9932e
+  data.tar.gz: fac4a0a9a893cb9602b86410625c3964ec5ca64af65b3ac5e3e88e96d76865cee9c7adb047dcbdc67c5bf4ac148de4eca81bc2ce68d4f2ffac9cd85cbc214d06

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-cloudresourcemanager_v3
 
+### v0.7.0 (2021-04-02)
+
+* Regenerated from discovery document revision 20210328
+
 ### v0.6.0 (2021-03-27)
 
 * Regenerated from discovery document revision 20210322

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
@@ -330,8 +330,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 +344,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 +359,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
       
@@ -469,57 +469,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 +705,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>]
@@ -873,7 +873,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
       
@@ -908,9 +908,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
@@ -1020,8 +1020,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
       
@@ -1040,10 +1040,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
@@ -1179,8 +1179,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
       
@@ -1194,7 +1194,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`
@@ -1209,7 +1209,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\]
@@ -1221,7 +1221,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]
@@ -1233,14 +1233,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
@@ -1700,8 +1700,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
       
@@ -1742,7 +1742,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.6.0"
+      GEM_VERSION = "0.7.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.2.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210322"
+      REVISION = "20210328"
     end
   end
 end

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,11 +1072,12 @@ 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
+        # 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.
         # @param [String] name
         #   Required. The name of the project to move.
@@ -1107,12 +1111,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 +1151,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 +1171,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 | Project's parent. (e.g. 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 (e.g.
-        #   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.
+        #   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 +1216,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 +1229,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 +1276,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 +1310,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.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-29 00:00:00.000000000 Z
+date: 2021-04-05 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.6.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-cloudresourcemanager_v3/v0.7.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-cloudresourcemanager_v3
 post_install_message: 
 rdoc_options: []