original_docstring: r"""Changes one or more properties of an existing
          exclusion.
  
          Args:
              request (Union[google.cloud.logging_v2.types.UpdateExclusionRequest, dict]):
                  The request object. The parameters to `UpdateExclusion`.
              name (:class:`str`):
                  Required. The resource name of the exclusion to update:
  
                  ::
  
                      "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
                      "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
                      "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
                      "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
  
                  Example:
                  ``"projects/my-project-id/exclusions/my-exclusion-id"``.
  
                  This corresponds to the ``name`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              exclusion (:class:`google.cloud.logging_v2.types.LogExclusion`):
                  Required. New values for the existing exclusion. Only
                  the fields specified in ``update_mask`` are relevant.
  
                  This corresponds to the ``exclusion`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
                  Required. A non-empty list of fields to change in the
                  existing exclusion. New values for the fields are taken
                  from the corresponding fields in the
                  [LogExclusion][google.logging.v2.LogExclusion] included
                  in this request. Fields not mentioned in ``update_mask``
                  are not changed and are ignored in the request.
  
                  For example, to change the filter and description of an
                  exclusion, specify an ``update_mask`` of
                  ``"filter,description"``.
  
                  This corresponds to the ``update_mask`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              retry (google.api_core.retry.Retry): Designation of what errors, if any,
                  should be retried.
              timeout (float): The timeout for this request.
              metadata (Sequence[Tuple[str, str]]): Strings which should be
                  sent along with the request as metadata.
  
          Returns:
              google.cloud.logging_v2.types.LogExclusion:
                  Specifies a set of log entries that
                  are not to be stored in Logging. If your
                  GCP resource receives a large volume of
                  logs, you can use exclusions to reduce
                  your chargeable logs. Exclusions are
                  processed after log sinks, so you can
                  export log entries before they are
                  excluded. Note that organization-level
                  and folder-level exclusions don't apply
                  to child resources, and that you can't
                  exclude audit log entries.
  
          
docstring: r"""Changes one or more properties of an existing
  exclusion.
docstring_tokens: r " " " Changes one or more properties of an existing exclusion .
code: async def update_exclusion(self,
              request: Union[logging_config.UpdateExclusionRequest, dict] = None,
              *,
              name: str = None,
              exclusion: logging_config.LogExclusion = None,
              update_mask: field_mask_pb2.FieldMask = None,
              retry: OptionalRetry = gapic_v1.method.DEFAULT,
              timeout: float = None,
              metadata: Sequence[Tuple[str, str]] = (),
              ) -> logging_config.LogExclusion:
          r"""Changes one or more properties of an existing
          exclusion.
  
          Args:
              request (Union[google.cloud.logging_v2.types.UpdateExclusionRequest, dict]):
                  The request object. The parameters to `UpdateExclusion`.
              name (:class:`str`):
                  Required. The resource name of the exclusion to update:
  
                  ::
  
                      "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
                      "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
                      "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
                      "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
  
                  Example:
                  ``"projects/my-project-id/exclusions/my-exclusion-id"``.
  
                  This corresponds to the ``name`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              exclusion (:class:`google.cloud.logging_v2.types.LogExclusion`):
                  Required. New values for the existing exclusion. Only
                  the fields specified in ``update_mask`` are relevant.
  
                  This corresponds to the ``exclusion`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
                  Required. A non-empty list of fields to change in the
                  existing exclusion. New values for the fields are taken
                  from the corresponding fields in the
                  [LogExclusion][google.logging.v2.LogExclusion] included
                  in this request. Fields not mentioned in ``update_mask``
                  are not changed and are ignored in the request.
  
                  For example, to change the filter and description of an
                  exclusion, specify an ``update_mask`` of
                  ``"filter,description"``.
  
                  This corresponds to the ``update_mask`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              retry (google.api_core.retry.Retry): Designation of what errors, if any,
                  should be retried.
              timeout (float): The timeout for this request.
              metadata (Sequence[Tuple[str, str]]): Strings which should be
                  sent along with the request as metadata.
  
          Returns:
              google.cloud.logging_v2.types.LogExclusion:
                  Specifies a set of log entries that
                  are not to be stored in Logging. If your
                  GCP resource receives a large volume of
                  logs, you can use exclusions to reduce
                  your chargeable logs. Exclusions are
                  processed after log sinks, so you can
                  export log entries before they are
                  excluded. Note that organization-level
                  and folder-level exclusions don't apply
                  to child resources, and that you can't
                  exclude audit log entries.
  
          """
          # Create or coerce a protobuf request object.
          # Sanity check: If we got a request object, we should *not* have
          # gotten any keyword arguments that map to the request.
          has_flattened_params = any([name, exclusion, update_mask])
          if request is not None and has_flattened_params:
              raise ValueError("If the `request` argument is set, then none of "
                               "the individual field arguments should be set.")
  
          request = logging_config.UpdateExclusionRequest(request)
  
          # If we have keyword arguments corresponding to fields on the
          # request, apply these.
          if name is not None:
              request.name = name
          if exclusion is not None:
              request.exclusion = exclusion
          if update_mask is not None:
              request.update_mask = update_mask
  
          # Wrap the RPC method; this adds retry and timeout information,
          # and friendly error handling.
          rpc = gapic_v1.method_async.wrap_method(
              self._client._transport.update_exclusion,
              default_timeout=120.0,
              client_info=DEFAULT_CLIENT_INFO,
          )
  
          # Certain fields should be provided within the metadata header;
          # add these here.
          metadata = tuple(metadata) + (
              gapic_v1.routing_header.to_grpc_metadata((
                  ("name", request.name),
              )),
          )
  
          # Send the request.
          response = await rpc(
              request,
              retry=retry,
              timeout=timeout,
              metadata=metadata,
          )
  
          # Done; return the response.
          return response
code_tokens: async def update_exclusion ( self , request : Union [ logging_config . UpdateExclusionRequest , dict ] = None , * , name : str = None , exclusion : logging_config . LogExclusion = None , update_mask : field_mask_pb2 . FieldMask = None , retry : OptionalRetry = gapic_v1 . method . DEFAULT , timeout : float = None , metadata : Sequence [ Tuple [ str , str ] ] = ( ) , ) -> logging_config . LogExclusion : has_flattened_params = any ( [ name , exclusion , update_mask ] ) if request is not None and has_flattened_params : raise ValueError ( "If the `request` argument is set, then none of " "the individual field arguments should be set." ) request = logging_config . UpdateExclusionRequest ( request ) if name is not None : request . name = name if exclusion is not None : request . exclusion = exclusion if update_mask is not None : request . update_mask = update_mask rpc = gapic_v1 . method_async . wrap_method ( self . _client . _transport . update_exclusion , default_timeout = 120.0 , client_info = DEFAULT_CLIENT_INFO , ) metadata = tuple ( metadata ) + ( gapic_v1 . routing_header . to_grpc_metadata ( ( ( "name" , request . name ) , ) ) , ) response = await rpc ( request , retry = retry , timeout = timeout , metadata = metadata , ) return response
short_docstring: r"""Changes one or more properties of an existing
  exclusion.
short_docstring_tokens: r " " " Changes one or more properties of an existing exclusion .
comment: r"""Changes one or more properties of an existing
          exclusion.
  
          Args:
              request (Union[google.cloud.logging_v2.types.UpdateExclusionRequest, dict]):
                  The request object. The parameters to `UpdateExclusion`.
              name (:class:`str`):
                  Required. The resource name of the exclusion to update:
  
                  ::
  
                      "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]"
                      "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]"
                      "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]"
                      "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]"
  
                  Example:
                  ``"projects/my-project-id/exclusions/my-exclusion-id"``.
  
                  This corresponds to the ``name`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              exclusion (:class:`google.cloud.logging_v2.types.LogExclusion`):
                  Required. New values for the existing exclusion. Only
                  the fields specified in ``update_mask`` are relevant.
  
                  This corresponds to the ``exclusion`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
                  Required. A non-empty list of fields to change in the
                  existing exclusion. New values for the fields are taken
                  from the corresponding fields in the
                  [LogExclusion][google.logging.v2.LogExclusion] included
                  in this request. Fields not mentioned in ``update_mask``
                  are not changed and are ignored in the request.
  
                  For example, to change the filter and description of an
                  exclusion, specify an ``update_mask`` of
                  ``"filter,description"``.
  
                  This corresponds to the ``update_mask`` field
                  on the ``request`` instance; if ``request`` is provided, this
                  should not be set.
              retry (google.api_core.retry.Retry): Designation of what errors, if any,
                  should be retried.
              timeout (float): The timeout for this request.
              metadata (Sequence[Tuple[str, str]]): Strings which should be
                  sent along with the request as metadata.
  
          Returns:
              google.cloud.logging_v2.types.LogExclusion:
                  Specifies a set of log entries that
                  are not to be stored in Logging. If your
                  GCP resource receives a large volume of
                  logs, you can use exclusions to reduce
                  your chargeable logs. Exclusions are
                  processed after log sinks, so you can
                  export log entries before they are
                  excluded. Note that organization-level
                  and folder-level exclusions don't apply
                  to child resources, and that you can't
                  exclude audit log entries.
  
          """$SEP$# Create or coerce a protobuf request object.$SEP$# Sanity check: If we got a request object, we should *not* have$SEP$# gotten any keyword arguments that map to the request.$SEP$# If we have keyword arguments corresponding to fields on the$SEP$# request, apply these.$SEP$# Wrap the RPC method; this adds retry and timeout information,$SEP$# and friendly error handling.$SEP$# Certain fields should be provided within the metadata header;$SEP$# add these here.$SEP$# Send the request.$SEP$# Done; return the response.