Skip to content

tag_resource 

tag_resource(
    resource_arn: Arn,
    tags: TagMap,
    *,
    config_overrides: Optional[ControlTowerClientConfig] = None,
) -> TagResourceOutput

Applies tags to a resource. For usage examples, see the Controls Reference Guide .

Parameters:

  • resource_arn (Arn) –

    The ARN of the resource to be tagged.

  • tags (TagMap) –

    Tags to be applied to the resource.

Raises:

Source code in docs_src/capo_controltower/_services/control_tower.py 
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
def tag_resource(
    self,
    resource_arn: "capo_controltower.types.arn.Arn",
    tags: "capo_controltower.types.tag_map.TagMap",
    *,
    config_overrides: Optional[ControlTowerClientConfig] = None,
) -> "capo_controltower.types.tag_resource_output.TagResourceOutput":
    """<p>Applies tags to a resource. For usage examples, see the <a href="https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html"> <i>Controls Reference Guide</i> </a>.</p>

    Args:
        resource_arn: <p>The ARN of the resource to be tagged.</p>
        tags: <p>Tags to be applied to the resource.</p>

    Raises:
        capo_controltower.errors.internal_server_exception.InternalServerException: <p>An unexpected error occurred during processing of a request.</p>
        capo_controltower.errors.resource_not_found_exception.ResourceNotFoundException: <p>The request references a resource that does not exist.</p>
        capo_controltower.errors.validation_exception.ValidationException: <p>The input does not satisfy the constraints specified by an Amazon Web Services service.</p>
        capo_controltower.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_controltower.types.tag_resource_input.TagResourceInput]",
    ) -> OperationResponse[
        "capo_controltower.types.tag_resource_output.TagResourceOutput"
    ]:
        import capo_controltower._operations.aws_control_tower_apis.tag_resource

        output, http_response = (
            capo_controltower._operations.aws_control_tower_apis.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_controltower.types.tag_resource_input.TagResourceInput = {
        "resource_arn": resource_arn,
        "tags": tags,
    }

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