1EUARE-ASSUMEROLE(1)              User Commands             EUARE-ASSUMEROLE(1)
2
3
4

NAME

6       euare-assumerole - Assume an IAM role
7

SYNOPSIS

9       euare-assumerole [-d SECONDS] [--session-name PATH] [-c | -s]
10
11       [--policy-content POLICY_CONTENT | --policy-document FILE]
12              [--external-id  STR]  [--mfa-serial  MFA]  [--mfa-code CODE] [-U
13              URL]  [--region  USER@REGION]  [-I  KEY_ID]  [-S  KEY]  [--secu‐
14              rity-token TOKEN] [--debug] [--debugger] [--version] [-h] ROLE
15

DESCRIPTION

17       Assume an IAM role
18

DESCRIPTION

20       The  euare-assumerole  utility  obtains credentials for an IAM role and
21       outputs them in the form of shellcode that sets  environment  variables
22       that  allow euca2ools commands to use them.  Use it inside an eval com‐
23       mand to make this process seamless:
24

DESCRIPTION

26       $ eval `euare-assumerole myrole`
27

DESCRIPTION

29       To stop using the role, use euare-releaserole(1).
30
31   positional arguments:
32       ROLE   the role to assume
33
34   optional arguments:
35       -d SECONDS, --duration SECONDS
36              number of seconds the credentials should be valid for (900-3600)
37              (default: 900)
38
39       --session-name PATH
40              role  session  identifier to include in the assumed role user ID
41              (default: automatic)
42
43       -c     generate C-shell commands on stdout (default if SHELL looks like
44              a csh-style shell
45
46       -s     generate  Bourne shell commands on stdout (default if SHELL does
47              not look like a csh-style shell
48
49       --policy-content POLICY_CONTENT
50              an IAM policy further restricting what the credentials  will  be
51              allowed to do. This cannot grant additional permissions.
52
53       --policy-document FILE
54              file  containing an IAM policy further restricting what the cre‐
55              dentials will be allowed to do.  This  cannot  grant  additional
56              permissions.
57
58       --external-id STR
59              external ID to use for comparison with policies
60
61       --mfa-serial MFA
62              MFA token serial number
63
64       --mfa-code CODE
65              MFA token code
66
67       -U URL, --url URL
68              token service endpoint URL
69
70       --region USER@REGION
71              region  and/or  user names to search when looking up config file
72              data
73
74       -I KEY_ID, --access-key-id KEY_ID
75
76       -S KEY, --secret-key KEY
77
78       --security-token TOKEN
79
80       --debug
81              show debugging output
82
83       --debugger
84              launch interactive debugger on error
85
86       --version
87              show the program's version and exit
88
89       -h, --help
90              show this help message and exit
91
92
93
94euca2ools 3.4                    December 2016             EUARE-ASSUMEROLE(1)
Impressum