NAME

eclat-rmtag, eclat-delete-tags - delete or replace tags for a resource

SYNOPSIS

eclat rmtag [-a ID] [-i ID] [-r [MAP:]ID] [-s ID] [-v ID] [-T FILE] [--ami ID] [--instance ID] [--resource-id [MAP:]ID] [--volume ID] [--snapshot ID] [--from-file FILE] [TAG[=VAL]...]

eclat rmtag --help

DESCRIPTION

This command deletes tags from given resources. The names of tags to delete are supplied in the command line. If a tag name is followed by an equals sign and a value, it will be deleted only if both its name and value are the same as the supplied ones. Otherwise, the tag will be deleted regardless of its value.

If no tag names are given, all tags are deleted.

The resources to delete tags from 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

Deletes tags from the given image. In resource translation mode, uses the map ImageId.

-i, --instance ID

Deletes tags from the given instance. In resource translation mode, uses the map InstanceId.

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

Deletes tags from 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.

-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).

-v, --volume ID

Deletes tags from the given volume. In resource translation mode, uses the map VolumeId.

OUTPUT

By default the command does not output anything, unless an error occurs in which case the error diagnostics is printed on the standard error.

EXAMPLE

eclat rmtag -i i-12345678 Name=Webserver test

This command deletes two tags from the instance i-12345678: the tag Name, if it has the value Webserver and tag test, no matter what its value is.

SEE ALSO

eclat(1), eclat-mktag(1), eclat-lstag(1).

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT

Copyright © 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.