aws-sdk-core 3.39.0 → 3.54.2

data/lib/aws-sdk-sts/types.rb

@@ -14,6 +14,11 @@ module Aws::STS
     #       {
     #         role_arn: "arnType", # required
     #         role_session_name: "roleSessionNameType", # required
+    #         policy_arns: [
+    #           {
+    #             arn: "arnType",
+    #           },
+    #         ],
     #         policy: "sessionPolicyDocumentType",
     #         duration_seconds: 1,
     #         external_id: "externalIdType",
@@ -34,8 +39,8 @@ module Aws::STS
     #   visible to, and can be logged by the account that owns the role. The
     #   role session name is also used in the ARN of the assumed role
     #   principal. This means that subsequent cross-account API requests
-    #   using the temporary security credentials will expose the role
-    #   session name to the external account in their CloudTrail logs.
+    #   that use the temporary security credentials will expose the role
+    #   session name to the external account in their AWS CloudTrail logs.
     #
     #   The regex used to validate this parameter is a string of characters
     #   consisting of upper- and lower-case alphanumeric characters with no
@@ -43,39 +48,75 @@ module Aws::STS
     #   characters: =,.@-
     #   @return [String]
     #
-    # @!attribute [rw] policy
-    #   An IAM policy in JSON format.
-    #
-    #   This parameter is optional. If you pass a policy, the temporary
-    #   security credentials that are returned by the operation have the
-    #   permissions that are allowed by both (the intersection of) the
-    #   access policy of the role that is being assumed, *and* the policy
-    #   that you pass. This gives you a way to further restrict the
-    #   permissions for the resulting temporary security credentials. You
-    #   cannot use the passed policy to grant permissions that are in excess
-    #   of those allowed by the access policy of the role that is being
-    #   assumed. For more information, see [Permissions for AssumeRole,
-    #   AssumeRoleWithSAML, and AssumeRoleWithWebIdentity][1] in the *IAM
-    #   User Guide*.
+    # @!attribute [rw] policy_arns
+    #   The Amazon Resource Names (ARNs) of the IAM managed policies that
+    #   you want to use as managed session policies. The policies must exist
+    #   in the same account as the role.
+    #
+    #   This parameter is optional. You can provide up to 10 managed policy
+    #   ARNs. However, the plain text that you use for both inline and
+    #   managed session policies shouldn't exceed 2048 characters. For more
+    #   information about ARNs, see [Amazon Resource Names (ARNs) and AWS
+    #   Service Namespaces](general/latest/gr/aws-arns-and-namespaces.html)
+    #   in the AWS General Reference.
+    #
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
-    #   The format for this parameter, as described by its regex pattern, is
-    #   a string of characters up to 2048 characters in length. The
+    #    </note>
+    #
+    #   Passing policies to this operation returns new temporary
+    #   credentials. The resulting session's permissions are the
+    #   intersection of the role's identity-based policy and the session
+    #   policies. You can use the role's temporary credentials in
+    #   subsequent AWS API calls to access resources in the account that
+    #   owns the role. You cannot use session policies to grant more
+    #   permissions than those allowed by the identity-based policy of the
+    #   role that is being assumed. For more information, see [Session
+    #   Policies][1] in the *IAM User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
+    #   @return [Array<Types::PolicyDescriptorType>]
+    #
+    # @!attribute [rw] policy
+    #   An IAM policy in JSON format that you want to use as an inline
+    #   session policy.
+    #
+    #   This parameter is optional. Passing policies to this operation
+    #   returns new temporary credentials. The resulting session's
+    #   permissions are the intersection of the role's identity-based
+    #   policy and the session policies. You can use the role's temporary
+    #   credentials in subsequent AWS API calls to access resources in the
+    #   account that owns the role. You cannot use session policies to grant
+    #   more permissions than those allowed by the identity-based policy of
+    #   the role that is being assumed. For more information, see [Session
+    #   Policies][1] in the *IAM User Guide*.
+    #
+    #   The plain text that you use for both inline and managed session
+    #   policies shouldn't exceed 2048 characters. The JSON policy
     #   characters can be any ASCII character from the space character to
-    #   the end of the valid character list (\\u0020-\\u00FF). It can also
-    #   include the tab (\\u0009), linefeed (\\u000A), and carriage return
-    #   (\\u000D) characters.
+    #   the end of the valid character list (\\u0020 through \\u00FF). It
+    #   can also include the tab (\\u0009), linefeed (\\u000A), and carriage
+    #   return (\\u000D) characters.
     #
-    #   <note markdown="1"> The policy plain text must be 2048 bytes or shorter. However, an
-    #   internal conversion compresses it into a packed binary format with a
-    #   separate limit. The PackedPolicySize response element indicates by
-    #   percentage how close to the upper size limit the policy is, with
-    #   100% equaling the maximum allowed size.
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
     #    </note>
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_control-access_assumerole.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
     #   @return [String]
     #
     # @!attribute [rw] duration_seconds
@@ -89,7 +130,7 @@ module Aws::STS
     #   value for your role, see [View the Maximum Session Duration Setting
     #   for a Role][1] in the *IAM User Guide*.
     #
-    #   By default, the value is set to 3600 seconds.
+    #   By default, the value is set to `3600` seconds.
     #
     #   <note markdown="1"> The `DurationSeconds` parameter is separate from the duration of a
     #   console session that you might request using the returned
@@ -103,30 +144,32 @@ module Aws::STS
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session
-    #   [2]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session
+    #   [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html
     #   @return [Integer]
     #
     # @!attribute [rw] external_id
-    #   A unique identifier that is used by third parties when assuming
-    #   roles in their customers' accounts. For each role that the third
-    #   party can assume, they should instruct their customers to ensure the
-    #   role's trust policy checks for the external ID that the third party
-    #   generated. Each time the third party assumes the role, they should
-    #   pass the customer's external ID. The external ID is useful in order
-    #   to help third parties bind a role to the customer who created it.
-    #   For more information about the external ID, see [How to Use an
-    #   External ID When Granting Access to Your AWS Resources to a Third
+    #   A unique identifier that might be required when you assume a role in
+    #   another account. If the administrator of the account to which the
+    #   role belongs provided you with an external ID, then provide that
+    #   value in the `ExternalId` parameter. This value can be any string,
+    #   such as a passphrase or account number. A cross-account role is
+    #   usually set up to trust everyone in an account. Therefore, the
+    #   administrator of the trusting account might send an external ID to
+    #   the administrator of the trusted account. That way, only someone
+    #   with the ID can assume the role, rather than everyone in the
+    #   account. For more information about the external ID, see [How to Use
+    #   an External ID When Granting Access to Your AWS Resources to a Third
     #   Party][1] in the *IAM User Guide*.
     #
-    #   The regex used to validated this parameter is a string of characters
+    #   The regex used to validate this parameter is a string of characters
     #   consisting of upper- and lower-case alphanumeric characters with no
     #   spaces. You can also include underscores or any of the following
     #   characters: =,.@:/-
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html
     #   @return [String]
     #
     # @!attribute [rw] serial_number
@@ -160,6 +203,7 @@ module Aws::STS
     class AssumeRoleRequest < Struct.new(
       :role_arn,
       :role_session_name,
+      :policy_arns,
       :policy,
       :duration_seconds,
       :external_id,
@@ -175,11 +219,11 @@ module Aws::STS
     #   The temporary security credentials, which include an access key ID,
     #   a secret access key, and a security (or session) token.
     #
-    #   **Note:** The size of the security token that STS APIs return is not
+    #   <note markdown="1"> The size of the security token that STS API operations return is not
     #   fixed. We strongly recommend that you make no assumptions about the
-    #   maximum size. As of this writing, the typical size is less than 4096
-    #   bytes, but that can vary. Also, future updates to AWS might require
-    #   larger sizes.
+    #   maximum size.
+    #
+    #    </note>
     #   @return [Types::Credentials]
     #
     # @!attribute [rw] assumed_role_user
@@ -213,6 +257,11 @@ module Aws::STS
     #         role_arn: "arnType", # required
     #         principal_arn: "arnType", # required
     #         saml_assertion: "SAMLAssertionType", # required
+    #         policy_arns: [
+    #           {
+    #             arn: "arnType",
+    #           },
+    #         ],
     #         policy: "sessionPolicyDocumentType",
     #         duration_seconds: 1,
     #       }
@@ -232,45 +281,82 @@ module Aws::STS
     #   IdP.
     #
     #   For more information, see [Configuring a Relying Party and Adding
-    #   Claims][1] in the *Using IAM* guide.
+    #   Claims][1] in the *IAM User Guide*.
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/create-role-saml-IdP-tasks.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/create-role-saml-IdP-tasks.html
     #   @return [String]
     #
-    # @!attribute [rw] policy
-    #   An IAM policy in JSON format.
+    # @!attribute [rw] policy_arns
+    #   The Amazon Resource Names (ARNs) of the IAM managed policies that
+    #   you want to use as managed session policies. The policies must exist
+    #   in the same account as the role.
+    #
+    #   This parameter is optional. You can provide up to 10 managed policy
+    #   ARNs. However, the plain text that you use for both inline and
+    #   managed session policies shouldn't exceed 2048 characters. For more
+    #   information about ARNs, see [Amazon Resource Names (ARNs) and AWS
+    #   Service Namespaces](general/latest/gr/aws-arns-and-namespaces.html)
+    #   in the AWS General Reference.
+    #
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
-    #   The policy parameter is optional. If you pass a policy, the
-    #   temporary security credentials that are returned by the operation
-    #   have the permissions that are allowed by both the access policy of
-    #   the role that is being assumed, <i> <b>and</b> </i> the policy that
-    #   you pass. This gives you a way to further restrict the permissions
-    #   for the resulting temporary security credentials. You cannot use the
-    #   passed policy to grant permissions that are in excess of those
-    #   allowed by the access policy of the role that is being assumed. For
-    #   more information, [Permissions for AssumeRole, AssumeRoleWithSAML,
-    #   and AssumeRoleWithWebIdentity][1] in the *IAM User Guide*.
+    #    </note>
     #
-    #   The format for this parameter, as described by its regex pattern, is
-    #   a string of characters up to 2048 characters in length. The
+    #   Passing policies to this operation returns new temporary
+    #   credentials. The resulting session's permissions are the
+    #   intersection of the role's identity-based policy and the session
+    #   policies. You can use the role's temporary credentials in
+    #   subsequent AWS API calls to access resources in the account that
+    #   owns the role. You cannot use session policies to grant more
+    #   permissions than those allowed by the identity-based policy of the
+    #   role that is being assumed. For more information, see [Session
+    #   Policies][1] in the *IAM User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
+    #   @return [Array<Types::PolicyDescriptorType>]
+    #
+    # @!attribute [rw] policy
+    #   An IAM policy in JSON format that you want to use as an inline
+    #   session policy.
+    #
+    #   This parameter is optional. Passing policies to this operation
+    #   returns new temporary credentials. The resulting session's
+    #   permissions are the intersection of the role's identity-based
+    #   policy and the session policies. You can use the role's temporary
+    #   credentials in subsequent AWS API calls to access resources in the
+    #   account that owns the role. You cannot use session policies to grant
+    #   more permissions than those allowed by the identity-based policy of
+    #   the role that is being assumed. For more information, see [Session
+    #   Policies][1] in the *IAM User Guide*.
+    #
+    #   The plain text that you use for both inline and managed session
+    #   policies shouldn't exceed 2048 characters. The JSON policy
     #   characters can be any ASCII character from the space character to
-    #   the end of the valid character list (\\u0020-\\u00FF). It can also
-    #   include the tab (\\u0009), linefeed (\\u000A), and carriage return
-    #   (\\u000D) characters.
+    #   the end of the valid character list (\\u0020 through \\u00FF). It
+    #   can also include the tab (\\u0009), linefeed (\\u000A), and carriage
+    #   return (\\u000D) characters.
     #
-    #   <note markdown="1"> The policy plain text must be 2048 bytes or shorter. However, an
-    #   internal conversion compresses it into a packed binary format with a
-    #   separate limit. The PackedPolicySize response element indicates by
-    #   percentage how close to the upper size limit the policy is, with
-    #   100% equaling the maximum allowed size.
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
     #    </note>
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_control-access_assumerole.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
     #   @return [String]
     #
     # @!attribute [rw] duration_seconds
@@ -288,7 +374,7 @@ module Aws::STS
     #   Maximum Session Duration Setting for a Role][1] in the *IAM User
     #   Guide*.
     #
-    #   By default, the value is set to 3600 seconds.
+    #   By default, the value is set to `3600` seconds.
     #
     #   <note markdown="1"> The `DurationSeconds` parameter is separate from the duration of a
     #   console session that you might request using the returned
@@ -302,8 +388,8 @@ module Aws::STS
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session
-    #   [2]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session
+    #   [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/AssumeRoleWithSAMLRequest AWS API Documentation
@@ -312,6 +398,7 @@ module Aws::STS
       :role_arn,
       :principal_arn,
       :saml_assertion,
+      :policy_arns,
       :policy,
       :duration_seconds)
       include Aws::Structure
@@ -325,11 +412,11 @@ module Aws::STS
     #   The temporary security credentials, which include an access key ID,
     #   a secret access key, and a security (or session) token.
     #
-    #   **Note:** The size of the security token that STS APIs return is not
+    #   <note markdown="1"> The size of the security token that STS API operations return is not
     #   fixed. We strongly recommend that you make no assumptions about the
-    #   maximum size. As of this writing, the typical size is less than 4096
-    #   bytes, but that can vary. Also, future updates to AWS might require
-    #   larger sizes.
+    #   maximum size.
+    #
+    #    </note>
     #   @return [Types::Credentials]
     #
     # @!attribute [rw] assumed_role_user
@@ -404,6 +491,11 @@ module Aws::STS
     #         role_session_name: "roleSessionNameType", # required
     #         web_identity_token: "clientTokenType", # required
     #         provider_id: "urlType",
+    #         policy_arns: [
+    #           {
+    #             arn: "arnType",
+    #           },
+    #         ],
     #         policy: "sessionPolicyDocumentType",
     #         duration_seconds: 1,
     #       }
@@ -447,38 +539,75 @@ module Aws::STS
     #   Do not specify this value for OpenID Connect ID tokens.
     #   @return [String]
     #
-    # @!attribute [rw] policy
-    #   An IAM policy in JSON format.
+    # @!attribute [rw] policy_arns
+    #   The Amazon Resource Names (ARNs) of the IAM managed policies that
+    #   you want to use as managed session policies. The policies must exist
+    #   in the same account as the role.
+    #
+    #   This parameter is optional. You can provide up to 10 managed policy
+    #   ARNs. However, the plain text that you use for both inline and
+    #   managed session policies shouldn't exceed 2048 characters. For more
+    #   information about ARNs, see [Amazon Resource Names (ARNs) and AWS
+    #   Service Namespaces](general/latest/gr/aws-arns-and-namespaces.html)
+    #   in the AWS General Reference.
+    #
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
-    #   The policy parameter is optional. If you pass a policy, the
-    #   temporary security credentials that are returned by the operation
-    #   have the permissions that are allowed by both the access policy of
-    #   the role that is being assumed, <i> <b>and</b> </i> the policy that
-    #   you pass. This gives you a way to further restrict the permissions
-    #   for the resulting temporary security credentials. You cannot use the
-    #   passed policy to grant permissions that are in excess of those
-    #   allowed by the access policy of the role that is being assumed. For
-    #   more information, see [Permissions for AssumeRoleWithWebIdentity][1]
-    #   in the *IAM User Guide*.
+    #    </note>
     #
-    #   The format for this parameter, as described by its regex pattern, is
-    #   a string of characters up to 2048 characters in length. The
+    #   Passing policies to this operation returns new temporary
+    #   credentials. The resulting session's permissions are the
+    #   intersection of the role's identity-based policy and the session
+    #   policies. You can use the role's temporary credentials in
+    #   subsequent AWS API calls to access resources in the account that
+    #   owns the role. You cannot use session policies to grant more
+    #   permissions than those allowed by the identity-based policy of the
+    #   role that is being assumed. For more information, see [Session
+    #   Policies][1] in the *IAM User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
+    #   @return [Array<Types::PolicyDescriptorType>]
+    #
+    # @!attribute [rw] policy
+    #   An IAM policy in JSON format that you want to use as an inline
+    #   session policy.
+    #
+    #   This parameter is optional. Passing policies to this operation
+    #   returns new temporary credentials. The resulting session's
+    #   permissions are the intersection of the role's identity-based
+    #   policy and the session policies. You can use the role's temporary
+    #   credentials in subsequent AWS API calls to access resources in the
+    #   account that owns the role. You cannot use session policies to grant
+    #   more permissions than those allowed by the identity-based policy of
+    #   the role that is being assumed. For more information, see [Session
+    #   Policies][1] in the *IAM User Guide*.
+    #
+    #   The plain text that you use for both inline and managed session
+    #   policies shouldn't exceed 2048 characters. The JSON policy
     #   characters can be any ASCII character from the space character to
-    #   the end of the valid character list (\\u0020-\\u00FF). It can also
-    #   include the tab (\\u0009), linefeed (\\u000A), and carriage return
-    #   (\\u000D) characters.
+    #   the end of the valid character list (\\u0020 through \\u00FF). It
+    #   can also include the tab (\\u0009), linefeed (\\u000A), and carriage
+    #   return (\\u000D) characters.
     #
-    #   <note markdown="1"> The policy plain text must be 2048 bytes or shorter. However, an
-    #   internal conversion compresses it into a packed binary format with a
-    #   separate limit. The PackedPolicySize response element indicates by
-    #   percentage how close to the upper size limit the policy is, with
-    #   100% equaling the maximum allowed size.
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
     #    </note>
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_control-access_assumerole.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
     #   @return [String]
     #
     # @!attribute [rw] duration_seconds
@@ -492,7 +621,7 @@ module Aws::STS
     #   value for your role, see [View the Maximum Session Duration Setting
     #   for a Role][1] in the *IAM User Guide*.
     #
-    #   By default, the value is set to 3600 seconds.
+    #   By default, the value is set to `3600` seconds.
     #
     #   <note markdown="1"> The `DurationSeconds` parameter is separate from the duration of a
     #   console session that you might request using the returned
@@ -506,8 +635,8 @@ module Aws::STS
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session
-    #   [2]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session
+    #   [2]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/AssumeRoleWithWebIdentityRequest AWS API Documentation
@@ -517,6 +646,7 @@ module Aws::STS
       :role_session_name,
       :web_identity_token,
       :provider_id,
+      :policy_arns,
       :policy,
       :duration_seconds)
       include Aws::Structure
@@ -530,11 +660,11 @@ module Aws::STS
     #   The temporary security credentials, which include an access key ID,
     #   a secret access key, and a security token.
     #
-    #   **Note:** The size of the security token that STS APIs return is not
+    #   <note markdown="1"> The size of the security token that STS API operations return is not
     #   fixed. We strongly recommend that you make no assumptions about the
-    #   maximum size. As of this writing, the typical size is less than 4096
-    #   bytes, but that can vary. Also, future updates to AWS might require
-    #   larger sizes.
+    #   maximum size.
+    #
+    #    </note>
     #   @return [Types::Credentials]
     #
     # @!attribute [rw] subject_from_web_identity_token
@@ -564,8 +694,8 @@ module Aws::STS
     #
     # @!attribute [rw] provider
     #   The issuing authority of the web identity token presented. For
-    #   OpenID Connect ID Tokens this contains the value of the `iss` field.
-    #   For OAuth 2.0 access tokens, this contains the value of the
+    #   OpenID Connect ID tokens, this contains the value of the `iss`
+    #   field. For OAuth 2.0 access tokens, this contains the value of the
     #   `ProviderId` parameter that was passed in the
     #   `AssumeRoleWithWebIdentity` request.
     #   @return [String]
@@ -604,7 +734,7 @@ module Aws::STS
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/AssumedRoleUser AWS API Documentation
@@ -678,6 +808,20 @@ module Aws::STS
       include Aws::Structure
     end
 
+    # The web identity token that was passed is expired or is not valid. Get
+    # a new identity token from the identity provider and then retry the
+    # request.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/ExpiredTokenException AWS API Documentation
+    #
+    class ExpiredTokenException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
     # Identifiers for the federated user that is associated with the
     # credentials.
     #
@@ -693,7 +837,7 @@ module Aws::STS
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/FederatedUser AWS API Documentation
@@ -715,14 +859,14 @@ module Aws::STS
     #
     # @!attribute [rw] user_id
     #   The unique identifier of the calling entity. The exact value depends
-    #   on the type of entity making the call. The values returned are those
-    #   listed in the **aws:userid** column in the [Principal table][1]
-    #   found on the **Policy Variables** reference page in the *IAM User
-    #   Guide*.
+    #   on the type of entity that is making the call. The values returned
+    #   are those listed in the **aws:userid** column in the [Principal
+    #   table][1] found on the **Policy Variables** reference page in the
+    #   *IAM User Guide*.
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html#principaltable
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html#principaltable
     #   @return [String]
     #
     # @!attribute [rw] account
@@ -749,6 +893,11 @@ module Aws::STS
     #       {
     #         name: "userNameType", # required
     #         policy: "sessionPolicyDocumentType",
+    #         policy_arns: [
+    #           {
+    #             arn: "arnType",
+    #           },
+    #         ],
     #         duration_seconds: 1,
     #       }
     #
@@ -765,55 +914,104 @@ module Aws::STS
     #   @return [String]
     #
     # @!attribute [rw] policy
-    #   An IAM policy in JSON format that is passed with the
-    #   `GetFederationToken` call and evaluated along with the policy or
-    #   policies that are attached to the IAM user whose credentials are
-    #   used to call `GetFederationToken`. The passed policy is used to
-    #   scope down the permissions that are available to the IAM user, by
-    #   allowing only a subset of the permissions that are granted to the
-    #   IAM user. The passed policy cannot grant more permissions than those
-    #   granted to the IAM user. The final permissions for the federated
-    #   user are the most restrictive set based on the intersection of the
-    #   passed policy and the IAM user policy.
-    #
-    #   If you do not pass a policy, the resulting temporary security
-    #   credentials have no effective permissions. The only exception is
-    #   when the temporary security credentials are used to access a
-    #   resource that has a resource-based policy that specifically allows
-    #   the federated user to access the resource.
+    #   An IAM policy in JSON format that you want to use as an inline
+    #   session policy.
+    #
+    #   You must pass an inline or managed [session policy][1] to this
+    #   operation. You can pass a single JSON policy document to use as an
+    #   inline session policy. You can also specify up to 10 managed
+    #   policies to use as managed session policies.
+    #
+    #   This parameter is optional. However, if you do not pass any session
+    #   policies, then the resulting federated user session has no
+    #   permissions. The only exception is when the credentials are used to
+    #   access a resource that has a resource-based policy that specifically
+    #   references the federated user session in the `Principal` element of
+    #   the policy.
+    #
+    #   When you pass session policies, the session permissions are the
+    #   intersection of the IAM user policies and the session policies that
+    #   you pass. This gives you a way to further restrict the permissions
+    #   for a federated user. You cannot use session policies to grant more
+    #   permissions than those that are defined in the permissions policy of
+    #   the IAM user. For more information, see [Session Policies][1] in the
+    #   *IAM User Guide*.
     #
-    #   The format for this parameter, as described by its regex pattern, is
-    #   a string of characters up to 2048 characters in length. The
+    #   The plain text that you use for both inline and managed session
+    #   policies shouldn't exceed 2048 characters. The JSON policy
     #   characters can be any ASCII character from the space character to
-    #   the end of the valid character list (\\u0020-\\u00FF). It can also
-    #   include the tab (\\u0009), linefeed (\\u000A), and carriage return
-    #   (\\u000D) characters.
+    #   the end of the valid character list (\\u0020 through \\u00FF). It
+    #   can also include the tab (\\u0009), linefeed (\\u000A), and carriage
+    #   return (\\u000D) characters.
     #
-    #   <note markdown="1"> The policy plain text must be 2048 bytes or shorter. However, an
-    #   internal conversion compresses it into a packed binary format with a
-    #   separate limit. The PackedPolicySize response element indicates by
-    #   percentage how close to the upper size limit the policy is, with
-    #   100% equaling the maximum allowed size.
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
     #
     #    </note>
     #
-    #   For more information about how permissions work, see [Permissions
-    #   for GetFederationToken][1].
-    #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_control-access_getfederationtoken.html
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
     #   @return [String]
     #
+    # @!attribute [rw] policy_arns
+    #   The Amazon Resource Names (ARNs) of the IAM managed policies that
+    #   you want to use as a managed session policy. The policies must exist
+    #   in the same account as the IAM user that is requesting federated
+    #   access.
+    #
+    #   You must pass an inline or managed [session policy][1] to this
+    #   operation. You can pass a single JSON policy document to use as an
+    #   inline session policy. You can also specify up to 10 managed
+    #   policies to use as managed session policies. The plain text that you
+    #   use for both inline and managed session policies shouldn't exceed
+    #   2048 characters. You can provide up to 10 managed policy ARNs. For
+    #   more information about ARNs, see [Amazon Resource Names (ARNs) and
+    #   AWS Service
+    #   Namespaces](general/latest/gr/aws-arns-and-namespaces.html) in the
+    #   AWS General Reference.
+    #
+    #   This parameter is optional. However, if you do not pass any session
+    #   policies, then the resulting federated user session has no
+    #   permissions. The only exception is when the credentials are used to
+    #   access a resource that has a resource-based policy that specifically
+    #   references the federated user session in the `Principal` element of
+    #   the policy.
+    #
+    #   When you pass session policies, the session permissions are the
+    #   intersection of the IAM user policies and the session policies that
+    #   you pass. This gives you a way to further restrict the permissions
+    #   for a federated user. You cannot use session policies to grant more
+    #   permissions than those that are defined in the permissions policy of
+    #   the IAM user. For more information, see [Session Policies][1] in the
+    #   *IAM User Guide*.
+    #
+    #   <note markdown="1"> The characters in this parameter count towards the 2048 character
+    #   session policy guideline. However, an AWS conversion compresses the
+    #   session policies into a packed binary format that has a separate
+    #   limit. This is the enforced limit. The `PackedPolicySize` response
+    #   element indicates by percentage how close the policy is to the upper
+    #   size limit.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session
+    #   @return [Array<Types::PolicyDescriptorType>]
+    #
     # @!attribute [rw] duration_seconds
     #   The duration, in seconds, that the session should last. Acceptable
     #   durations for federation sessions range from 900 seconds (15
-    #   minutes) to 129600 seconds (36 hours), with 43200 seconds (12 hours)
-    #   as the default. Sessions obtained using AWS account (root)
-    #   credentials are restricted to a maximum of 3600 seconds (one hour).
+    #   minutes) to 129,600 seconds (36 hours), with 43,200 seconds (12
+    #   hours) as the default. Sessions obtained using AWS account root user
+    #   credentials are restricted to a maximum of 3,600 seconds (one hour).
     #   If the specified duration is longer than one hour, the session
-    #   obtained by using AWS account (root) credentials defaults to one
-    #   hour.
+    #   obtained by using root user credentials defaults to one hour.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/GetFederationTokenRequest AWS API Documentation
@@ -821,6 +1019,7 @@ module Aws::STS
     class GetFederationTokenRequest < Struct.new(
       :name,
       :policy,
+      :policy_arns,
       :duration_seconds)
       include Aws::Structure
     end
@@ -833,11 +1032,11 @@ module Aws::STS
     #   The temporary security credentials, which include an access key ID,
     #   a secret access key, and a security (or session) token.
     #
-    #   **Note:** The size of the security token that STS APIs return is not
+    #   <note markdown="1"> The size of the security token that STS API operations return is not
     #   fixed. We strongly recommend that you make no assumptions about the
-    #   maximum size. As of this writing, the typical size is less than 4096
-    #   bytes, but that can vary. Also, future updates to AWS might require
-    #   larger sizes.
+    #   maximum size.
+    #
+    #    </note>
     #   @return [Types::Credentials]
     #
     # @!attribute [rw] federated_user
@@ -874,9 +1073,9 @@ module Aws::STS
     # @!attribute [rw] duration_seconds
     #   The duration, in seconds, that the credentials should remain valid.
     #   Acceptable durations for IAM user sessions range from 900 seconds
-    #   (15 minutes) to 129600 seconds (36 hours), with 43200 seconds (12
+    #   (15 minutes) to 129,600 seconds (36 hours), with 43,200 seconds (12
     #   hours) as the default. Sessions for AWS account owners are
-    #   restricted to a maximum of 3600 seconds (one hour). If the duration
+    #   restricted to a maximum of 3,600 seconds (one hour). If the duration
     #   is longer than one hour, the session for AWS account owners defaults
     #   to one hour.
     #   @return [Integer]
@@ -891,7 +1090,7 @@ module Aws::STS
     #   the device for an IAM user by going to the AWS Management Console
     #   and viewing the user's security credentials.
     #
-    #   The regex used to validated this parameter is a string of characters
+    #   The regex used to validate this parameter is a string of characters
     #   consisting of upper- and lower-case alphanumeric characters with no
     #   spaces. You can also include underscores or any of the following
     #   characters: =,.@:/-
@@ -900,9 +1099,9 @@ module Aws::STS
     # @!attribute [rw] token_code
     #   The value provided by the MFA device, if MFA is required. If any
     #   policy requires the IAM user to submit an MFA code, specify this
-    #   value. If MFA authentication is required, and the user does not
-    #   provide a code when requesting a set of temporary security
-    #   credentials, the user will receive an "access denied" response
+    #   value. If MFA authentication is required, the user must provide a
+    #   code when requesting a set of temporary security credentials. A user
+    #   who fails to provide the code receives an "access denied" response
     #   when requesting resources that require MFA authentication.
     #
     #   The format for this parameter, as described by its regex pattern, is
@@ -926,11 +1125,11 @@ module Aws::STS
     #   The temporary security credentials, which include an access key ID,
     #   a secret access key, and a security (or session) token.
     #
-    #   **Note:** The size of the security token that STS APIs return is not
+    #   <note markdown="1"> The size of the security token that STS API operations return is not
     #   fixed. We strongly recommend that you make no assumptions about the
-    #   maximum size. As of this writing, the typical size is less than 4096
-    #   bytes, but that can vary. Also, future updates to AWS might require
-    #   larger sizes.
+    #   maximum size.
+    #
+    #    </note>
     #   @return [Types::Credentials]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/GetSessionTokenResponse AWS API Documentation
@@ -940,5 +1139,139 @@ module Aws::STS
       include Aws::Structure
     end
 
+    # The request could not be fulfilled because the non-AWS identity
+    # provider (IDP) that was asked to verify the incoming identity token
+    # could not be reached. This is often a transient error caused by
+    # network conditions. Retry the request a limited number of times so
+    # that you don't exceed the request rate. If the error persists, the
+    # non-AWS identity provider might be down or not responding.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/IDPCommunicationErrorException AWS API Documentation
+    #
+    class IDPCommunicationErrorException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
+    # The identity provider (IdP) reported that authentication failed. This
+    # might be because the claim is invalid.
+    #
+    # If this error is returned for the `AssumeRoleWithWebIdentity`
+    # operation, it can also mean that the claim has expired or has been
+    # explicitly revoked.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/IDPRejectedClaimException AWS API Documentation
+    #
+    class IDPRejectedClaimException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
+    # The error returned if the message passed to
+    # `DecodeAuthorizationMessage` was invalid. This can happen if the token
+    # contains invalid characters, such as linebreaks.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/InvalidAuthorizationMessageException AWS API Documentation
+    #
+    class InvalidAuthorizationMessageException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
+    # The web identity token that was passed could not be validated by AWS.
+    # Get a new identity token from the identity provider and then retry the
+    # request.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/InvalidIdentityTokenException AWS API Documentation
+    #
+    class InvalidIdentityTokenException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
+    # The request was rejected because the policy document was malformed.
+    # The error message describes the specific error.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/MalformedPolicyDocumentException AWS API Documentation
+    #
+    class MalformedPolicyDocumentException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
+    # The request was rejected because the policy document was too large.
+    # The error message describes how big the policy document is, in packed
+    # form, as a percentage of what the API allows.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/PackedPolicyTooLargeException AWS API Documentation
+    #
+    class PackedPolicyTooLargeException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
+    # A reference to the IAM managed policy that is passed as a session
+    # policy for a role session or a federated user session.
+    #
+    # @note When making an API call, you may pass PolicyDescriptorType
+    #   data as a hash:
+    #
+    #       {
+    #         arn: "arnType",
+    #       }
+    #
+    # @!attribute [rw] arn
+    #   The Amazon Resource Name (ARN) of the IAM managed policy to use as a
+    #   session policy for the role. For more information about ARNs, see
+    #   [Amazon Resource Names (ARNs) and AWS Service
+    #   Namespaces](general/latest/gr/aws-arns-and-namespaces.html) in the
+    #   *AWS General Reference*.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/PolicyDescriptorType AWS API Documentation
+    #
+    class PolicyDescriptorType < Struct.new(
+      :arn)
+      include Aws::Structure
+    end
+
+    # STS is not activated in the requested region for the account that is
+    # being asked to generate credentials. The account administrator must
+    # use the IAM console to activate STS in that region. For more
+    # information, see [Activating and Deactivating AWS STS in an AWS
+    # Region][1] in the *IAM User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sts-2011-06-15/RegionDisabledException AWS API Documentation
+    #
+    class RegionDisabledException < Struct.new(
+      :message)
+      include Aws::Structure
+    end
+
   end
 end