Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ECLAT-RMTAG(1)		     Eclat User	Reference		ECLAT-RMTAG(1)

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  op-
       tions  except -r	(--resource-id)	translate their	arguments using	corre-
       sponding	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 option-
	      al  MAP  prefix is supplied and resource translation mode	is en-
	      abled, this option will use the MAP to translate ID into AWS re-
	      source 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 cor-
	      responding  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 (C) 2012-2015 Sergey Poznyakoff
       License GPLv3+: GNU GPL version 3 or later <http://gnu.org/li-
       censes/gpl.html>
       This  is	 free  software:  you  are free	to change and redistribute it.
       There is	NO WARRANTY, to	the extent permitted by	law.

ECLAT			       January 26, 2015			ECLAT-RMTAG(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OUTPUT | EXAMPLE | SEE ALSO | AUTHORS | BUG REPORTS | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=eclat-rmtag&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help