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