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 AWS Billing and Cost Management User Guide.

Note:

For PCL 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 abstract 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 ID that you specified in the DeleteHealthCheck request.
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 Amazon 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 response = client.ChangeTagsForResource(new ChangeTagsForResourceRequest 
{
    AddTags = new List {
        new Tag {
            Key = "apex",
            Value = "3874"
        },
        new Tag {
            Key = "acme",
            Value = "4938"
        }
    },
    RemoveTagKeys = new List {
        "Nadir"
    },
    ResourceId = "Z3M3LMPEXAMPLE",
    ResourceType = "hostedzone" // Valid values are healthcheck and hostedzone.
});


            

Version Information

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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also