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

FreeBSD Manual Pages

  
 
  

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

NAME
       eclat-mktag, eclat-create-tags -	create or replace tags for a resource

SYNOPSIS
       eclat mktag [-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] [ID]... TAG[=VAL]...

       eclat mktag --help

DESCRIPTION
       This  command creates or	replaces one or	more tags for given resources.
       Tags are	specified by their names.  If a	tag name  is  followed	by  an
       equals  sign,  the  characters  following  that sign are	stored in this
       tag's value.  Otherwise an empty	value is assigned to it.

       The resources to	create the tags	for are	supplied with one of  the  op-
       tions.  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
	      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 cor-
	      responding  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
       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
       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 in-
	      stance 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
       eclat(1), eclat-rmtag(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-MKTAG(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-mktag&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help