Scroll to navigation

EUARE-ASSUMEROLE(1) User Commands EUARE-ASSUMEROLE(1)

NAME

euare-assumerole - Assume an IAM role

SYNOPSIS

euare-assumerole [-d SECONDS] [--session-name PATH] [-c | -s]
[--policy-content POLICY_CONTENT | --policy-document 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

DESCRIPTION

Assume an IAM role

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:

DESCRIPTION

$ eval `euare-assumerole myrole`

DESCRIPTION

To stop using the role, use euare-releaserole(1).

positional arguments:

ROLE
the role to assume

optional arguments:

-d SECONDS, --duration SECONDS
number of seconds the credentials should be valid for (900-3600) (default: 900)
--session-name PATH
role session identifier to include in the assumed role user ID (default: automatic)
-c
generate C-shell commands on stdout (default if SHELL looks like a csh-style shell
-s
generate Bourne shell commands on stdout (default if SHELL does not look like a csh-style shell
--policy-content POLICY_CONTENT
an IAM policy further restricting what the credentials will be allowed to do. This cannot grant additional permissions.
--policy-document FILE
file containing an IAM policy further restricting what the credentials will be allowed to do. This cannot grant additional permissions.
--external-id STR
external ID to use for comparison with policies
--mfa-serial MFA
MFA token serial number
--mfa-code CODE
MFA token code
-U URL, --url URL
token service endpoint URL
--region USER@REGION
region and/or user names to search when looking up config file data

-I KEY_ID, --access-key-id KEY_ID

-S KEY, --secret-key KEY

--security-token TOKEN

--debug
show debugging output
--debugger
launch interactive debugger on error
--version
show the program's version and exit
-h, --help
show this help message and exit
March 2016 euca2ools 3.3