.\" This file is part of Eclat -*- nroff -*-
.\" Copyright (C) 2012-2018 Sergey Poznyakoff
.\"
.\" Eclat is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 3, or (at your option)
.\" any later version.
.\"
.\" Eclat is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with Eclat.  If not, see <http://www.gnu.org/licenses/>.
.TH ECLAT-SETAATTR 1 "January 26, 2015" "ECLAT" "Eclat User Reference"
.SH NAME
eclat-setaattr, eclat-modify-image-attribute \- modify attributes of an image
.SH SYNOPSIS
.nh
.na
\fBeclat setaattr\fB \fIAMI\-ID\fR \fBdescription\fR \fIVALUE\fR
.PP
\fBeclat setaattr\fB \fIAMI\-ID\fR \fBProductCode\fR \fICODE\fR [\fICODE\fR...]
.PP
\fBeclat setaattr\fB \fIAMI\-ID\fR \fBLaunchPermission\fR\
 [\fIOPTION\fR] \fIVALUE\fR [[\fIOPTION\fR] \fIVALUE\fR...]
.PP
\fBeclat setaattr\fB \fIAMI\-ID\fR \fBLaunchPermission\fR\
 {\fB\-a\fR|\fB\-d\fR}\
 {\fB\-\-add\fR|\fB\-\-delete\fR} {\fB\-\-group\-name\fR|\fB\-\-user\-id\fR}\
 \fIVALUE\fR
.ad
.hy
.SH DESCRIPTION
Set or remove attributes of an AWS image.
.PP
Only three attributes can be modified:
.BR description ,
.BR ProductCode ", and"
.BR LaunchPermission .
All three names are case-insensitive.
.PP
Setting the description requires a single value (see the first form in
the synopsis).
.PP
The \fBProductCode\fR attribute can be assigned multiple values in the
single invocation (second form in the synopsis).  Note, that this
operation is irreversible: after a product code is added to an AMI, it
can't be removed.
.PP
The third form adds or removes AWS accounts to the
\fBLaunchPermission\fR list.  It allows for the following options:
.TP
.BR \-a ", " \-\-add
Add the accounts that follow this option.
.TP
.BR \-d ", " \-\-delete
Delete the accounts that follow this option.
.PP
This two options invert each other's effect.  The default action is
\fB\-\-add\fR, so the use of the \fB\-\-add\fR option is optional if
it is the only option in the command line.
.TP
.BR \-g ", " \-\-group\-name
Treat the arguments that follow as group names, instead of the account
numbers.  According to the AWS documentation, the only valid value
that can be used with this option is \fBall\fR, which means all Amazon
EC2 users.
.TP
.BR \-u ", " \-\-user\-id
Treat the arguments that follow as user (account) IDs.  This is the
default.  This option is intended to be used after
\fB\-\-group\-name\fR to cancel its effect.
.SH EXAMPLE
.nr step 1 1
.IP \n[step].
Add a description :
.PP
.EX
.B eclat setaattr ami-abcde012 description "Database server"
.EE
.IP \n+[step].
Allow account \fB123456701234\fR to launch instances from
\fBami-abcde012\fR, and revoke that permission from the rest of EC2 users.
.PP
.EX
.B eclat setaattr ami-abcde012 LaunchPermission --add 123456701234 \\\\
.B       --del --group all
.EE
.SH "SEE ALSO"
.BR eclat (1),
.BR eclat\-lsaattr (1).
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <bug\-eclat@gnu.org.ua>.
.SH COPYRIGHT
Copyright \(co 2012-2015 Sergey Poznyakoff
.br
.na
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
.ad
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.\" Local variables:
.\" eval: (add-hook 'write-file-hooks 'time-stamp)
.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
.\" time-stamp-format: "%:B %:d, %:y"
.\" time-stamp-end: "\""
.\" time-stamp-line-limit: 20
.\" end: