.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
.TH EUARE-ASSUMEROLE "1" "March 2016" "euca2ools 3.3" "User Commands"
.SH NAME
euare-assumerole \- Assume an IAM role
.SH SYNOPSIS
euare\-assumerole [\-d SECONDS] [\-\-session\-name PATH] [\-c | \fB\-s]\fR
.TP
[\-\-policy\-content POLICY_CONTENT | \fB\-\-policy\-document\fR FILE]
[\-\-external\-id STR] [\-\-mfa\-serial MFA]
[\-\-mfa\-code CODE] [\-U URL] [\-\-region USER@REGION]
[\-I KEY_ID] [\-S KEY] [\-\-security\-token TOKEN]
[\-\-debug] [\-\-debugger] [\-\-version] [\-h]
ROLE
.SH DESCRIPTION
Assume an IAM role
.SH DESCRIPTION
The euare\-assumerole utility obtains credentials for an IAM role and outputs
them in the form of shellcode that sets environment variables that
allow euca2ools commands to use them.  Use it inside an eval command
to make this process seamless:
.SH DESCRIPTION
$ eval `euare\-assumerole myrole`
.SH DESCRIPTION
To stop using the role, use euare\-releaserole(1).
.SS "positional arguments:"
.TP
ROLE
the role to assume
.SS "optional arguments:"
.TP
\fB\-d\fR SECONDS, \fB\-\-duration\fR SECONDS
number of seconds the credentials should be valid for
(900\-3600) (default: 900)
.TP
\fB\-\-session\-name\fR PATH
role session identifier to include in the assumed role
user ID (default: automatic)
.TP
\fB\-c\fR
generate C\-shell commands on stdout (default if SHELL
looks like a csh\-style shell
.TP
\fB\-s\fR
generate Bourne shell commands on stdout (default if
SHELL does not look like a csh\-style shell
.TP
\fB\-\-policy\-content\fR POLICY_CONTENT
an IAM policy further restricting what the credentials
will be allowed to do. This cannot grant additional
permissions.
.TP
\fB\-\-policy\-document\fR FILE
file containing an IAM policy further restricting what
the credentials will be allowed to do. This cannot
grant additional permissions.
.TP
\fB\-\-external\-id\fR STR
external ID to use for comparison with policies
.TP
\fB\-\-mfa\-serial\fR MFA
MFA token serial number
.TP
\fB\-\-mfa\-code\fR CODE
MFA token code
.TP
\fB\-U\fR URL, \fB\-\-url\fR URL
token service endpoint URL
.TP
\fB\-\-region\fR USER@REGION
region and/or user names to search when looking up
config file data
.HP
\fB\-I\fR KEY_ID, \fB\-\-access\-key\-id\fR KEY_ID
.HP
\fB\-S\fR KEY, \fB\-\-secret\-key\fR KEY
.HP
\fB\-\-security\-token\fR TOKEN
.TP
\fB\-\-debug\fR
show debugging output
.TP
\fB\-\-debugger\fR
launch interactive debugger on error
.TP
\fB\-\-version\fR
show the program's version and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit