google-api-client 0.41.0 → 0.42.2

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

@@ -81,11 +81,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the effective `Policy` on a resource. This is the result of merging
-        # `Policies` in the resource hierarchy. The returned `Policy` will not have
-        # an `etag`set because it is a computed `Policy` across multiple resources.
-        # Subtrees of Resource Manager resource hierarchy with 'under:' prefix will
-        # not be expanded.
+        # Gets the effective `Policy` on a resource. This is the result of merging `
+        # Policies` in the resource hierarchy. The returned `Policy` will not have an `
+        # etag`set because it is a computed `Policy` across multiple resources. Subtrees
+        # of Resource Manager resource hierarchy with 'under:' prefix will not be
+        # expanded.
         # @param [String] resource
         #   The name of the resource to start computing the effective `Policy`.
         # @param [Google::Apis::CloudresourcemanagerV1::GetEffectiveOrgPolicyRequest] get_effective_org_policy_request_object
@@ -118,11 +118,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a `Policy` on a resource.
-        # If no `Policy` is set on the resource, a `Policy` is returned with default
-        # values including `POLICY_TYPE_NOT_SET` for the `policy_type oneof`. The
-        # `etag` value can be used with `SetOrgPolicy()` to create or update a
-        # `Policy` during read-modify-write.
+        # Gets a `Policy` on a resource. If no `Policy` is set on the resource, a `
+        # Policy` is returned with default values including `POLICY_TYPE_NOT_SET` for
+        # the `policy_type oneof`. The `etag` value can be used with `SetOrgPolicy()` to
+        # create or update a `Policy` during read-modify-write.
         # @param [String] resource
         #   Name of the resource the `Policy` is set on.
         # @param [Google::Apis::CloudresourcemanagerV1::GetOrgPolicyRequest] get_org_policy_request_object
@@ -222,9 +221,9 @@ module Google
         end
         
         # Updates the specified `Policy` on the resource. Creates a new `Policy` for
-        # that `Constraint` on the resource if one does not exist.
-        # Not supplying an `etag` on the request `Policy` results in an unconditional
-        # write of the `Policy`.
+        # that `Constraint` on the resource if one does not exist. Not supplying an `
+        # etag` on the request `Policy` results in an unconditional write of the `Policy`
+        # .
         # @param [String] resource
         #   Resource name of the resource to attach the `Policy`.
         # @param [Google::Apis::CloudresourcemanagerV1::SetOrgPolicyRequest] set_org_policy_request_object
@@ -258,10 +257,10 @@ module Google
         end
         
         # Create a Lien which applies to the resource denoted by the `parent` field.
-        # Callers of this method will require permission on the `parent` resource.
-        # For example, applying to `projects/1234` requires permission
-        # `resourcemanager.projects.updateLiens`.
-        # NOTE: Some resources may limit the number of Liens which may be applied.
+        # Callers of this method will require permission on the `parent` resource. For
+        # example, applying to `projects/1234` requires permission `resourcemanager.
+        # projects.updateLiens`. NOTE: Some resources may limit the number of Liens
+        # which may be applied.
         # @param [Google::Apis::CloudresourcemanagerV1::Lien] lien_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -291,10 +290,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete a Lien by `name`.
-        # Callers of this method will require permission on the `parent` resource.
-        # For example, a Lien with a `parent` of `projects/1234` requires permission
-        # `resourcemanager.projects.updateLiens`.
+        # Delete a Lien by `name`. Callers of this method will require permission on the
+        # `parent` resource. For example, a Lien with a `parent` of `projects/1234`
+        # requires permission `resourcemanager.projects.updateLiens`.
         # @param [String] name
         #   Required. The name/identifier of the Lien to delete.
         # @param [String] fields
@@ -324,11 +322,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieve a Lien by `name`.
-        # Callers of this method will require permission on the `parent` resource.
-        # For example, a Lien with a `parent` of `projects/1234` requires permission
-        # requires permission `resourcemanager.projects.get` or
-        # `resourcemanager.projects.updateLiens`.
+        # Retrieve a Lien by `name`. Callers of this method will require permission on
+        # the `parent` resource. For example, a Lien with a `parent` of `projects/1234`
+        # requires permission requires permission `resourcemanager.projects.get` or `
+        # resourcemanager.projects.updateLiens`.
         # @param [String] name
         #   Required. The name/identifier of the Lien.
         # @param [String] fields
@@ -358,19 +355,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List all Liens applied to the `parent` resource.
-        # Callers of this method will require permission on the `parent` resource.
-        # For example, a Lien with a `parent` of `projects/1234` requires permission
-        # `resourcemanager.projects.get`.
+        # List all Liens applied to the `parent` resource. Callers of this method will
+        # require permission on the `parent` resource. For example, a Lien with a `
+        # parent` of `projects/1234` requires permission `resourcemanager.projects.get`.
         # @param [Fixnum] page_size
         #   The maximum number of items to return. This is a suggestion for the server.
         # @param [String] page_token
         #   The `next_page_token` value returned from a previous List request, if any.
         # @param [String] parent
-        #   Required. The name of the resource to list all attached Liens.
-        #   For example, `projects/1234`.
-        #   (google.api.field_policy).resource_type annotation is not set since the
-        #   parent depends on the meta api implementation. This field could be a
+        #   Required. The name of the resource to list all attached Liens. For example, `
+        #   projects/1234`. (google.api.field_policy).resource_type annotation is not set
+        #   since the parent depends on the meta api implementation. This field could be a
         #   project or other sub project resources.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -401,9 +396,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
+        # Gets the latest state of a long-running operation. Clients can use this method
+        # to poll the operation result at intervals as recommended by the API service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -469,8 +463,8 @@ module Google
         # Fetches an Organization resource identified by the specified resource name.
         # @param [String] name
         #   The resource name of the Organization to fetch. This is the organization's
-        #   relative path in the API, formatted as "organizations/[organizationId]".
-        #   For example, "organizations/1234".
+        #   relative path in the API, formatted as "organizations/[organizationId]". For
+        #   example, "organizations/1234".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -498,11 +492,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the effective `Policy` on a resource. This is the result of merging
-        # `Policies` in the resource hierarchy. The returned `Policy` will not have
-        # an `etag`set because it is a computed `Policy` across multiple resources.
-        # Subtrees of Resource Manager resource hierarchy with 'under:' prefix will
-        # not be expanded.
+        # Gets the effective `Policy` on a resource. This is the result of merging `
+        # Policies` in the resource hierarchy. The returned `Policy` will not have an `
+        # etag`set because it is a computed `Policy` across multiple resources. Subtrees
+        # of Resource Manager resource hierarchy with 'under:' prefix will not be
+        # expanded.
         # @param [String] resource
         #   The name of the resource to start computing the effective `Policy`.
         # @param [Google::Apis::CloudresourcemanagerV1::GetEffectiveOrgPolicyRequest] get_effective_org_policy_request_object
@@ -535,14 +529,14 @@ 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. 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
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -573,11 +567,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a `Policy` on a resource.
-        # If no `Policy` is set on the resource, a `Policy` is returned with default
-        # values including `POLICY_TYPE_NOT_SET` for the `policy_type oneof`. The
-        # `etag` value can be used with `SetOrgPolicy()` to create or update a
-        # `Policy` during read-modify-write.
+        # Gets a `Policy` on a resource. If no `Policy` is set on the resource, a `
+        # Policy` is returned with default values including `POLICY_TYPE_NOT_SET` for
+        # the `policy_type oneof`. The `etag` value can be used with `SetOrgPolicy()` to
+        # create or update a `Policy` during read-modify-write.
         # @param [String] resource
         #   Name of the resource the `Policy` is set on.
         # @param [Google::Apis::CloudresourcemanagerV1::GetOrgPolicyRequest] get_org_policy_request_object
@@ -676,12 +669,11 @@ 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.
-        # Search will only return organizations on which the user has the permission
-        # `resourcemanager.organizations.get`
+        # 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. Search
+        # will only return organizations on which the user has the permission `
+        # resourcemanager.organizations.get`
         # @param [Google::Apis::CloudresourcemanagerV1::SearchOrganizationsRequest] search_organizations_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -713,12 +705,12 @@ module Google
         
         # 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 permission
-        # `resourcemanager.organizations.setIamPolicy` on the specified organization
+        # name, e.g. "organizations/123". Authorization requires the Google IAM
+        # permission `resourcemanager.organizations.setIamPolicy` on the specified
+        # 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.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -750,9 +742,9 @@ module Google
         end
         
         # Updates the specified `Policy` on the resource. Creates a new `Policy` for
-        # that `Constraint` on the resource if one does not exist.
-        # Not supplying an `etag` on the request `Policy` results in an unconditional
-        # write of the `Policy`.
+        # that `Constraint` on the resource if one does not exist. Not supplying an `
+        # etag` on the request `Policy` results in an unconditional write of the `Policy`
+        # .
         # @param [String] resource
         #   Resource name of the resource to attach the `Policy`.
         # @param [Google::Apis::CloudresourcemanagerV1::SetOrgPolicyRequest] set_org_policy_request_object
@@ -785,13 +777,12 @@ 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. "organizations/123".
-        # There are no permissions required for making this API call.
+        # Returns permissions that a caller has on the specified Organization. The `
+        # resource` field should be the organization's resource name, e.g. "
+        # 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 operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -855,19 +846,17 @@ 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.
-        # Authorization requires the Google IAM permission
-        # `resourcemanager.projects.create` on the specified parent for the new
-        # project. The parent is identified by a specified ResourceId,
-        # which must include both an ID and a type, such as organization.
-        # This method does not associate the new project with a billing account.
-        # You can set or update the billing account associated with a project using
-        # the [`projects.updateBillingInfo`]
-        # (/billing/reference/rest/v1/projects/updateBillingInfo) method.
+        # 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.
+        # Authorization requires the Google IAM permission `resourcemanager.projects.
+        # create` on the specified parent for the new project. The parent is identified
+        # by a specified ResourceId, which must include both an ID and a type, such as
+        # organization. This method does not associate the new project with a billing
+        # account. You can set or update the billing account associated with a project
+        # using the [`projects.updateBillingInfo`] (/billing/reference/rest/v1/projects/
+        # updateBillingInfo) method.
         # @param [Google::Apis::CloudresourcemanagerV1::Project] project_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -897,26 +886,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Marks the Project identified by the specified
-        # `project_id` (for example, `my-project-123`) for deletion.
-        # This method will only affect the Project if 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 retrievable by
-        # the  GetProject and
-        # ListProjects methods.
-        # The caller must have modify permissions for this Project.
+        # Marks the Project identified by the specified `project_id` (for example, `my-
+        # project-123`) 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
+        # retrievable by the GetProject and ListProjects methods. The caller must have
+        # modify permissions for this Project.
         # @param [String] project_id
-        #   The Project ID (for example, `foo-bar-123`).
-        #   Required.
+        #   The Project ID (for example, `foo-bar-123`). Required.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -944,12 +925,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the Project identified by the specified
-        # `project_id` (for example, `my-project-123`).
-        # The caller must have read permissions for this Project.
+        # Retrieves the Project identified by the specified `project_id` (for example, `
+        # my-project-123`). The caller must have read permissions for this Project.
         # @param [String] project_id
-        #   The Project ID (for example, `my-project-123`).
-        #   Required.
+        #   The Project ID (for example, `my-project-123`). Required.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -977,12 +956,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a list of ancestors in the resource hierarchy for the Project
-        # identified by the specified `project_id` (for example, `my-project-123`).
-        # The caller must have read permissions for this Project.
+        # Gets a list of ancestors in the resource hierarchy for the Project identified
+        # by the specified `project_id` (for example, `my-project-123`). The caller must
+        # have read permissions for this Project.
         # @param [String] project_id
-        #   The Project ID (for example, `my-project-123`).
-        #   Required.
+        #   The Project ID (for example, `my-project-123`). Required.
         # @param [Google::Apis::CloudresourcemanagerV1::GetAncestryRequest] get_ancestry_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1013,11 +991,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the effective `Policy` on a resource. This is the result of merging
-        # `Policies` in the resource hierarchy. The returned `Policy` will not have
-        # an `etag`set because it is a computed `Policy` across multiple resources.
-        # Subtrees of Resource Manager resource hierarchy with 'under:' prefix will
-        # not be expanded.
+        # Gets the effective `Policy` on a resource. This is the result of merging `
+        # Policies` in the resource hierarchy. The returned `Policy` will not have an `
+        # etag`set because it is a computed `Policy` across multiple resources. Subtrees
+        # of Resource Manager resource hierarchy with 'under:' prefix will not be
+        # expanded.
         # @param [String] resource
         #   The name of the resource to start computing the effective `Policy`.
         # @param [Google::Apis::CloudresourcemanagerV1::GetEffectiveOrgPolicyRequest] get_effective_org_policy_request_object
@@ -1050,15 +1028,15 @@ 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.
-        # Authorization requires the Google IAM permission
-        # `resourcemanager.projects.getIamPolicy` on the project.
-        # For additional information about `resource` (e.g. my-project-id) structure
-        # and identification, see [Resource Names](/apis/design/resource_names).
+        # Returns the IAM access control policy for the specified Project. Permission is
+        # denied if the policy or the resource does not exist. Authorization requires
+        # the Google IAM permission `resourcemanager.projects.getIamPolicy` on the
+        # project. For additional information about `resource` (e.g. my-project-id)
+        # structure and identification, see [Resource Names](/apis/design/resource_names)
+        # .
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1089,11 +1067,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets a `Policy` on a resource.
-        # If no `Policy` is set on the resource, a `Policy` is returned with default
-        # values including `POLICY_TYPE_NOT_SET` for the `policy_type oneof`. The
-        # `etag` value can be used with `SetOrgPolicy()` to create or update a
-        # `Policy` during read-modify-write.
+        # Gets a `Policy` on a resource. If no `Policy` is set on the resource, a `
+        # Policy` is returned with default values including `POLICY_TYPE_NOT_SET` for
+        # the `policy_type oneof`. The `etag` value can be used with `SetOrgPolicy()` to
+        # create or update a `Policy` during read-modify-write.
         # @param [String] resource
         #   Name of the resource the `Policy` is set on.
         # @param [Google::Apis::CloudresourcemanagerV1::GetOrgPolicyRequest] get_org_policy_request_object
@@ -1127,61 +1104,43 @@ module Google
         end
         
         # Lists Projects that the caller has the `resourcemanager.projects.get`
-        # permission on and satisfy the specified filter.
-        # 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.
-        # NOTE: If the request filter contains a `parent.type` and `parent.id` and
-        # the caller has the `resourcemanager.projects.list` permission on the
-        # parent, the results will be drawn from an alternate index which provides
-        # more consistent results. In future versions of this API, this List method
-        # will be split into List and Search to properly capture the behavorial
-        # difference.
+        # permission on and satisfy the specified filter. 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.
+        # NOTE: If the request filter contains a `parent.type` and `parent.id` and the
+        # caller has the `resourcemanager.projects.list` permission on the parent, the
+        # results will be drawn from an alternate index which provides more consistent
+        # results. In future versions of this API, this List method will be split into
+        # List and Search to properly capture the behavorial difference.
         # @param [String] filter
-        #   An expression for filtering the results of the request.  Filter rules are
-        #   case insensitive. Some eligible fields for filtering are:
-        #   + `name`
-        #   + `id`
-        #   + `labels.<key>` (where *key* is the name of a label)
-        #   + `parent.type`
-        #   + `parent.id`
-        #   + `lifecycleState`
-        #   Some examples of filter strings:
-        #   | Filter           | 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&nbsp;labels.size:big | The project's label `color`    |
-        #   :                                       : has the value `red` and its    :
-        #   :                                       : label`size` has the value      :
-        #   :                                       : `big`.                         :
-        #   | lifecycleState:DELETE_REQUESTED       | Only show projects that are    |
-        #   :                                       : pending deletion.              :
-        #   If no filter is specified, the call will return projects for which the user
-        #   has the `resourcemanager.projects.get` permission.
-        #   NOTE: To perform a by-parent query (eg., what projects are directly in a
-        #   Folder), the caller must have the `resourcemanager.projects.list`
-        #   permission on the parent and the filter must contain both a `parent.type`
-        #   and a `parent.id` restriction
-        #   (example: "parent.type:folder parent.id:123"). In this case an alternate
-        #   search index is used which provides more consistent results.
-        #   Optional.
+        #   An expression for filtering the results of the request. Filter rules are case
+        #   insensitive. Some eligible fields for filtering are: + `name` + `id` + `labels.
+        #   ` (where *key* is the name of a label) + `parent.type` + `parent.id` + `
+        #   lifecycleState` Some examples of filter strings: | Filter | 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`. : |
+        #   lifecycleState:DELETE_REQUESTED | Only show projects that are | : : pending
+        #   deletion. : If no filter is specified, the call will return projects for which
+        #   the user has the `resourcemanager.projects.get` permission. NOTE: To perform a
+        #   by-parent query (eg., what projects are directly in a Folder), the caller must
+        #   have the `resourcemanager.projects.list` permission on the parent and the
+        #   filter must contain both a `parent.type` and a `parent.id` restriction (
+        #   example: "parent.type:folder parent.id:123"). In this case an alternate search
+        #   index is used which provides more consistent results. Optional.
         # @param [Fixnum] page_size
-        #   The maximum number of Projects to return in the response.
-        #   The server can return fewer Projects than requested.
-        #   If unspecified, server picks an appropriate default.
-        #   Optional.
+        #   The maximum number of Projects to return in the response. The server can
+        #   return fewer Projects than requested. If unspecified, server picks an
+        #   appropriate default. Optional.
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListProjects
-        #   that indicates from where listing should continue.
-        #   Optional.
+        #   A pagination token returned from a previous call to ListProjects that
+        #   indicates from where listing should continue. Optional.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1277,47 +1236,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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 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.
-        # For additional information about `resource` (e.g. my-project-id) structure
-        # and identification, see [Resource Names](/apis/design/resource_names).
-        # The following constraints apply when using `setIamPolicy()`:
-        # + Project does not support `allUsers` and `allAuthenticatedUsers` as
-        # `members` in a `Binding` of a `Policy`.
-        # + The owner role can be granted to a `user`, `serviceAccount`, or a group
-        # that is part of an organization. For example,
-        # group@myownpersonaldomain.com could be added as 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
+        # 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
+        # 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. For additional information about `resource` (e.g. my-
+        # project-id) structure and identification, see [Resource Names](/apis/design/
+        # resource_names). The following constraints apply when using `setIamPolicy()`: +
+        # Project does not support `allUsers` and `allAuthenticatedUsers` as `members`
+        # in a `Binding` of a `Policy`. + The owner role can be granted to a `user`, `
+        # serviceAccount`, or a group that is part of an organization. For example,
+        # group@myownpersonaldomain.com could be added as 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.
-        # + You can only grant ownership of a project to a member by using the
-        # GCP Console. Inviting a member will deliver an invitation email that
-        # they must accept. An invitation email is not generated if you are
-        # granting a role other than owner, or if both the member you are inviting
-        # and the project are part of your organization.
-        # + 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 who has accepted the Terms of Service (ToS) agreement in the
-        # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner
-        # from the policy will fail. This restriction also applies to legacy
-        # projects that no longer have owners who have accepted the ToS. Edits to
-        # IAM policies will be rejected until the lack of a ToS-accepting owner is
-        # rectified.
-        # Authorization requires the Google IAM permission
-        # `resourcemanager.projects.setIamPolicy` on the project
+        # 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. + You can only grant ownership of a project to a member
+        # by using the GCP Console. Inviting a member will deliver an invitation email
+        # that they must accept. An invitation email is not generated if you are
+        # granting a role other than owner, or if both the member you are inviting and
+        # the project are part of your organization. + 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 who has accepted the Terms of Service (ToS) agreement in the
+        # policy. Calling `setIamPolicy()` to remove the last ToS-accepted owner from
+        # the policy will fail. This restriction also applies to legacy projects that no
+        # longer have owners who have accepted the ToS. Edits to IAM policies will be
+        # rejected until the lack of a ToS-accepting owner is rectified. Authorization
+        # requires the Google IAM permission `resourcemanager.projects.setIamPolicy` on
+        # the project
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1349,9 +1302,9 @@ module Google
         end
         
         # Updates the specified `Policy` on the resource. Creates a new `Policy` for
-        # that `Constraint` on the resource if one does not exist.
-        # Not supplying an `etag` on the request `Policy` results in an unconditional
-        # write of the `Policy`.
+        # that `Constraint` on the resource if one does not exist. Not supplying an `
+        # etag` on the request `Policy` results in an unconditional write of the `Policy`
+        # .
         # @param [String] resource
         #   Resource name of the resource to attach the `Policy`.
         # @param [Google::Apis::CloudresourcemanagerV1::SetOrgPolicyRequest] set_org_policy_request_object
@@ -1384,13 +1337,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified Project.
-        # For additional information about `resource` (e.g. my-project-id) structure
-        # and identification, see [Resource Names](/apis/design/resource_names).
-        # There are no permissions required for making this API call.
+        # Returns permissions that a caller has on the specified Project. For additional
+        # information about `resource` (e.g. my-project-id) structure and identification,
+        # see [Resource Names](/apis/design/resource_names). There are no permissions
+        # required for making this API call.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudresourcemanagerV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1421,15 +1374,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Restores the Project identified by the specified
-        # `project_id` (for example, `my-project-123`).
-        # You can only use this method for a Project that has a lifecycle state of
-        # DELETE_REQUESTED.
-        # After deletion starts, the Project cannot be restored.
-        # The caller must have modify permissions for this Project.
+        # Restores the Project identified by the specified `project_id` (for example, `
+        # my-project-123`). You can only use this method for a Project that has a
+        # lifecycle state of DELETE_REQUESTED. After deletion starts, the Project cannot
+        # be restored. The caller must have modify permissions for this Project.
         # @param [String] project_id
-        #   The project ID (for example, `foo-bar-123`).
-        #   Required.
+        #   The project ID (for example, `foo-bar-123`). Required.
         # @param [Google::Apis::CloudresourcemanagerV1::UndeleteProjectRequest] undelete_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1460,12 +1410,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the attributes of the Project identified by the specified
-        # `project_id` (for example, `my-project-123`).
-        # The caller must have modify permissions for this Project.
+        # Updates the attributes of the Project identified by the specified `project_id`
+        # (for example, `my-project-123`). The caller must have modify permissions for
+        # this Project.
         # @param [String] project_id
-        #   The project ID (for example, `my-project-123`).
-        #   Required.
+        #   The project ID (for example, `my-project-123`). Required.
         # @param [Google::Apis::CloudresourcemanagerV1::Project] project_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.