Route53 / Client / change_tags_for_resource

change_tags_for_resource#

Route53.Client.change_tags_for_resource(**kwargs)#

Adds, edits, or deletes tags for a health check or a hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost Management User Guide.

See also: AWS API Documentation

Request Syntax

response = client.change_tags_for_resource(
    ResourceType='healthcheck'|'hostedzone',
    ResourceId='string',
    AddTags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    RemoveTagKeys=[
        'string',
    ]
)
Parameters:
  • ResourceType (string) –

    [REQUIRED]

    The type of the resource.

    • The resource type for health checks is healthcheck.

    • The resource type for hosted zones is hostedzone.

  • ResourceId (string) –

    [REQUIRED]

    The ID of the resource for which you want to add, change, or delete tags.

  • AddTags (list) –

    A complex type that contains a list of the tags that you want to add to the specified health check or hosted zone and/or the tags that you want to edit Value for.

    You can add a maximum of 10 tags to a health check or a hosted zone.

    • (dict) –

      A complex type that contains information about a tag that you want to add or edit for the specified health check or hosted zone.

      • Key (string) –

        The value of Key depends on the operation that you want to perform:

        • Add a tag to a health check or hosted zone: Key is the name that you want to give the new tag.

        • Edit a tag: Key is the name of the tag that you want to change the Value for.

        • Delete a key: Key is the name of the tag you want to remove.

        • Give a name to a health check: Edit the default Name tag. In the Amazon Route 53 console, the list of your health checks includes a Name column that lets you see the name that you’ve given to each health check.

      • Value (string) –

        The value of Value depends on the operation that you want to perform:

        • Add a tag to a health check or hosted zone: Value is the value that you want to give the new tag.

        • Edit a tag: Value is the new value that you want to assign the tag.

  • RemoveTagKeys (list) –

    A complex type that contains a list of the tags that you want to delete from the specified health check or hosted zone. You can specify up to 10 keys.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

    Empty response for the request.

Exceptions

  • Route53.Client.exceptions.InvalidInput

  • Route53.Client.exceptions.NoSuchHealthCheck

  • Route53.Client.exceptions.NoSuchHostedZone

  • Route53.Client.exceptions.PriorRequestNotComplete

  • Route53.Client.exceptions.ThrottlingException

Examples

The following example adds two tags and removes one tag from the hosted zone with ID Z3M3LMPEXAMPLE.

response = client.change_tags_for_resource(
    AddTags=[
        {
            'Key': 'apex',
            'Value': '3874',
        },
        {
            'Key': 'acme',
            'Value': '4938',
        },
    ],
    RemoveTagKeys=[
        'Nadir',
    ],
    ResourceId='Z3M3LMPEXAMPLE',
    # Valid values are healthcheck and hostedzone.
    ResourceType='hostedzone',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}