google-api-client 0.42.0 → 0.43.0

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

@@ -51,11 +51,11 @@ 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] organization_id
-        #   The id of the Organization resource to fetch.
-        #   This field is deprecated and will be removed in v1. Use name instead.
+        #   The id of the Organization resource to fetch. This field is deprecated and
+        #   will be removed in v1. Use name instead.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -84,12 +84,12 @@ 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
+        # Gets the access control policy for an Organization resource. May be empty if
+        # no such policy or resource exists. The `resource` field should be the
         # organization's resource name, e.g. "organizations/123".
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   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::CloudresourcemanagerV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -120,26 +120,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists 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 list.
+        # Lists 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 list.
         # @param [String] filter
-        #   An optional query string used to filter the Organizations to return in
-        #   the response. Filter rules are case-insensitive.
-        #   Organizations may be filtered by `owner.directoryCustomerId` or by
-        #   `domain`, where the domain is a G Suite domain, for example:
-        #   * Filter `owner.directorycustomerid:123456789` returns Organization
-        #   resources with `owner.directory_customer_id` equal to `123456789`.
-        #   * Filter `domain:google.com` returns Organization resources corresponding
-        #   to the domain `google.com`.
-        #   This field is optional.
+        #   An optional query string used to filter the Organizations to return in the
+        #   response. Filter rules are case-insensitive. Organizations may be filtered by `
+        #   owner.directoryCustomerId` or by `domain`, where the domain is a G Suite
+        #   domain, for example: * Filter `owner.directorycustomerid:123456789` returns
+        #   Organization resources with `owner.directory_customer_id` equal to `123456789`.
+        #   * Filter `domain:google.com` returns Organization resources corresponding to
+        #   the domain `google.com`. This field is optional.
         # @param [Fixnum] page_size
-        #   The maximum number of Organizations to return in the response.
-        #   This field is optional.
+        #   The maximum number of Organizations to return in the response. This field is
+        #   optional.
         # @param [String] page_token
-        #   A pagination token returned from a previous call to `ListOrganizations`
-        #   that indicates from where listing should continue.
-        #   This field is optional.
+        #   A pagination token returned from a previous call to `ListOrganizations` that
+        #   indicates from where listing should continue. This field is optional.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -173,8 +170,8 @@ module Google
         # existing policy. The `resource` field should be the organization's resource
         # name, e.g. "organizations/123".
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   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::CloudresourcemanagerV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -205,12 +202,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".
+        # Returns permissions that a caller has on the specified Organization. The `
+        # resource` field should be the organization's resource name, e.g. "
+        # organizations/123".
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   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::CloudresourcemanagerV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -243,9 +240,9 @@ module Google
         
         # Updates an Organization resource identified by the specified resource name.
         # @param [String] name
-        #   Output only. The resource name of the organization. This is the
-        #   organization's relative path in the API. Its format is
-        #   "organizations/[organization_id]". For example, "organizations/1234".
+        #   Output only. The resource name of the organization. This is the organization's
+        #   relative path in the API. Its format is "organizations/[organization_id]". For
+        #   example, "organizations/1234".
         # @param [Google::Apis::CloudresourcemanagerV1beta1::Organization] organization_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -276,18 +273,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a Project resource.
-        # Initially, the Project resource is owned by its creator exclusively.
-        # The creator can later grant permission to others to read or update the
-        # Project.
-        # Several APIs are activated automatically for the Project, including
-        # Google Cloud Storage. The parent is identified by a specified
-        # ResourceId, which must include both an ID and a type, such as
-        # project, folder, or 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.
+        # Creates a Project resource. Initially, the Project resource is owned by its
+        # creator exclusively. The creator can later grant permission to others to read
+        # or update the Project. Several APIs are activated automatically for the
+        # Project, including Google Cloud Storage. The parent is identified by a
+        # specified ResourceId, which must include both an ID and a type, such as
+        # project, folder, or 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::CloudresourcemanagerV1beta1::Project] project_object
         # @param [Boolean] use_legacy_stack
         #   A now unused experiment opt-out option.
@@ -320,27 +314,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
@@ -368,12 +353,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
@@ -401,12 +384,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::CloudresourcemanagerV1beta1::GetAncestryRequest] get_ancestry_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -437,13 +419,13 @@ 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.
-        # For additional information about resource 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. For additional
+        # information about resource 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::CloudresourcemanagerV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -475,56 +457,42 @@ 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. The fields eligible for filtering are:
-        #   + `name`
-        #   + `id`
-        #   + `labels.<key>` (where *key* is the name of a label)
-        #   + `parent.type`
-        #   + `parent.id`
-        #   Some examples of using labels as filters:
-        #   | 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`.              |
-        #   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. The fields eligible for filtering are: + `name` + `id` + `labels.`
+        #   (where *key* is the name of a label) + `parent.type` + `parent.id` Some
+        #   examples of using labels as filters: | 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`. | 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
@@ -554,42 +522,36 @@ 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.
-        # 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.
+        # 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. 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.
-        # + 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 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
+        # 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
+        # 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::CloudresourcemanagerV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -622,8 +584,8 @@ module Google
         
         # Returns permissions that a caller has on the specified Project.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   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::CloudresourcemanagerV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -654,15 +616,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::CloudresourcemanagerV1beta1::UndeleteProjectRequest] undelete_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -693,12 +652,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::CloudresourcemanagerV1beta1::Project] project_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/cloudresourcemanager_v1beta1.rb

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