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:

the role to assume

optional arguments:

number of seconds the credentials should be valid for (900-3600) (default: 900)
role session identifier to include in the assumed role user ID (default: automatic)
generate C-shell commands on stdout (default if SHELL looks like a csh-style shell
generate Bourne shell commands on stdout (default if SHELL does not look like a csh-style shell
an IAM policy further restricting what the credentials will be allowed to do. This cannot grant additional permissions.
file containing an IAM policy further restricting what the credentials will be allowed to do. This cannot grant additional permissions.
external ID to use for comparison with policies
MFA token serial number
MFA token code
token service endpoint URL
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

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