| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ec2-create-tags
Description
Adds or overwrites one or more tags for the specified resource or resources. Each resource can have a maximum of 10 tags. Each tag consists of a key and optional value. Tag keys must be unique per resource.
For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.
The short version of this command is ec2addtag.
Syntax
ec2-create-tags
resource_id [resource_id
...] --tag key[=value]
[--tag key[=value] ...]
Options
| Name | Description |
|---|---|
|
|
The AWS-assigned ID of the resource you want to tag. You can specify multiple resources to assign the tags to. Type: String Default: None Required: Yes Example: ami-1a2b3c4d |
|
|
The key and optional value of the tag, separated by an equals sign (=). If you don't include a value, we set the value to an empty string. If you're using the command line tools on a Windows system, you might need to use quotation marks (for example, "key=value"). Type: String Default: None Constraints: Maximum tag key length is 128 characters. Maximum tag value length is 256 characters. Tag keys and values are case sensitive and accept Unicode characters. Required: Yes Example: --tag "stack=Production" |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the region specified by the Default: The value of the Example: |
|
|
The uniform resource locator (URL) of the Amazon EC2 web service entry point. Default: The value of the Example: |
|
|
The private key that identifies you to Amazon EC2. For more information, see Tell the Tools Who You Are. Default: The value of the Example: |
|
|
The X.509 certificate that identifies you to Amazon EC2. Default: The value of the Example: |
|
|
The access key ID associated with your AWS account. For more information, see Tell the Tools Who You Are. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The secret access key associated with your AWS account. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The AWS delegation token. Default: The value of the environment variable (if set). |
|
|
The connection timeout, in seconds. Example: |
|
|
The request timeout, in seconds. Example: |
|
|
Displays verbose output, including the API request and response on the command line. This is useful if you are building tools to talk directly to our Query API. |
|
|
Includes column headers in the command output. |
|
|
Shows empty columns as |
|
|
Omits tags for tagged resources. |
|
|
Displays internal debugging information. This can assist us when helping you troubleshooting problems. |
|
|
Displays usage information for the command. |
|
|
Reads arguments from standard input. This is useful when piping the output from one command to the input of another. Example: |
Deprecated Options
For a limited time, you can still use the private key and X.509 certificate instead of your access key ID and secret access key. However, we recommend that you start using your access key ID (-O, --aws-access-key) and secret access key (-W, --aws-secret-key) now, as the private key (-K, --private-key) and X.509 certificate (-C, --cert) won't be supported after the transition period elapses. For more information, see Tell the Tools Who You Are.
| Option | Description |
|---|---|
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
Output
This command returns a table that contains the following information:
The TAG identifier
The resource type identifier
The resource ID
The tag key
The tag value
Amazon EC2 command line tools display errors on stderr.
Examples
Example Request
This example adds (or overwrites) two tags for an AMI and an instance. One of the tags is just a key (webserver), with no value. The other consists of a key (stack) and value (Production). We set the value of the webserver tag to an empty string.
PROMPT> ec2-create-tags ami-1a2b3c4d i-7d3e5a2f --tag webserver --tag "stack=Production"
TAG image ami-1a2b3c4d webserver
TAG image ami-1a2b3c4d stack Production
TAG instance i-7d3e5a2f webserver
TAG instance i-7d3e5a2f stack Production
