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 theValue
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': { '...': '...', }, }