AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to ChangeTagsForResourceAsync.

Namespace: Amazon.Route53
Assembly: AWSSDK.Route53.dll
Version: 3.x.y.z

Syntax

C#
public virtual ChangeTagsForResourceResponse ChangeTagsForResource(
         ChangeTagsForResourceRequest request
)

Parameters

request
Type: Amazon.Route53.Model.ChangeTagsForResourceRequest

Container for the necessary parameters to execute the ChangeTagsForResource service method.

Return Value


The response from the ChangeTagsForResource service method, as returned by Route53.

Exceptions

ExceptionCondition
InvalidInputException The input is not valid.
NoSuchHealthCheckException No health check exists with the specified ID.
NoSuchHostedZoneException No hosted zone exists with the ID that you specified.
PriorRequestNotCompleteException If Amazon Route 53 can't process a request before the next request arrives, it will reject subsequent requests for the same hosted zone and return an HTTP 400 error (Bad request). If Route 53 returns this error repeatedly for the same request, we recommend that you wait, in intervals of increasing duration, before you try the request again.
ThrottlingException The limit on the number of requests per second was exceeded.

Examples

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

To add or remove tags from a hosted zone or health check


var client = new AmazonRoute53Client();
var response = client.ChangeTagsForResource(new ChangeTagsForResourceRequest 
{
    AddTags = new List<Tag> {
        new Tag {
            Key = "apex",
            Value = "3874"
        },
        new Tag {
            Key = "acme",
            Value = "4938"
        }
    },
    RemoveTagKeys = new List<string> {
        "Nadir"
    },
    ResourceId = "Z3M3LMPEXAMPLE",
    ResourceType = "hostedzone" // Valid values are healthcheck and hostedzone.
});


            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also