tag_resource

Organizations.Client.tag_resource(**kwargs)

Adds one or more tags to the specified resource.

Currently, you can attach tags to the following resources in Organizations.

• Amazon Web Services account
• Organization root
• Organizational unit (OU)
• Policy (any type)

This operation can be called only from the organization's management account.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    ResourceId='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)

Parameters

• ResourceId (string) --

  [REQUIRED]

  The ID of the resource to add a tag to.

  You can specify any of the following taggable resources.

  • Amazon Web Services account – specify the account ID number.
  • Organizational unit – specify the OU ID that begins with ou- and looks similar to: ou-1a2b-34uvwxyz
  • Root – specify the root ID that begins with r- and looks similar to: r-1a2b
  • Policy – specify the policy ID that begins with p- andlooks similar to: p-12abcdefg3
• Tags (list) --

  [REQUIRED]

  A list of tags to add to the specified resource.

  For each tag in the list, you must specify both a tag key and a value. The value can be an empty string, but you can't set it to null .

  Note

  If any one of the tags is not valid or if you exceed the maximum allowed number of tags for a resource, then the entire request fails.

  • (dict) --

    A custom key-value pair associated with a resource within your organization.

    You can attach tags to any of the following organization resources.

    • Amazon Web Services account
    • Organizational unit (OU)
    • Organization root
    • Policy
    • Key (string) -- [REQUIRED]

      The key identifier, or name, of the tag.

    • Value (string) -- [REQUIRED]

      The string value that's associated with the key of the tag. You can set the value of a tag to an empty string, but you can't set the value of a tag to null.

Returns

None

Exceptions

• Organizations.Client.exceptions.AccessDeniedException
• Organizations.Client.exceptions.ConcurrentModificationException
• Organizations.Client.exceptions.AWSOrganizationsNotInUseException
• Organizations.Client.exceptions.TargetNotFoundException
• Organizations.Client.exceptions.ConstraintViolationException
• Organizations.Client.exceptions.InvalidInputException
• Organizations.Client.exceptions.ServiceException
• Organizations.Client.exceptions.TooManyRequestsException