NAME

SYNOPSIS

eclat mktag --help

DESCRIPTION

The resources to create the tags for are supplied with one of the options. At least one resource designation must be present.

If ID mapping is enabled (see the section MAPS in eclat(1)), all options except -r (--resource-id) translate their arguments using corresponding maps (see OPTIONS below). The -r (--resource-id) option uses no map by default, unless the map name is specified explicitly before the ID.

OPTIONS

-a, --ami ID

Creates tags for the given image. In resource translation mode, uses the map ImageId.

-i, --instance ID

Creates tags for the given instance. In resource translation mode, uses the map InstanceId.

-r, --resource-id [MAP:]ID

Creates tags for the EC2 resource identified by ID. If optional MAP prefix is supplied and resource translation mode is enabled, this option will use the MAP to translate ID into AWS resource identifier.

-s, --snapshot ID

Creates tags for the given snapshot. In resource translation mode, uses the map SnapshotId.

-T, --from-file FILE

Reads tags from FILE or from the standard input, if FILE is -. Empty lines and lines beginning with # are ignored. Non-empty lines must contain either a tag name alone, or a tag name and the corresponding value, separated by an equals sign. If the value is enclosed in double quotes, these will be removed and any escaped characters within the value translated to their corresponding equivalents using shell rules (e.g. \" becomes ", etc). See example 2 below.

-v, --volume ID

Creates tags for the given volume. In resource translation mode, uses the map VolumeId.

OUTPUT

EXAMPLE

1.

Create two tags for an instance:

eclat mktag -i i-12345678 Name=Webserver test

    

This command creates two tags for instance i-12345678: the tag Name with the value Webserver and tag test with empty value.

2.

Copy tags between instances:

eclat -e 'if (.DescribeTagsResponse)
            for (var in .DescribeTagsResponse.tagSet.item)
              print(var.key,"=",var.value,"\n");' \
      lstag resource-id=i-12345678 |
 eclat mktag -i i-fe2345ed -T -

    

This example uses the lstag command to obtain tags from the instance i-12345678 and a custom format to represent them in a form suitable as input to mktag. The obtained data are piped to the mktag command which is instructed to read them from the standard input using -T -.

SEE ALSO

AUTHORS

BUG REPORTS

COPYRIGHT