Skip to content

untag_resource

untag_resource(
    resource_arn: AmazonResourceName,
    tag_keys: TagKeyList,
    *,
    config_overrides: Optional[TextractClientConfig] = None,
) -> UntagResourceResponse

Removes any tags with the specified keys from the specified resource.

Parameters:

  • resource_arn (AmazonResourceName) –

    The Amazon Resource Name (ARN) that specifies the resource to be untagged.

  • tag_keys (TagKeyList) –

    Specifies the tags to be removed from the resource specified by the ResourceARN.

Raises:

  • AccessDeniedException –

    You aren't authorized to perform the action. Use the Amazon Resource Name (ARN) of an authorized user or IAM role to perform the operation.

  • InternalServerError –

    Amazon Textract experienced a service issue. Try your call again.

  • InvalidParameterException –

    An input parameter violated a constraint. For example, in synchronous operations, an InvalidParameterException exception occurs when neither of the S3Object or Bytes values are supplied in the Document request parameter. Validate your parameter before calling the API operation again.

  • ProvisionedThroughputExceededException –

    The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Textract.

  • ResourceNotFoundException –

    Returned when an operation tried to access a nonexistent resource.

  • ThrottlingException –

    Amazon Textract is temporarily unable to process the request. Try your call again.

  • ValidationException –

    Indicates that a request was not valid. Check request for proper formatting.

  • UnknownServiceError –

    The service returned an error code this client does not model.

Source code in docs_src/capo_textract/_services/textract.py
def untag_resource(
    self,
    resource_arn: "capo_textract.types.amazon_resource_name.AmazonResourceName",
    tag_keys: "capo_textract.types.tag_key_list.TagKeyList",
    *,
    config_overrides: Optional[TextractClientConfig] = None,
) -> "capo_textract.types.untag_resource_response.UntagResourceResponse":
    """<p>Removes any tags with the specified keys from the specified resource.</p>

    Args:
        resource_arn: <p>The Amazon Resource Name (ARN) that specifies the resource to be untagged.</p>
        tag_keys: <p>Specifies the tags to be removed from the resource specified by the ResourceARN.</p>

    Raises:
        capo_textract.errors.access_denied_exception.AccessDeniedException: <p>You aren't authorized to perform the action. Use the Amazon Resource Name (ARN) of an authorized user or IAM role to perform the operation.</p>
        capo_textract.errors.internal_server_error.InternalServerError: <p>Amazon Textract experienced a service issue. Try your call again.</p>
        capo_textract.errors.invalid_parameter_exception.InvalidParameterException: <p>An input parameter violated a constraint. For example, in synchronous operations, an <code>InvalidParameterException</code> exception occurs when neither of the <code>S3Object</code> or <code>Bytes</code> values are supplied in the <code>Document</code> request parameter. Validate your parameter before calling the API operation again.</p>
        capo_textract.errors.provisioned_throughput_exceeded_exception.ProvisionedThroughputExceededException: <p>The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Textract.</p>
        capo_textract.errors.resource_not_found_exception.ResourceNotFoundException: <p> Returned when an operation tried to access a nonexistent resource. </p>
        capo_textract.errors.throttling_exception.ThrottlingException: <p>Amazon Textract is temporarily unable to process the request. Try your call again.</p>
        capo_textract.errors.validation_exception.ValidationException: <p> Indicates that a request was not valid. Check request for proper formatting. </p>
        capo_textract.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_textract.types.untag_resource_request.UntagResourceRequest]",
    ) -> OperationResponse[
        "capo_textract.types.untag_resource_response.UntagResourceResponse"
    ]:
        import capo_textract._operations.textract.untag_resource

        output, http_response = (
            capo_textract._operations.textract.untag_resource.untag_resource(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("UntagResource")
    )
    input_: capo_textract.types.untag_resource_request.UntagResourceRequest = {
        "resource_arn": resource_arn,
        "tag_keys": tag_keys,
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output