Skip to content

tag_resource 

tag_resource(
    resource_arn: ResourceArn,
    resource_tags: ResourceTagList,
    *,
    config_overrides: Optional[BillingClientConfig] = None,
) -> TagResourceResponse

An API operation for adding one or more tags (key-value pairs) to a resource.

Parameters:

  • resource_arn (ResourceArn) –

    The Amazon Resource Name (ARN) of the resource.

  • resource_tags (ResourceTagList) –

    A list of tag key value pairs that are associated with the resource.

Raises:

Examples:

Invoke TagResource

>>> client.tag_resource(resource_arn='arn:aws:billing::123456789101:billingview/custom-46f47cb2-a11d-43f3-983d-470b5708a899', resource_tags=[{'key': 'ExampleTagKey', 'value': 'ExampleTagValue'}])
Source code in docs_src/capo_billing/_services/billing.py 
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
def tag_resource(
    self,
    resource_arn: "capo_billing.types.resource_arn.ResourceArn",
    resource_tags: "capo_billing.types.resource_tag_list.ResourceTagList",
    *,
    config_overrides: Optional[BillingClientConfig] = None,
) -> "capo_billing.types.tag_resource_response.TagResourceResponse":
    """<p> An API operation for adding one or more tags (key-value pairs) to a resource. </p>

    Args:
        resource_arn: <p> The Amazon Resource Name (ARN) of the resource. </p>
        resource_tags: <p> A list of tag key value pairs that are associated with the resource. </p>

    Raises:
        capo_billing.errors.access_denied_exception.AccessDeniedException: <p>You don't have sufficient access to perform this action.</p>
        capo_billing.errors.internal_server_exception.InternalServerException: <p>The request processing failed because of an unknown error, exception, or failure. </p>
        capo_billing.errors.resource_not_found_exception.ResourceNotFoundException: <p> The specified ARN in the request doesn't exist. </p>
        capo_billing.errors.throttling_exception.ThrottlingException: <p>The request was denied due to request throttling. </p>
        capo_billing.errors.validation_exception.ValidationException: <p>The input fails to satisfy the constraints specified by an Amazon Web Services service. </p>
        capo_billing.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        Invoke TagResource

        >>> client.tag_resource(resource_arn='arn:aws:billing::123456789101:billingview/custom-46f47cb2-a11d-43f3-983d-470b5708a899', resource_tags=[{'key': 'ExampleTagKey', 'value': 'ExampleTagValue'}])
    """

    def _handler(
        req: "OperationRequest[capo_billing.types.tag_resource_request.TagResourceRequest]",
    ) -> OperationResponse[
        "capo_billing.types.tag_resource_response.TagResourceResponse"
    ]:
        import capo_billing._operations.aws_billing.tag_resource

        output, http_response = (
            capo_billing._operations.aws_billing.tag_resource.tag_resource(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("TagResource")
    )
    input_: capo_billing.types.tag_resource_request.TagResourceRequest = {
        "resource_arn": resource_arn,
        "resource_tags": resource_tags,
    }

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