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

euca2ools 3.3                                      March 2016                                EUARE-ASSUMEROLE(1)