tag_resource

RAM.Client.tag_resource(**kwargs)

Adds the specified tag keys and values to the specified resource share. The tags are attached only to the resource share, not to the resources that are in the resource share.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    resourceShareArn='string',
    tags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ]
)
Parameters
  • resourceShareArn (string) --

    [REQUIRED]

    Specifies the Amazon Resoure Name (ARN) of the resource share that you want to add tags to.

  • tags (list) --

    [REQUIRED]

    A list of one or more tag key and value pairs. The tag key must be present and not be an empty string. The tag value must be present but can be an empty string.

    • (dict) --

      A structure containing a tag. A tag is metadata that you can attach to your resources to help organize and categorize them. You can also use them to help you secure your resources. For more information, see Controlling access to Amazon Web Services resources using tags.

      For more information about tags, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide .

      • key (string) --

        The key, or name, attached to the tag. Every tag must have a key. Key names are case sensitive.

      • value (string) --

        The string value attached to the tag. The value can be an empty string. Key values are case sensitive.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

  • RAM.Client.exceptions.InvalidParameterException
  • RAM.Client.exceptions.MalformedArnException
  • RAM.Client.exceptions.UnknownResourceException
  • RAM.Client.exceptions.TagLimitExceededException
  • RAM.Client.exceptions.ResourceArnNotFoundException
  • RAM.Client.exceptions.TagPolicyViolationException
  • RAM.Client.exceptions.ServerInternalException
  • RAM.Client.exceptions.ServiceUnavailableException