google-api-client 0.42.0 → 0.44.1

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

@@ -47,11 +47,10 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Create an `AccessPolicy`. Fails if this organization already has a
-        # `AccessPolicy`. The longrunning Operation will have a successful status
-        # once the `AccessPolicy` has propagated to long-lasting storage.
-        # Syntactic and basic semantic errors will be returned in `metadata` as a
-        # BadRequest proto.
+        # Create an `AccessPolicy`. Fails if this organization already has a `
+        # AccessPolicy`. The longrunning Operation will have a successful status once
+        # the `AccessPolicy` has propagated to long-lasting storage. Syntactic and basic
+        # semantic errors will be returned in `metadata` as a BadRequest proto.
         # @param [Google::Apis::AccesscontextmanagerV1::AccessPolicy] access_policy_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -81,13 +80,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete an AccessPolicy by resource
-        # name. The longrunning Operation will have a successful status once the
-        # AccessPolicy
-        # has been removed from long-lasting storage.
+        # Delete an AccessPolicy by resource name. The longrunning Operation will have a
+        # successful status once the AccessPolicy has been removed from long-lasting
+        # storage.
         # @param [String] name
-        #   Required. Resource name for the access policy to delete.
-        #   Format `accessPolicies/`policy_id``
+        #   Required. Resource name for the access policy to delete. Format `
+        #   accessPolicies/`policy_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -117,8 +115,8 @@ module Google
         
         # Get an AccessPolicy by name.
         # @param [String] name
-        #   Required. Resource name for the access policy to get.
-        #   Format `accessPolicies/`policy_id``
+        #   Required. Resource name for the access policy to get. Format `accessPolicies/`
+        #   policy_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -146,18 +144,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List all AccessPolicies under a
-        # container.
+        # List all AccessPolicies under a container.
         # @param [Fixnum] page_size
         #   Number of AccessPolicy instances to include in the list. Default 100.
         # @param [String] page_token
-        #   Next page token for the next batch of AccessPolicy instances. Defaults to
-        #   the first page of results.
+        #   Next page token for the next batch of AccessPolicy instances. Defaults to the
+        #   first page of results.
         # @param [String] parent
-        #   Required. Resource name for the container to list AccessPolicy instances
-        #   from.
-        #   Format:
-        #   `organizations/`org_id``
+        #   Required. Resource name for the container to list AccessPolicy instances from.
+        #   Format: `organizations/`org_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -187,14 +182,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update an AccessPolicy. The
-        # longrunning Operation from this RPC will have a successful status once the
-        # changes to the AccessPolicy have propagated
-        # to long-lasting storage. Syntactic and basic semantic errors will be
-        # returned in `metadata` as a BadRequest proto.
+        # Update an AccessPolicy. The longrunning Operation from this RPC will have a
+        # successful status once the changes to the AccessPolicy have propagated to long-
+        # lasting storage. Syntactic and basic semantic errors will be returned in `
+        # metadata` as a BadRequest proto.
         # @param [String] name
-        #   Output only. Resource name of the `AccessPolicy`. Format:
-        #   `accessPolicies/`policy_id``
+        #   Output only. Resource name of the `AccessPolicy`. Format: `accessPolicies/`
+        #   policy_id``
         # @param [Google::Apis::AccesscontextmanagerV1::AccessPolicy] access_policy_object
         # @param [String] update_mask
         #   Required. Mask to control which fields get updated. Must be non-empty.
@@ -228,14 +222,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create an Access Level. The longrunning
-        # operation from this RPC will have a successful status once the Access
-        # Level has
-        # propagated to long-lasting storage. Access Levels containing
-        # errors will result in an error response for the first error encountered.
+        # Create an Access Level. The longrunning operation from this RPC will have a
+        # successful status once the Access Level has propagated to long-lasting storage.
+        # Access Levels containing errors will result in an error response for the
+        # first error encountered.
         # @param [String] parent
-        #   Required. Resource name for the access policy which owns this Access
-        #   Level.
+        #   Required. Resource name for the access policy which owns this Access Level.
         #   Format: `accessPolicies/`policy_id``
         # @param [Google::Apis::AccesscontextmanagerV1::AccessLevel] access_level_object
         # @param [String] fields
@@ -267,14 +259,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete an Access Level by resource
-        # name. The longrunning operation from this RPC will have a successful status
-        # once the Access Level has been removed
-        # from long-lasting storage.
+        # Delete an Access Level by resource name. The longrunning operation from this
+        # RPC will have a successful status once the Access Level has been removed from
+        # long-lasting storage.
         # @param [String] name
-        #   Required. Resource name for the Access Level.
-        #   Format:
-        #   `accessPolicies/`policy_id`/accessLevels/`access_level_id``
+        #   Required. Resource name for the Access Level. Format: `accessPolicies/`
+        #   policy_id`/accessLevels/`access_level_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -302,20 +292,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get an Access Level by resource
-        # name.
+        # Get an Access Level by resource name.
         # @param [String] name
-        #   Required. Resource name for the Access Level.
-        #   Format:
-        #   `accessPolicies/`policy_id`/accessLevels/`access_level_id``
+        #   Required. Resource name for the Access Level. Format: `accessPolicies/`
+        #   policy_id`/accessLevels/`access_level_id``
         # @param [String] access_level_format
-        #   Whether to return `BasicLevels` in the Cloud Common Expression
-        #   Language rather than as `BasicLevels`. Defaults to AS_DEFINED, where
-        #   Access Levels
-        #   are returned as `BasicLevels` or `CustomLevels` based on how they were
-        #   created. If set to CEL, all Access Levels are returned as
-        #   `CustomLevels`. In the CEL case, `BasicLevels` are translated to equivalent
-        #   `CustomLevels`.
+        #   Whether to return `BasicLevels` in the Cloud Common Expression Language rather
+        #   than as `BasicLevels`. Defaults to AS_DEFINED, where Access Levels are
+        #   returned as `BasicLevels` or `CustomLevels` based on how they were created. If
+        #   set to CEL, all Access Levels are returned as `CustomLevels`. In the CEL case,
+        #   `BasicLevels` are translated to equivalent `CustomLevels`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -344,22 +330,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List all Access Levels for an access
-        # policy.
+        # List all Access Levels for an access policy.
         # @param [String] parent
         #   Required. Resource name for the access policy to list Access Levels from.
-        #   Format:
-        #   `accessPolicies/`policy_id``
+        #   Format: `accessPolicies/`policy_id``
         # @param [String] access_level_format
-        #   Whether to return `BasicLevels` in the Cloud Common Expression language, as
-        #   `CustomLevels`, rather than as `BasicLevels`. Defaults to returning
-        #   `AccessLevels` in the format they were defined.
+        #   Whether to return `BasicLevels` in the Cloud Common Expression language, as `
+        #   CustomLevels`, rather than as `BasicLevels`. Defaults to returning `
+        #   AccessLevels` in the format they were defined.
         # @param [Fixnum] page_size
-        #   Number of Access Levels to include in
-        #   the list. Default 100.
+        #   Number of Access Levels to include in the list. Default 100.
         # @param [String] page_token
-        #   Next page token for the next batch of Access Level instances.
-        #   Defaults to the first page of results.
+        #   Next page token for the next batch of Access Level instances. Defaults to the
+        #   first page of results.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -390,16 +373,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update an Access Level. The longrunning
-        # operation from this RPC will have a successful status once the changes to
-        # the Access Level have propagated
-        # to long-lasting storage. Access Levels containing
-        # errors will result in an error response for the first error encountered.
+        # Update an Access Level. The longrunning operation from this RPC will have a
+        # successful status once the changes to the Access Level have propagated to long-
+        # lasting storage. Access Levels containing errors will result in an error
+        # response for the first error encountered.
         # @param [String] name
-        #   Required. Resource name for the Access Level. The `short_name` component
-        #   must begin with a letter and only include alphanumeric and '_'. Format:
-        #   `accessPolicies/`policy_id`/accessLevels/`short_name``. The maximum length
-        #   of the `short_name` component is 50 characters.
+        #   Required. Resource name for the Access Level. The `short_name` component must
+        #   begin with a letter and only include alphanumeric and '_'. Format: `
+        #   accessPolicies/`policy_id`/accessLevels/`short_name``. The maximum length of
+        #   the `short_name` component is 50 characters.
         # @param [Google::Apis::AccesscontextmanagerV1::AccessLevel] access_level_object
         # @param [String] update_mask
         #   Required. Mask to control which fields get updated. Must be non-empty.
@@ -433,21 +415,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Replace all existing Access Levels in an Access
-        # Policy with
-        # the Access Levels provided. This
-        # is done atomically. The longrunning operation from this RPC will have a
-        # successful status once all replacements have propagated to long-lasting
-        # storage. Replacements containing errors will result in an error response
-        # for the first error encountered.  Replacement will be cancelled on error,
-        # existing Access Levels will not be
-        # affected. Operation.response field will contain
-        # ReplaceAccessLevelsResponse. Removing Access Levels contained in existing
-        # Service Perimeters will result in
-        # error.
+        # Replace all existing Access Levels in an Access Policy with the Access Levels
+        # provided. This is done atomically. The longrunning operation from this RPC
+        # will have a successful status once all replacements have propagated to long-
+        # lasting storage. Replacements containing errors will result in an error
+        # response for the first error encountered. Replacement will be cancelled on
+        # error, existing Access Levels will not be affected. Operation.response field
+        # will contain ReplaceAccessLevelsResponse. Removing Access Levels contained in
+        # existing Service Perimeters will result in error.
         # @param [String] parent
-        #   Required. Resource name for the access policy which owns these
-        #   Access Levels.
+        #   Required. Resource name for the access policy which owns these Access Levels.
         #   Format: `accessPolicies/`policy_id``
         # @param [Google::Apis::AccesscontextmanagerV1::ReplaceAccessLevelsRequest] replace_access_levels_request_object
         # @param [String] fields
@@ -479,23 +456,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Commit the dry-run spec for all the Service Perimeters in an
-        # Access Policy.
-        # A commit operation on a Service Perimeter involves copying its `spec` field
-        # to that Service Perimeter's `status` field. Only Service Perimeters with
-        # `use_explicit_dry_run_spec` field set to true are affected by a commit
+        # Commit the dry-run spec for all the Service Perimeters in an Access Policy. A
+        # commit operation on a Service Perimeter involves copying its `spec` field to
+        # that Service Perimeter's `status` field. Only Service Perimeters with `
+        # use_explicit_dry_run_spec` field set to true are affected by a commit
         # operation. The longrunning operation from this RPC will have a successful
         # status once the dry-run specs for all the Service Perimeters have been
         # committed. If a commit fails, it will cause the longrunning operation to
         # return an error response and the entire commit operation will be cancelled.
         # When successful, Operation.response field will contain
-        # CommitServicePerimetersResponse. The `dry_run` and the `spec` fields will
-        # be cleared after a successful commit operation.
+        # CommitServicePerimetersResponse. The `dry_run` and the `spec` fields will be
+        # cleared after a successful commit operation.
         # @param [String] parent
-        #   Required. Resource name for the parent Access Policy which owns all
-        #   Service Perimeters in scope for
-        #   the commit operation.
-        #   Format: `accessPolicies/`policy_id``
+        #   Required. Resource name for the parent Access Policy which owns all Service
+        #   Perimeters in scope for the commit operation. Format: `accessPolicies/`
+        #   policy_id``
         # @param [Google::Apis::AccesscontextmanagerV1::CommitServicePerimetersRequest] commit_service_perimeters_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -526,15 +501,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Create a Service Perimeter. The
-        # longrunning operation from this RPC will have a successful status once the
-        # Service Perimeter has
-        # propagated to long-lasting storage. Service Perimeters containing
-        # errors will result in an error response for the first error encountered.
+        # Create a Service Perimeter. The longrunning operation from this RPC will have
+        # a successful status once the Service Perimeter has propagated to long-lasting
+        # storage. Service Perimeters containing errors will result in an error response
+        # for the first error encountered.
         # @param [String] parent
         #   Required. Resource name for the access policy which owns this Service
-        #   Perimeter.
-        #   Format: `accessPolicies/`policy_id``
+        #   Perimeter. Format: `accessPolicies/`policy_id``
         # @param [Google::Apis::AccesscontextmanagerV1::ServicePerimeter] service_perimeter_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -565,14 +538,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Delete a Service Perimeter by resource
-        # name. The longrunning operation from this RPC will have a successful status
-        # once the Service Perimeter has been
+        # Delete a Service Perimeter by resource name. The longrunning operation from
+        # this RPC will have a successful status once the Service Perimeter has been
         # removed from long-lasting storage.
         # @param [String] name
-        #   Required. Resource name for the Service Perimeter.
-        #   Format:
-        #   `accessPolicies/`policy_id`/servicePerimeters/`service_perimeter_id``
+        #   Required. Resource name for the Service Perimeter. Format: `accessPolicies/`
+        #   policy_id`/servicePerimeters/`service_perimeter_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -600,12 +571,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get a Service Perimeter by resource
-        # name.
+        # Get a Service Perimeter by resource name.
         # @param [String] name
-        #   Required. Resource name for the Service Perimeter.
-        #   Format:
-        #   `accessPolicies/`policy_id`/servicePerimeters/`service_perimeters_id``
+        #   Required. Resource name for the Service Perimeter. Format: `accessPolicies/`
+        #   policy_id`/servicePerimeters/`service_perimeters_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -633,18 +602,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List all Service Perimeters for an
-        # access policy.
+        # List all Service Perimeters for an access policy.
         # @param [String] parent
         #   Required. Resource name for the access policy to list Service Perimeters from.
-        #   Format:
-        #   `accessPolicies/`policy_id``
+        #   Format: `accessPolicies/`policy_id``
         # @param [Fixnum] page_size
-        #   Number of Service Perimeters to include
-        #   in the list. Default 100.
+        #   Number of Service Perimeters to include in the list. Default 100.
         # @param [String] page_token
-        #   Next page token for the next batch of Service Perimeter instances.
-        #   Defaults to the first page of results.
+        #   Next page token for the next batch of Service Perimeter instances. Defaults to
+        #   the first page of results.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -674,15 +640,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update a Service Perimeter. The
-        # longrunning operation from this RPC will have a successful status once the
-        # changes to the Service Perimeter have
-        # propagated to long-lasting storage. Service Perimeter containing
-        # errors will result in an error response for the first error encountered.
+        # Update a Service Perimeter. The longrunning operation from this RPC will have
+        # a successful status once the changes to the Service Perimeter have propagated
+        # to long-lasting storage. Service Perimeter containing errors will result in an
+        # error response for the first error encountered.
         # @param [String] name
-        #   Required. Resource name for the ServicePerimeter.  The `short_name`
-        #   component must begin with a letter and only include alphanumeric and '_'.
-        #   Format: `accessPolicies/`policy_id`/servicePerimeters/`short_name``
+        #   Required. Resource name for the ServicePerimeter. The `short_name` component
+        #   must begin with a letter and only include alphanumeric and '_'. Format: `
+        #   accessPolicies/`policy_id`/servicePerimeters/`short_name``
         # @param [Google::Apis::AccesscontextmanagerV1::ServicePerimeter] service_perimeter_object
         # @param [String] update_mask
         #   Required. Mask to control which fields get updated. Must be non-empty.
@@ -716,20 +681,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Replace all existing Service Perimeters in an
-        # Access Policy
-        # with the Service Perimeters provided.
-        # This is done atomically. The longrunning operation from this
-        # RPC will have a successful status once all replacements have propagated to
-        # long-lasting storage. Replacements containing errors will result in an
-        # error response for the first error encountered. Replacement will be
-        # cancelled on error, existing Service Perimeters will not be
-        # affected. Operation.response field will contain
-        # ReplaceServicePerimetersResponse.
+        # Replace all existing Service Perimeters in an Access Policy with the Service
+        # Perimeters provided. This is done atomically. The longrunning operation from
+        # this RPC will have a successful status once all replacements have propagated
+        # to long-lasting storage. Replacements containing errors will result in an
+        # error response for the first error encountered. Replacement will be cancelled
+        # on error, existing Service Perimeters will not be affected. Operation.response
+        # field will contain ReplaceServicePerimetersResponse.
         # @param [String] parent
-        #   Required. Resource name for the access policy which owns these
-        #   Service Perimeters.
-        #   Format: `accessPolicies/`policy_id``
+        #   Required. Resource name for the access policy which owns these Service
+        #   Perimeters. Format: `accessPolicies/`policy_id``
         # @param [Google::Apis::AccesscontextmanagerV1::ReplaceServicePerimetersRequest] replace_service_perimeters_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -760,15 +721,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
-        # Operations.GetOperation or
-        # other methods to check whether the cancellation succeeded or whether the
-        # operation completed despite cancellation. On successful cancellation,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed. If the
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
+        # Clients can use Operations.GetOperation or other methods to check whether the
+        # cancellation succeeded or whether the operation completed despite cancellation.
+        # On successful cancellation, the operation is not deleted; instead, it becomes
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -802,10 +761,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
-        # no longer interested in the operation result. It does not cancel the
-        # operation. If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # Deletes a long-running operation. This method indicates that the client is no
+        # longer interested in the operation result. It does not cancel the operation.
+        # If the server doesn't support this method, it returns `google.rpc.Code.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -835,9 +794,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
@@ -867,15 +825,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Lists operations that match the specified filter in the request. If the server
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
+        # binding allows API services to override the binding to use different resource
+        # name schemes, such as `users/*/operations`. To override the binding, API
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
+        # service configuration. For backwards compatibility, the default name includes
+        # the operations collection id, however overriding users must ensure the name
+        # binding is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter