[ aws . route53 ]

change-tags-for-resource

Description

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 .

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  change-tags-for-resource
--resource-type <value>
--resource-id <value>
[--add-tags <value>]
[--remove-tag-keys <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--resource-type (string)

The type of the resource.

• The resource type for health checks is healthcheck .

• The resource type for hosted zones is hostedzone .

Possible values:

• healthcheck

• hostedzone

--resource-id (string)

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

--add-tags (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.

(structure)

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.

Shorthand Syntax:

Key=string,Value=string ...

JSON Syntax:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--remove-tag-keys (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)

Syntax:

"string" "string" ...

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Examples

The following command adds a tag named owner to a healthcheck resource specified by ID:

aws route53 change-tags-for-resource --resource-type healthcheck --resource-id 6233434j-18c1-34433-ba8e-3443434 --add-tags Key=owner,Value=myboss

The following command removes a tag named owner from a hosted zone resource specified by ID:

aws route53 change-tags-for-resource --resource-type hostedzone --resource-id Z1523434445 --remove-tag-keys owner

Output

None