Na}{

File Content: `get-session-token.rst`

**To get a set of short term credentials for an IAM identity**

The following ``get-session-token`` example retrieves a set of short-term credentials for the IAM identity making the call. The resulting credentials can be used for requests where multi-factor authentication (MFA) is required by policy. The credentials expire 15 minutes after they are generated. ::

     aws sts get-session-token \
         --session-duration 900 \
         --serial-number "YourMFADeviceSerialNumber" \
         --token-code 123456

Output::

    {
        "Credentials": {
            "AccessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "SecretAccessKey": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY",
            "SessionToken": "AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4OlgkBN9bkUDNCJiBeb/AXlzBBko7b15fjrBs2+cTQtpZ3CYWFXG8C5zqx37wnOE49mRl/+OtkIKGO7fAE",
            "Expiration": "2020-05-19T18:06:10+00:00"
        }
    }

For more information, see `Requesting Temporary Security Credentials <https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_getsessiontoken>`__ in the *IAM User Guide*.

Name	Size	Permission
assume-role-with-saml.rst	2487 bytes	0644
assume-role-with-web-identity.rst	2392 bytes	0644
assume-role.rst	1430 bytes	0644
get-caller-identity.rst	404 bytes	0644
get-session-token.rst	1250 bytes	0644

File Content: get-session-token.rst

File Content: `get-session-token.rst`