@aws-sdk/client-sts 3.42.0 → 3.43.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.43.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.42.0...v3.43.0) (2021-11-29)
+
+
+### Features
+
+* **clients:** update clients as of 11/28/2021 ([#3072](https://github.com/aws/aws-sdk-js-v3/issues/3072)) ([2ad1622](https://github.com/aws/aws-sdk-js-v3/commit/2ad1622ba8586b926fe508055211803bb29e3976))
+
+
+
+
+
 # [3.42.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.41.0...v3.42.0) (2021-11-19)
 
 

package/dist-types/STS.d.ts

@@ -18,20 +18,19 @@ import { STSClient } from "./STSClient";
 export declare class STS extends STSClient {
     /**
      * <p>Returns a set of temporary security credentials that you can use to access Amazon Web Services
-     *             resources that you might not normally have access to. These temporary credentials
-     *             consist of an access key ID, a secret access key, and a security token. Typically, you
-     *             use <code>AssumeRole</code> within your account or for cross-account access. For a
-     *             comparison of <code>AssumeRole</code> with other API operations that produce temporary
-     *             credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
-     *                 Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing
-     *                 the STS API operations</a> in the
-     *             <i>IAM User Guide</i>.</p>
+     *          resources that you might not normally have access to. These temporary credentials consist
+     *          of an access key ID, a secret access key, and a security token. Typically, you use
+     *             <code>AssumeRole</code> within your account or for cross-account access. For a
+     *          comparison of <code>AssumeRole</code> with other API operations that produce temporary
+     *          credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
+     *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
+     *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
      *          <p>
      *             <b>Permissions</b>
      *          </p>
      *          <p>The temporary security credentials created by <code>AssumeRole</code> can be used to
      *          make API calls to any Amazon Web Services service with the following exception: You cannot call the
-     *          STS <code>GetFederationToken</code> or <code>GetSessionToken</code> API
+     *          Amazon Web Services STS <code>GetFederationToken</code> or <code>GetSessionToken</code> API
      *          operations.</p>
      *          <p>(Optional) You can pass inline or managed <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">session policies</a> to
      *          this operation. You can pass a single JSON policy document to use as an inline session
@@ -45,28 +44,35 @@ export declare class STS extends STSClient {
      *          by the identity-based policy of the role that is being assumed. For more information, see
      *             <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">Session
      *             Policies</a> in the <i>IAM User Guide</i>.</p>
-     *          <p>To assume a role from a different account, your account must be trusted by the
+     *          <p>When you create a role, you create two policies: A role trust policy that specifies
+     *          <i>who</i> can assume the role and a permissions policy that specifies
+     *          <i>what</i> can be done with the role. You specify the trusted principal
+     *          who is allowed to assume the role in the role trust policy.</p>
+     *          <p>To assume a role from a different account, your Amazon Web Services account must be trusted by the
      *          role. The trust relationship is defined in the role's trust policy when the role is
      *          created. That trust policy states which accounts are allowed to delegate that access to
      *          users in the account. </p>
      *          <p>A user who wants to access a role in a different account must also have permissions that
      *          are delegated from the user account administrator. The administrator must attach a policy
      *          that allows the user to call <code>AssumeRole</code> for the ARN of the role in the other
-     *          account. If the user is in the same account as the role, then you can do either of the
+     *          account.</p>
+     *          <p>To allow a user to assume a role in the same account, you can do either of the
      *          following:</p>
      *          <ul>
      *             <li>
-     *                <p>Attach a policy to the user (identical to the previous user in a different
-     *                account).</p>
+     *                <p>Attach a policy to the user that allows the user to call
+     *                <code>AssumeRole</code> (as long as the role's trust policy trusts the account).</p>
      *             </li>
      *             <li>
      *                <p>Add the user as a principal directly in the role's trust policy.</p>
      *             </li>
      *          </ul>
-     *          <p>In this case, the trust policy acts as an IAM resource-based policy. Users in the same
-     *          account as the role do not need explicit permission to assume the role. For more
-     *          information about trust policies and resource-based policies, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">IAM Policies</a> in
-     *          the <i>IAM User Guide</i>.</p>
+     *          <p>You can do either because the role’s trust policy acts as an IAM resource-based
+     *          policy. When a resource-based policy grants access to a principal in the same account, no
+     *          additional identity-based policy is required. For more information about trust policies and
+     *          resource-based policies, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">IAM Policies</a> in the
+     *             <i>IAM User Guide</i>.</p>
+     *
      *          <p>
      *             <b>Tags</b>
      *          </p>
@@ -112,7 +118,7 @@ export declare class STS extends STSClient {
      *          credentials or configuration. For a comparison of <code>AssumeRoleWithSAML</code> with the
      *          other API operations that produce temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
      *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
-     *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+     *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
      *          <p>The temporary security credentials returned by this operation consist of an access key
      *          ID, a secret access key, and a security token. Applications can use these temporary
      *          security credentials to sign calls to Amazon Web Services services.</p>
@@ -134,15 +140,15 @@ export declare class STS extends STSClient {
      *          console URL. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html">Using IAM Roles</a> in the
      *             <i>IAM User Guide</i>.</p>
      *          <note>
-     *            <p>
-     *                <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-role-chaining">Role chaining</a> limits your CLI or Amazon Web Services API
-     *                role session to a maximum of one hour. When you use the <code>AssumeRole</code> API
-     *                operation to assume a role, you can specify the duration of your role session with
-     *                the <code>DurationSeconds</code> parameter. You can specify a parameter value of up
-     *                to 43200 seconds (12 hours), depending on the maximum session duration setting for
-     *                your role. However, if you assume a role using role chaining and provide a
-     *                <code>DurationSeconds</code> parameter value greater than one hour, the
-     *                operation fails.</p>
+     *             <p>
+     *                <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-role-chaining">Role chaining</a> limits your CLI or Amazon Web Services API role
+     *             session to a maximum of one hour. When you use the <code>AssumeRole</code> API operation
+     *             to assume a role, you can specify the duration of your role session with the
+     *                <code>DurationSeconds</code> parameter. You can specify a parameter value of up to
+     *             43200 seconds (12 hours), depending on the maximum session duration setting for your
+     *             role. However, if you assume a role using role chaining and provide a
+     *                <code>DurationSeconds</code> parameter value greater than one hour, the operation
+     *             fails.</p>
      *          </note>
      *          <p>
      *             <b>Permissions</b>
@@ -194,9 +200,9 @@ export declare class STS extends STSClient {
      *             request are to the upper size limit.
      *             </p>
      *          </note>
-     *          <p>You can pass a session tag with the same key as a tag that is
-     *          attached to the role. When you do, session tags override the role's tags with the same
-     *          key.</p>
+     *
+     *          <p>You can pass a session tag with the same key as a tag that is attached to the role. When
+     *          you do, session tags override the role's tags with the same key.</p>
      *          <p>An administrator must grant you the permissions necessary to pass session tags. The
      *          administrator can also create granular permissions to allow you to pass only specific
      *          session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using Tags
@@ -265,7 +271,7 @@ export declare class STS extends STSClient {
      *             <code>AssumeRoleWithWebIdentity</code> with the other API operations that produce
      *          temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
      *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
-     *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+     *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
      *          <p>The temporary security credentials returned by this API consist of an access key ID, a
      *          secret access key, and a security token. Applications can use these temporary security
      *          credentials to sign calls to Amazon Web Services service API operations.</p>
@@ -323,9 +329,9 @@ export declare class STS extends STSClient {
      *             request are to the upper size limit.
      *             </p>
      *          </note>
-     *          <p>You can pass a session tag with the same key as a tag that is
-     *          attached to the role. When you do, the session tag overrides the role tag with the same
-     *          key.</p>
+     *
+     *          <p>You can pass a session tag with the same key as a tag that is attached to the role. When
+     *          you do, the session tag overrides the role tag with the same key.</p>
      *          <p>An administrator must grant you the permissions necessary to pass session tags. The
      *          administrator can also create granular permissions to allow you to pass only specific
      *          session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using Tags
@@ -395,9 +401,9 @@ export declare class STS extends STSClient {
      *             documentation for an individual operation indicates whether that operation returns an
      *             encoded message in addition to returning an HTTP code.</p>
      *          </note>
-     *          <p>The message is encoded because the details of the authorization status can constitute
+     *          <p>The message is encoded because the details of the authorization status can contain
      *          privileged information that the user who requested the operation should not see. To decode
-     *          an authorization status message, a user must be granted permissions via an IAM policy to
+     *          an authorization status message, a user must be granted permissions through an IAM <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">policy</a> to
      *          request the <code>DecodeAuthorizationMessage</code>
      *             (<code>sts:DecodeAuthorizationMessage</code>) action. </p>
      *          <p>The decoded message includes the following type of information:</p>
@@ -426,38 +432,38 @@ export declare class STS extends STSClient {
     decodeAuthorizationMessage(args: DecodeAuthorizationMessageCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DecodeAuthorizationMessageCommandOutput) => void): void;
     /**
      * <p>Returns the account identifier for the specified access key ID.</p>
-     *         <p>Access keys consist of two parts: an access key ID (for example,
-     *                 <code>AKIAIOSFODNN7EXAMPLE</code>) and a secret access key (for example,
-     *                 <code>wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY</code>). For more information about
-     *             access keys, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html">Managing Access Keys for IAM
-     *                 Users</a> in the <i>IAM User Guide</i>.</p>
-     *         <p>When you pass an access key ID to this operation, it returns the ID of the Amazon Web Services
-     *             account to which the keys belong. Access key IDs beginning with <code>AKIA</code> are
-     *             long-term credentials for an IAM user or the Amazon Web Services account root user. Access key IDs
-     *             beginning with <code>ASIA</code> are temporary credentials that are created using STS
-     *             operations. If the account in the response belongs to you, you can sign in as the root
-     *             user and review your root user access keys. Then, you can pull a <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_getting-report.html">credentials report</a> to learn which IAM user owns the keys. To learn who
-     *             requested the temporary credentials for an <code>ASIA</code> access key, view the STS
-     *             events in your <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html">CloudTrail logs</a> in the
-     *                 <i>IAM User Guide</i>.</p>
-     *         <p>This operation does not indicate the state of the access key. The key might be active,
-     *             inactive, or deleted. Active keys might not have permissions to perform an operation.
-     *             Providing a deleted access key might return an error that the key doesn't exist.</p>
+     *          <p>Access keys consist of two parts: an access key ID (for example,
+     *             <code>AKIAIOSFODNN7EXAMPLE</code>) and a secret access key (for example,
+     *             <code>wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY</code>). For more information about
+     *          access keys, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html">Managing Access Keys for IAM
+     *             Users</a> in the <i>IAM User Guide</i>.</p>
+     *          <p>When you pass an access key ID to this operation, it returns the ID of the Amazon Web Services account
+     *          to which the keys belong. Access key IDs beginning with <code>AKIA</code> are long-term
+     *          credentials for an IAM user or the Amazon Web Services account root user. Access key IDs beginning with
+     *             <code>ASIA</code> are temporary credentials that are created using STS operations. If
+     *          the account in the response belongs to you, you can sign in as the root user and review
+     *          your root user access keys. Then, you can pull a <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_getting-report.html">credentials report</a> to
+     *          learn which IAM user owns the keys. To learn who requested the temporary credentials for
+     *          an <code>ASIA</code> access key, view the STS events in your <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html">CloudTrail logs</a> in the
+     *             <i>IAM User Guide</i>.</p>
+     *          <p>This operation does not indicate the state of the access key. The key might be active,
+     *          inactive, or deleted. Active keys might not have permissions to perform an operation.
+     *          Providing a deleted access key might return an error that the key doesn't exist.</p>
      */
     getAccessKeyInfo(args: GetAccessKeyInfoCommandInput, options?: __HttpHandlerOptions): Promise<GetAccessKeyInfoCommandOutput>;
     getAccessKeyInfo(args: GetAccessKeyInfoCommandInput, cb: (err: any, data?: GetAccessKeyInfoCommandOutput) => void): void;
     getAccessKeyInfo(args: GetAccessKeyInfoCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetAccessKeyInfoCommandOutput) => void): void;
     /**
      * <p>Returns details about the IAM user or role whose credentials are used to call the
-     *             operation.</p>
-     *         <note>
+     *          operation.</p>
+     *          <note>
      *             <p>No permissions are required to perform this operation. If an administrator adds a
-     *                 policy to your IAM user or role that explicitly denies access to the
-     *                     <code>sts:GetCallerIdentity</code> action, you can still perform this operation.
-     *                 Permissions are not required because the same information is returned when an IAM
-     *                 user or role is denied access. To view an example response, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_general.html#troubleshoot_general_access-denied-delete-mfa">I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice</a> in the
-     *                     <i>IAM User Guide</i>.</p>
-     *         </note>
+     *             policy to your IAM user or role that explicitly denies access to the
+     *                <code>sts:GetCallerIdentity</code> action, you can still perform this operation.
+     *             Permissions are not required because the same information is returned when an IAM user
+     *             or role is denied access. To view an example response, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_general.html#troubleshoot_general_access-denied-delete-mfa">I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice</a> in the
+     *                <i>IAM User Guide</i>.</p>
+     *          </note>
      */
     getCallerIdentity(args: GetCallerIdentityCommandInput, options?: __HttpHandlerOptions): Promise<GetCallerIdentityCommandOutput>;
     getCallerIdentity(args: GetCallerIdentityCommandInput, cb: (err: any, data?: GetCallerIdentityCommandOutput) => void): void;
@@ -472,7 +478,7 @@ export declare class STS extends STSClient {
      *          server-based application. For a comparison of <code>GetFederationToken</code> with the
      *          other API operations that produce temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
      *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
-     *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+     *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
      *          <note>
      *             <p>You can create a mobile-based or browser-based app that can authenticate users using
      *             a web identity provider like Login with Amazon, Facebook, Google, or an OpenID
@@ -491,8 +497,8 @@ export declare class STS extends STSClient {
      *          </p>
      *          <p>The temporary credentials are valid for the specified duration, from 900 seconds (15
      *          minutes) up to a maximum of 129,600 seconds (36 hours). The default session duration is
-     *          43,200 seconds (12 hours). Temporary credentials that are obtained by using Amazon Web Services account
-     *          root user credentials have a maximum duration of 3,600 seconds (1 hour).</p>
+     *          43,200 seconds (12 hours). Temporary credentials obtained by using the Amazon Web Services account root
+     *          user credentials have a maximum duration of 3,600 seconds (1 hour).</p>
      *          <p>
      *             <b>Permissions</b>
      *          </p>
@@ -530,78 +536,25 @@ export declare class STS extends STSClient {
      *          <p>(Optional) You can pass tag key-value pairs to your session. These are called session
      *          tags. For more information about session tags, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Passing Session Tags in STS</a> in the
      *             <i>IAM User Guide</i>.</p>
-     *         <note>
-     *             <p>You can create a mobile-based or browser-based app that can authenticate users
-     *                 using a web identity provider like Login with Amazon, Facebook, Google, or an OpenID
-     *                 Connect-compatible identity provider. In this case, we recommend that you use <a href="http://aws.amazon.com/cognito/">Amazon Cognito</a> or
-     *                     <code>AssumeRoleWithWebIdentity</code>. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_assumerolewithwebidentity">Federation Through a Web-based Identity Provider</a> in the
-     *                     <i>IAM User Guide</i>.</p>
-     *         </note>
-     *         <p>You can also call <code>GetFederationToken</code> using the security credentials of an
-     *             Amazon Web Services account root user, but we do not recommend it. Instead, we recommend that you
-     *             create an IAM user for the purpose of the proxy application. Then attach a policy to
-     *             the IAM user that limits federated users to only the actions and resources that they
-     *             need to access. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html">IAM Best Practices</a> in the
-     *                 <i>IAM User Guide</i>. </p>
-     *         <p>
-     *             <b>Session duration</b>
-     *          </p>
-     *         <p>The temporary credentials are valid for the specified duration, from 900 seconds (15
-     *             minutes) up to a maximum of 129,600 seconds (36 hours). The default session duration is
-     *             43,200 seconds (12 hours). Temporary credentials that are obtained by using Amazon Web Services
-     *             account root user credentials have a maximum duration of 3,600 seconds (1 hour).</p>
-     *         <p>
-     *             <b>Permissions</b>
-     *         </p>
-     *         <p>You can use the temporary credentials created by <code>GetFederationToken</code> in
-     *             any Amazon Web Services service except the following:</p>
-     *         <ul>
-     *             <li>
-     *                 <p>You cannot call any IAM operations using the CLI or the Amazon Web Services API.
-     *                 </p>
-     *             </li>
-     *             <li>
-     *                 <p>You cannot call any STS operations except
-     *                     <code>GetCallerIdentity</code>.</p>
-     *             </li>
-     *          </ul>
-     *         <p>You must pass an inline or managed <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">session policy</a> 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 can't
-     *             exceed 2,048 characters.</p>
-     *         <p>Though the session policy parameters are optional, if you do not pass a policy, then
-     *             the resulting federated user session has no permissions. 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
-     *                 <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">Session Policies</a>
-     *             in the <i>IAM User Guide</i>. For information about using
-     *                 <code>GetFederationToken</code> to create temporary security credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_getfederationtoken">GetFederationToken—Federation Through a Custom Identity Broker</a>. </p>
-     *         <p>You can use the credentials to access a resource that has a resource-based policy. If
-     *             that policy specifically references the federated user session in the
-     *                 <code>Principal</code> element of the policy, the session has the permissions
-     *             allowed by the policy. These permissions are granted in addition to the permissions
-     *             granted by the session policies.</p>
-     *         <p>
-     *             <b>Tags</b>
-     *          </p>
-     *         <p>(Optional) You can pass tag key-value pairs to your session. These are called session
-     *             tags. For more information about session tags, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Passing Session Tags in STS</a> in
-     *             the <i>IAM User Guide</i>.</p>
-     *         <p>An administrator must grant you the permissions necessary to pass session tags. The
-     *             administrator can also create granular permissions to allow you to pass only specific
-     *             session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using
-     *                 Tags for Attribute-Based Access Control</a> in the
-     *                 <i>IAM User Guide</i>.</p>
-     *         <p>Tag key–value pairs are not case sensitive, but case is preserved. This means that you
-     *             cannot have separate <code>Department</code> and <code>department</code> tag keys.
-     *             Assume that the user that you are federating has the
-     *                 <code>Department</code>=<code>Marketing</code> tag and you pass the
-     *                 <code>department</code>=<code>engineering</code> session tag.
-     *                 <code>Department</code> and <code>department</code> are not saved as separate tags,
-     *             and the session tag passed in the request takes precedence over the user tag.</p>
+     *          <note>
+     *             <p>You can create a mobile-based or browser-based app that can authenticate users using
+     *             a web identity provider like Login with Amazon, Facebook, Google, or an OpenID
+     *             Connect-compatible identity provider. In this case, we recommend that you use <a href="http://aws.amazon.com/cognito/">Amazon Cognito</a> or
+     *                <code>AssumeRoleWithWebIdentity</code>. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_assumerolewithwebidentity">Federation Through a Web-based Identity Provider</a> in the
+     *                <i>IAM User Guide</i>.</p>
+     *          </note>
+     *          <p>An administrator must grant you the permissions necessary to pass session tags. The
+     *          administrator can also create granular permissions to allow you to pass only specific
+     *          session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using Tags
+     *             for Attribute-Based Access Control</a> in the
+     *          <i>IAM User Guide</i>.</p>
+     *          <p>Tag key–value pairs are not case sensitive, but case is preserved. This means that you
+     *          cannot have separate <code>Department</code> and <code>department</code> tag keys. Assume
+     *          that the user that you are federating has the
+     *             <code>Department</code>=<code>Marketing</code> tag and you pass the
+     *             <code>department</code>=<code>engineering</code> session tag. <code>Department</code>
+     *          and <code>department</code> are not saved as separate tags, and the session tag passed in
+     *          the request takes precedence over the user tag.</p>
      */
     getFederationToken(args: GetFederationTokenCommandInput, options?: __HttpHandlerOptions): Promise<GetFederationTokenCommandOutput>;
     getFederationToken(args: GetFederationTokenCommandInput, cb: (err: any, data?: GetFederationTokenCommandOutput) => void): void;
@@ -618,7 +571,7 @@ export declare class STS extends STSClient {
      *          the API returns an access denied error. For a comparison of <code>GetSessionToken</code>
      *          with the other API operations that produce temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting
      *             Temporary Security Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
-     *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+     *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
      *          <p>
      *             <b>Session Duration</b>
      *          </p>

package/dist-types/commands/AssumeRoleCommand.d.ts

@@ -8,20 +8,19 @@ export interface AssumeRoleCommandOutput extends AssumeRoleResponse, __MetadataB
 }
 /**
  * <p>Returns a set of temporary security credentials that you can use to access Amazon Web Services
- *             resources that you might not normally have access to. These temporary credentials
- *             consist of an access key ID, a secret access key, and a security token. Typically, you
- *             use <code>AssumeRole</code> within your account or for cross-account access. For a
- *             comparison of <code>AssumeRole</code> with other API operations that produce temporary
- *             credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
- *                 Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing
- *                 the STS API operations</a> in the
- *             <i>IAM User Guide</i>.</p>
+ *          resources that you might not normally have access to. These temporary credentials consist
+ *          of an access key ID, a secret access key, and a security token. Typically, you use
+ *             <code>AssumeRole</code> within your account or for cross-account access. For a
+ *          comparison of <code>AssumeRole</code> with other API operations that produce temporary
+ *          credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
+ *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
+ *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
  *          <p>
  *             <b>Permissions</b>
  *          </p>
  *          <p>The temporary security credentials created by <code>AssumeRole</code> can be used to
  *          make API calls to any Amazon Web Services service with the following exception: You cannot call the
- *          STS <code>GetFederationToken</code> or <code>GetSessionToken</code> API
+ *          Amazon Web Services STS <code>GetFederationToken</code> or <code>GetSessionToken</code> API
  *          operations.</p>
  *          <p>(Optional) You can pass inline or managed <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">session policies</a> to
  *          this operation. You can pass a single JSON policy document to use as an inline session
@@ -35,28 +34,35 @@ export interface AssumeRoleCommandOutput extends AssumeRoleResponse, __MetadataB
  *          by the identity-based policy of the role that is being assumed. For more information, see
  *             <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">Session
  *             Policies</a> in the <i>IAM User Guide</i>.</p>
- *          <p>To assume a role from a different account, your account must be trusted by the
+ *          <p>When you create a role, you create two policies: A role trust policy that specifies
+ *          <i>who</i> can assume the role and a permissions policy that specifies
+ *          <i>what</i> can be done with the role. You specify the trusted principal
+ *          who is allowed to assume the role in the role trust policy.</p>
+ *          <p>To assume a role from a different account, your Amazon Web Services account must be trusted by the
  *          role. The trust relationship is defined in the role's trust policy when the role is
  *          created. That trust policy states which accounts are allowed to delegate that access to
  *          users in the account. </p>
  *          <p>A user who wants to access a role in a different account must also have permissions that
  *          are delegated from the user account administrator. The administrator must attach a policy
  *          that allows the user to call <code>AssumeRole</code> for the ARN of the role in the other
- *          account. If the user is in the same account as the role, then you can do either of the
+ *          account.</p>
+ *          <p>To allow a user to assume a role in the same account, you can do either of the
  *          following:</p>
  *          <ul>
  *             <li>
- *                <p>Attach a policy to the user (identical to the previous user in a different
- *                account).</p>
+ *                <p>Attach a policy to the user that allows the user to call
+ *                <code>AssumeRole</code> (as long as the role's trust policy trusts the account).</p>
  *             </li>
  *             <li>
  *                <p>Add the user as a principal directly in the role's trust policy.</p>
  *             </li>
  *          </ul>
- *          <p>In this case, the trust policy acts as an IAM resource-based policy. Users in the same
- *          account as the role do not need explicit permission to assume the role. For more
- *          information about trust policies and resource-based policies, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">IAM Policies</a> in
- *          the <i>IAM User Guide</i>.</p>
+ *          <p>You can do either because the role’s trust policy acts as an IAM resource-based
+ *          policy. When a resource-based policy grants access to a principal in the same account, no
+ *          additional identity-based policy is required. For more information about trust policies and
+ *          resource-based policies, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">IAM Policies</a> in the
+ *             <i>IAM User Guide</i>.</p>
+ *
  *          <p>
  *             <b>Tags</b>
  *          </p>

package/dist-types/commands/AssumeRoleWithSAMLCommand.d.ts

@@ -13,7 +13,7 @@ export interface AssumeRoleWithSAMLCommandOutput extends AssumeRoleWithSAMLRespo
  *          credentials or configuration. For a comparison of <code>AssumeRoleWithSAML</code> with the
  *          other API operations that produce temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
  *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
- *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+ *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
  *          <p>The temporary security credentials returned by this operation consist of an access key
  *          ID, a secret access key, and a security token. Applications can use these temporary
  *          security credentials to sign calls to Amazon Web Services services.</p>
@@ -35,15 +35,15 @@ export interface AssumeRoleWithSAMLCommandOutput extends AssumeRoleWithSAMLRespo
  *          console URL. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html">Using IAM Roles</a> in the
  *             <i>IAM User Guide</i>.</p>
  *          <note>
- *            <p>
- *                <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-role-chaining">Role chaining</a> limits your CLI or Amazon Web Services API
- *                role session to a maximum of one hour. When you use the <code>AssumeRole</code> API
- *                operation to assume a role, you can specify the duration of your role session with
- *                the <code>DurationSeconds</code> parameter. You can specify a parameter value of up
- *                to 43200 seconds (12 hours), depending on the maximum session duration setting for
- *                your role. However, if you assume a role using role chaining and provide a
- *                <code>DurationSeconds</code> parameter value greater than one hour, the
- *                operation fails.</p>
+ *             <p>
+ *                <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-role-chaining">Role chaining</a> limits your CLI or Amazon Web Services API role
+ *             session to a maximum of one hour. When you use the <code>AssumeRole</code> API operation
+ *             to assume a role, you can specify the duration of your role session with the
+ *                <code>DurationSeconds</code> parameter. You can specify a parameter value of up to
+ *             43200 seconds (12 hours), depending on the maximum session duration setting for your
+ *             role. However, if you assume a role using role chaining and provide a
+ *                <code>DurationSeconds</code> parameter value greater than one hour, the operation
+ *             fails.</p>
  *          </note>
  *          <p>
  *             <b>Permissions</b>
@@ -95,9 +95,9 @@ export interface AssumeRoleWithSAMLCommandOutput extends AssumeRoleWithSAMLRespo
  *             request are to the upper size limit.
  *             </p>
  *          </note>
- *          <p>You can pass a session tag with the same key as a tag that is
- *          attached to the role. When you do, session tags override the role's tags with the same
- *          key.</p>
+ *
+ *          <p>You can pass a session tag with the same key as a tag that is attached to the role. When
+ *          you do, session tags override the role's tags with the same key.</p>
  *          <p>An administrator must grant you the permissions necessary to pass session tags. The
  *          administrator can also create granular permissions to allow you to pass only specific
  *          session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using Tags

package/dist-types/commands/AssumeRoleWithWebIdentityCommand.d.ts

@@ -29,7 +29,7 @@ export interface AssumeRoleWithWebIdentityCommandOutput extends AssumeRoleWithWe
  *             <code>AssumeRoleWithWebIdentity</code> with the other API operations that produce
  *          temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
  *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
- *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+ *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
  *          <p>The temporary security credentials returned by this API consist of an access key ID, a
  *          secret access key, and a security token. Applications can use these temporary security
  *          credentials to sign calls to Amazon Web Services service API operations.</p>
@@ -87,9 +87,9 @@ export interface AssumeRoleWithWebIdentityCommandOutput extends AssumeRoleWithWe
  *             request are to the upper size limit.
  *             </p>
  *          </note>
- *          <p>You can pass a session tag with the same key as a tag that is
- *          attached to the role. When you do, the session tag overrides the role tag with the same
- *          key.</p>
+ *
+ *          <p>You can pass a session tag with the same key as a tag that is attached to the role. When
+ *          you do, the session tag overrides the role tag with the same key.</p>
  *          <p>An administrator must grant you the permissions necessary to pass session tags. The
  *          administrator can also create granular permissions to allow you to pass only specific
  *          session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using Tags

package/dist-types/commands/DecodeAuthorizationMessageCommand.d.ts

@@ -18,9 +18,9 @@ export interface DecodeAuthorizationMessageCommandOutput extends DecodeAuthoriza
  *             documentation for an individual operation indicates whether that operation returns an
  *             encoded message in addition to returning an HTTP code.</p>
  *          </note>
- *          <p>The message is encoded because the details of the authorization status can constitute
+ *          <p>The message is encoded because the details of the authorization status can contain
  *          privileged information that the user who requested the operation should not see. To decode
- *          an authorization status message, a user must be granted permissions via an IAM policy to
+ *          an authorization status message, a user must be granted permissions through an IAM <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">policy</a> to
  *          request the <code>DecodeAuthorizationMessage</code>
  *             (<code>sts:DecodeAuthorizationMessage</code>) action. </p>
  *          <p>The decoded message includes the following type of information:</p>

package/dist-types/commands/GetAccessKeyInfoCommand.d.ts

@@ -8,23 +8,23 @@ export interface GetAccessKeyInfoCommandOutput extends GetAccessKeyInfoResponse,
 }
 /**
  * <p>Returns the account identifier for the specified access key ID.</p>
- *         <p>Access keys consist of two parts: an access key ID (for example,
- *                 <code>AKIAIOSFODNN7EXAMPLE</code>) and a secret access key (for example,
- *                 <code>wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY</code>). For more information about
- *             access keys, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html">Managing Access Keys for IAM
- *                 Users</a> in the <i>IAM User Guide</i>.</p>
- *         <p>When you pass an access key ID to this operation, it returns the ID of the Amazon Web Services
- *             account to which the keys belong. Access key IDs beginning with <code>AKIA</code> are
- *             long-term credentials for an IAM user or the Amazon Web Services account root user. Access key IDs
- *             beginning with <code>ASIA</code> are temporary credentials that are created using STS
- *             operations. If the account in the response belongs to you, you can sign in as the root
- *             user and review your root user access keys. Then, you can pull a <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_getting-report.html">credentials report</a> to learn which IAM user owns the keys. To learn who
- *             requested the temporary credentials for an <code>ASIA</code> access key, view the STS
- *             events in your <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html">CloudTrail logs</a> in the
- *                 <i>IAM User Guide</i>.</p>
- *         <p>This operation does not indicate the state of the access key. The key might be active,
- *             inactive, or deleted. Active keys might not have permissions to perform an operation.
- *             Providing a deleted access key might return an error that the key doesn't exist.</p>
+ *          <p>Access keys consist of two parts: an access key ID (for example,
+ *             <code>AKIAIOSFODNN7EXAMPLE</code>) and a secret access key (for example,
+ *             <code>wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY</code>). For more information about
+ *          access keys, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html">Managing Access Keys for IAM
+ *             Users</a> in the <i>IAM User Guide</i>.</p>
+ *          <p>When you pass an access key ID to this operation, it returns the ID of the Amazon Web Services account
+ *          to which the keys belong. Access key IDs beginning with <code>AKIA</code> are long-term
+ *          credentials for an IAM user or the Amazon Web Services account root user. Access key IDs beginning with
+ *             <code>ASIA</code> are temporary credentials that are created using STS operations. If
+ *          the account in the response belongs to you, you can sign in as the root user and review
+ *          your root user access keys. Then, you can pull a <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_getting-report.html">credentials report</a> to
+ *          learn which IAM user owns the keys. To learn who requested the temporary credentials for
+ *          an <code>ASIA</code> access key, view the STS events in your <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html">CloudTrail logs</a> in the
+ *             <i>IAM User Guide</i>.</p>
+ *          <p>This operation does not indicate the state of the access key. The key might be active,
+ *          inactive, or deleted. Active keys might not have permissions to perform an operation.
+ *          Providing a deleted access key might return an error that the key doesn't exist.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetCallerIdentityCommand.d.ts

@@ -8,15 +8,15 @@ export interface GetCallerIdentityCommandOutput extends GetCallerIdentityRespons
 }
 /**
  * <p>Returns details about the IAM user or role whose credentials are used to call the
- *             operation.</p>
- *         <note>
+ *          operation.</p>
+ *          <note>
  *             <p>No permissions are required to perform this operation. If an administrator adds a
- *                 policy to your IAM user or role that explicitly denies access to the
- *                     <code>sts:GetCallerIdentity</code> action, you can still perform this operation.
- *                 Permissions are not required because the same information is returned when an IAM
- *                 user or role is denied access. To view an example response, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_general.html#troubleshoot_general_access-denied-delete-mfa">I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice</a> in the
- *                     <i>IAM User Guide</i>.</p>
- *         </note>
+ *             policy to your IAM user or role that explicitly denies access to the
+ *                <code>sts:GetCallerIdentity</code> action, you can still perform this operation.
+ *             Permissions are not required because the same information is returned when an IAM user
+ *             or role is denied access. To view an example response, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_general.html#troubleshoot_general_access-denied-delete-mfa">I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice</a> in the
+ *                <i>IAM User Guide</i>.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetFederationTokenCommand.d.ts

@@ -16,7 +16,7 @@ export interface GetFederationTokenCommandOutput extends GetFederationTokenRespo
  *          server-based application. For a comparison of <code>GetFederationToken</code> with the
  *          other API operations that produce temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting Temporary Security
  *             Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
- *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+ *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
  *          <note>
  *             <p>You can create a mobile-based or browser-based app that can authenticate users using
  *             a web identity provider like Login with Amazon, Facebook, Google, or an OpenID
@@ -35,8 +35,8 @@ export interface GetFederationTokenCommandOutput extends GetFederationTokenRespo
  *          </p>
  *          <p>The temporary credentials are valid for the specified duration, from 900 seconds (15
  *          minutes) up to a maximum of 129,600 seconds (36 hours). The default session duration is
- *          43,200 seconds (12 hours). Temporary credentials that are obtained by using Amazon Web Services account
- *          root user credentials have a maximum duration of 3,600 seconds (1 hour).</p>
+ *          43,200 seconds (12 hours). Temporary credentials obtained by using the Amazon Web Services account root
+ *          user credentials have a maximum duration of 3,600 seconds (1 hour).</p>
  *          <p>
  *             <b>Permissions</b>
  *          </p>
@@ -74,78 +74,25 @@ export interface GetFederationTokenCommandOutput extends GetFederationTokenRespo
  *          <p>(Optional) You can pass tag key-value pairs to your session. These are called session
  *          tags. For more information about session tags, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Passing Session Tags in STS</a> in the
  *             <i>IAM User Guide</i>.</p>
- *         <note>
- *             <p>You can create a mobile-based or browser-based app that can authenticate users
- *                 using a web identity provider like Login with Amazon, Facebook, Google, or an OpenID
- *                 Connect-compatible identity provider. In this case, we recommend that you use <a href="http://aws.amazon.com/cognito/">Amazon Cognito</a> or
- *                     <code>AssumeRoleWithWebIdentity</code>. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_assumerolewithwebidentity">Federation Through a Web-based Identity Provider</a> in the
- *                     <i>IAM User Guide</i>.</p>
- *         </note>
- *         <p>You can also call <code>GetFederationToken</code> using the security credentials of an
- *             Amazon Web Services account root user, but we do not recommend it. Instead, we recommend that you
- *             create an IAM user for the purpose of the proxy application. Then attach a policy to
- *             the IAM user that limits federated users to only the actions and resources that they
- *             need to access. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html">IAM Best Practices</a> in the
- *                 <i>IAM User Guide</i>. </p>
- *         <p>
- *             <b>Session duration</b>
- *          </p>
- *         <p>The temporary credentials are valid for the specified duration, from 900 seconds (15
- *             minutes) up to a maximum of 129,600 seconds (36 hours). The default session duration is
- *             43,200 seconds (12 hours). Temporary credentials that are obtained by using Amazon Web Services
- *             account root user credentials have a maximum duration of 3,600 seconds (1 hour).</p>
- *         <p>
- *             <b>Permissions</b>
- *         </p>
- *         <p>You can use the temporary credentials created by <code>GetFederationToken</code> in
- *             any Amazon Web Services service except the following:</p>
- *         <ul>
- *             <li>
- *                 <p>You cannot call any IAM operations using the CLI or the Amazon Web Services API.
- *                 </p>
- *             </li>
- *             <li>
- *                 <p>You cannot call any STS operations except
- *                     <code>GetCallerIdentity</code>.</p>
- *             </li>
- *          </ul>
- *         <p>You must pass an inline or managed <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">session policy</a> 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 can't
- *             exceed 2,048 characters.</p>
- *         <p>Though the session policy parameters are optional, if you do not pass a policy, then
- *             the resulting federated user session has no permissions. 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
- *                 <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session">Session Policies</a>
- *             in the <i>IAM User Guide</i>. For information about using
- *                 <code>GetFederationToken</code> to create temporary security credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_getfederationtoken">GetFederationToken—Federation Through a Custom Identity Broker</a>. </p>
- *         <p>You can use the credentials to access a resource that has a resource-based policy. If
- *             that policy specifically references the federated user session in the
- *                 <code>Principal</code> element of the policy, the session has the permissions
- *             allowed by the policy. These permissions are granted in addition to the permissions
- *             granted by the session policies.</p>
- *         <p>
- *             <b>Tags</b>
- *          </p>
- *         <p>(Optional) You can pass tag key-value pairs to your session. These are called session
- *             tags. For more information about session tags, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Passing Session Tags in STS</a> in
- *             the <i>IAM User Guide</i>.</p>
- *         <p>An administrator must grant you the permissions necessary to pass session tags. The
- *             administrator can also create granular permissions to allow you to pass only specific
- *             session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using
- *                 Tags for Attribute-Based Access Control</a> in the
- *                 <i>IAM User Guide</i>.</p>
- *         <p>Tag key–value pairs are not case sensitive, but case is preserved. This means that you
- *             cannot have separate <code>Department</code> and <code>department</code> tag keys.
- *             Assume that the user that you are federating has the
- *                 <code>Department</code>=<code>Marketing</code> tag and you pass the
- *                 <code>department</code>=<code>engineering</code> session tag.
- *                 <code>Department</code> and <code>department</code> are not saved as separate tags,
- *             and the session tag passed in the request takes precedence over the user tag.</p>
+ *          <note>
+ *             <p>You can create a mobile-based or browser-based app that can authenticate users using
+ *             a web identity provider like Login with Amazon, Facebook, Google, or an OpenID
+ *             Connect-compatible identity provider. In this case, we recommend that you use <a href="http://aws.amazon.com/cognito/">Amazon Cognito</a> or
+ *                <code>AssumeRoleWithWebIdentity</code>. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#api_assumerolewithwebidentity">Federation Through a Web-based Identity Provider</a> in the
+ *                <i>IAM User Guide</i>.</p>
+ *          </note>
+ *          <p>An administrator must grant you the permissions necessary to pass session tags. The
+ *          administrator can also create granular permissions to allow you to pass only specific
+ *          session tags. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html">Tutorial: Using Tags
+ *             for Attribute-Based Access Control</a> in the
+ *          <i>IAM User Guide</i>.</p>
+ *          <p>Tag key–value pairs are not case sensitive, but case is preserved. This means that you
+ *          cannot have separate <code>Department</code> and <code>department</code> tag keys. Assume
+ *          that the user that you are federating has the
+ *             <code>Department</code>=<code>Marketing</code> tag and you pass the
+ *             <code>department</code>=<code>engineering</code> session tag. <code>Department</code>
+ *          and <code>department</code> are not saved as separate tags, and the session tag passed in
+ *          the request takes precedence over the user tag.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetSessionTokenCommand.d.ts

@@ -18,7 +18,7 @@ export interface GetSessionTokenCommandOutput extends GetSessionTokenResponse, _
  *          the API returns an access denied error. For a comparison of <code>GetSessionToken</code>
  *          with the other API operations that produce temporary credentials, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html">Requesting
  *             Temporary Security Credentials</a> and <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html#stsapi_comparison">Comparing the
- *             STS API operations</a> in the <i>IAM User Guide</i>.</p>
+ *             Amazon Web Services STS API operations</a> in the <i>IAM User Guide</i>.</p>
  *          <p>
  *             <b>Session Duration</b>
  *          </p>

package/dist-types/models/models_0.d.ts

@@ -43,7 +43,7 @@ export declare namespace PolicyDescriptorType {
 /**
  * <p>You can pass custom key-value pair attributes when you assume a role or federate a user.
  *          These are called session tags. You can then use the session tags to control access to
- *          resources. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Tagging STS Sessions</a> in the
+ *          resources. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Tagging Amazon Web Services STS Sessions</a> in the
  *             <i>IAM User Guide</i>.</p>
  */
 export interface Tag {
@@ -93,6 +93,7 @@ export interface AssumeRoleRequest {
      *          plaintext that you use for both inline and managed session policies can't exceed 2,048
      *          characters. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs) and Amazon Web Services
      *             Service Namespaces</a> in the Amazon Web Services General Reference.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -127,6 +128,7 @@ export interface AssumeRoleRequest {
      *          character to the end of the valid character list (\u0020 through \u00FF). It can also
      *          include the tab (\u0009), linefeed (\u000A), and carriage return (\u000D)
      *          characters.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -138,13 +140,19 @@ export interface AssumeRoleRequest {
      */
     Policy?: string;
     /**
-     * <p>The duration, in seconds, of the role session. The value specified can can range from
-     *          900 seconds (15 minutes) up to the maximum session duration that is set for the role. The
-     *          maximum session duration setting can have a value from 1 hour to 12 hours. If you specify a
-     *          value higher than this setting or the administrator setting (whichever is lower), the
-     *          operation fails. For example, if you specify a session duration of 12 hours, but your
-     *          administrator set the maximum session duration to 6 hours, your operation fails. To learn
-     *          how to view the maximum value for your role, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session">View the
+     * <p>The duration, in seconds, of the role session. The value specified can range from 900
+     *          seconds (15 minutes) up to the maximum session duration set for the role. The maximum
+     *          session duration setting can have a value from 1 hour to 12 hours. If you specify a value
+     *          higher than this setting or the administrator setting (whichever is lower), the operation
+     *          fails. For example, if you specify a session duration of 12 hours, but your administrator
+     *          set the maximum session duration to 6 hours, your operation fails. </p>
+     *          <p>Role chaining limits your Amazon Web Services CLI or Amazon Web Services API role session to a maximum of one hour.
+     *          When you use the <code>AssumeRole</code> API operation to assume a role, you can specify
+     *          the duration of your role session with the <code>DurationSeconds</code> parameter. You can
+     *          specify a parameter value of up to 43200 seconds (12 hours), depending on the maximum
+     *          session duration setting for your role. However, if you assume a role using role chaining
+     *          and provide a <code>DurationSeconds</code> parameter value greater than one hour, the
+     *          operation fails. To learn how to view the maximum value for your role, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session">View the
      *             Maximum Session Duration Setting for a Role</a> in the
      *             <i>IAM User Guide</i>.</p>
      *          <p>By default, the value is set to <code>3600</code> seconds. </p>
@@ -154,14 +162,14 @@ export interface AssumeRoleRequest {
      *             federation endpoint for a console sign-in token takes a <code>SessionDuration</code>
      *             parameter that specifies the maximum length of the console session. For more
      *             information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html">Creating a URL
-     *                that Enables Federated Users to Access the Management Console</a> in the
+     *                that Enables Federated Users to Access the Amazon Web Services Management Console</a> in the
      *                <i>IAM User Guide</i>.</p>
      *          </note>
      */
     DurationSeconds?: number;
     /**
      * <p>A list of session tags that you want to pass. Each session tag consists of a key name
-     *          and an associated value. For more information about session tags, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Tagging STS
+     *          and an associated value. For more information about session tags, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Tagging Amazon Web Services STS
      *             Sessions</a> in the <i>IAM User Guide</i>.</p>
      *          <p>This parameter is optional. You can pass up to 50 session tags. The plaintext session
      *          tag keys can’t exceed 128 characters, and the values can’t exceed 256 characters. For these
@@ -176,8 +184,9 @@ export interface AssumeRoleRequest {
      *             request are to the upper size limit.
      *             </p>
      *          </note>
-     *          <p>You can pass a session tag with the same key as a tag that is already
-     *          attached to the role. When you do, session tags override a role tag with the same key. </p>
+     *
+     *          <p>You can pass a session tag with the same key as a tag that is already attached to the
+     *          role. When you do, session tags override a role tag with the same key. </p>
      *          <p>Tag key–value pairs are not case sensitive, but case is preserved. This means that you
      *          cannot have separate <code>Department</code> and <code>department</code> tag keys. Assume
      *          that the role has the <code>Department</code>=<code>Marketing</code> tag and you pass the
@@ -253,8 +262,7 @@ export interface AssumeRoleRequest {
      *          <p>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: =,.@-. You cannot use a value that begins with the text
-     *          <code>aws:</code>. This prefix is reserved for Amazon Web Services internal
-     *          use.</p>
+     *             <code>aws:</code>. This prefix is reserved for Amazon Web Services internal use.</p>
      */
     SourceIdentity?: string;
 }
@@ -300,6 +308,7 @@ export interface AssumeRoleResponse {
     /**
      * <p>The temporary security credentials, which include an access key ID, a secret access key,
      *          and a security (or session) token.</p>
+     *
      *          <note>
      *             <p>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.</p>
@@ -381,7 +390,7 @@ export declare namespace MalformedPolicyDocumentException {
  *             tags are to the upper size limit. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_session-tags.html">Passing Session Tags in STS</a> in
  *             the <i>IAM User Guide</i>.</p>
  *         <p>You could receive this error even though you meet other defined session policy and
- *             session tag limits. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html">IAM and STS Entity
+ *             session tag limits. For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html#reference_iam-limits-entity-length">IAM and STS Entity
  *                 Character Limits</a> in the <i>IAM User Guide</i>.</p>
  */
 export interface PackedPolicyTooLargeException extends __SmithyException, $MetadataBearer {
@@ -436,6 +445,7 @@ export interface AssumeRoleWithSAMLRequest {
      *          plaintext that you use for both inline and managed session policies can't exceed 2,048
      *          characters. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs) and Amazon Web Services
      *             Service Namespaces</a> in the Amazon Web Services General Reference.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -470,6 +480,7 @@ export interface AssumeRoleWithSAMLRequest {
      *          character to the end of the valid character list (\u0020 through \u00FF). It can also
      *          include the tab (\u0009), linefeed (\u000A), and carriage return (\u000D)
      *          characters.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -499,7 +510,7 @@ export interface AssumeRoleWithSAMLRequest {
      *             federation endpoint for a console sign-in token takes a <code>SessionDuration</code>
      *             parameter that specifies the maximum length of the console session. For more
      *             information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html">Creating a URL
-     *                that Enables Federated Users to Access the Management Console</a> in the
+     *                that Enables Federated Users to Access the Amazon Web Services Management Console</a> in the
      *                <i>IAM User Guide</i>.</p>
      *          </note>
      */
@@ -519,6 +530,7 @@ export interface AssumeRoleWithSAMLResponse {
     /**
      * <p>The temporary security credentials, which include an access key ID, a secret access key,
      *          and a security (or session) token.</p>
+     *
      *          <note>
      *             <p>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.</p>
@@ -678,6 +690,7 @@ export interface AssumeRoleWithWebIdentityRequest {
      *          plaintext that you use for both inline and managed session policies can't exceed 2,048
      *          characters. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs) and Amazon Web Services
      *             Service Namespaces</a> in the Amazon Web Services General Reference.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -712,6 +725,7 @@ export interface AssumeRoleWithWebIdentityRequest {
      *          character to the end of the valid character list (\u0020 through \u00FF). It can also
      *          include the tab (\u0009), linefeed (\u000A), and carriage return (\u000D)
      *          characters.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -738,7 +752,7 @@ export interface AssumeRoleWithWebIdentityRequest {
      *             federation endpoint for a console sign-in token takes a <code>SessionDuration</code>
      *             parameter that specifies the maximum length of the console session. For more
      *             information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-custom-url.html">Creating a URL
-     *                that Enables Federated Users to Access the Management Console</a> in the
+     *                that Enables Federated Users to Access the Amazon Web Services Management Console</a> in the
      *                <i>IAM User Guide</i>.</p>
      *          </note>
      */
@@ -758,6 +772,7 @@ export interface AssumeRoleWithWebIdentityResponse {
     /**
      * <p>The temporary security credentials, which include an access key ID, a secret access key,
      *          and a security token.</p>
+     *
      *          <note>
      *             <p>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.</p>
@@ -863,7 +878,7 @@ export declare namespace DecodeAuthorizationMessageRequest {
  */
 export interface DecodeAuthorizationMessageResponse {
     /**
-     * <p>An XML document that contains the decoded message.</p>
+     * <p>The API returns a response with the decoded message.</p>
      */
     DecodedMessage?: string;
 }
@@ -892,8 +907,8 @@ export declare namespace InvalidAuthorizationMessageException {
 export interface GetAccessKeyInfoRequest {
     /**
      * <p>The identifier of an access key.</p>
-     *         <p>This parameter allows (through its regex pattern) a string of characters that can
-     *             consist of any upper- or lowercase letter or digit.</p>
+     *          <p>This parameter allows (through its regex pattern) a string of characters that can
+     *          consist of any upper- or lowercase letter or digit.</p>
      */
     AccessKeyId: string | undefined;
 }
@@ -985,6 +1000,7 @@ export interface GetFederationTokenRequest {
      *          character to the end of the valid character list (\u0020 through \u00FF). It can also
      *          include the tab (\u0009), linefeed (\u000A), and carriage return (\u000D)
      *          characters.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -1005,7 +1021,8 @@ export interface GetFederationTokenRequest {
      *          The plaintext that you use for both inline and managed session policies can't exceed 2,048
      *          characters. You can provide up to 10 managed policy ARNs. For more information about ARNs,
      *          see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon
-     *             Resource Names (ARNs) and Amazon Web Services Service Namespaces</a> in the Amazon Web Services General Reference.</p>
+     *             Resource Names (ARNs) and Amazon Web Services Service Namespaces</a> in the
+     *          Amazon Web Services General Reference.</p>
      *          <p>This parameter is optional. However, if you do not pass any session policies, then the
      *          resulting federated user session has no permissions.</p>
      *          <p>When you pass session policies, the session permissions are the intersection of the
@@ -1019,6 +1036,7 @@ export interface GetFederationTokenRequest {
      *             <code>Principal</code> element of the policy, the session has the permissions allowed by
      *          the policy. These permissions are granted in addition to the permissions that are granted
      *          by the session policies.</p>
+     *
      *          <note>
      *             <p>An Amazon Web Services conversion compresses the passed session policies and session tags into a
      *             packed binary format that has a separate limit. Your request can fail for this limit
@@ -1055,9 +1073,9 @@ export interface GetFederationTokenRequest {
      *             request are to the upper size limit.
      *             </p>
      *          </note>
-     *          <p>You can pass a session tag with the same key as a tag that is already
-     *          attached to the user you are federating. When you do, session tags override a user tag with
-     *          the same key. </p>
+     *
+     *          <p>You can pass a session tag with the same key as a tag that is already attached to the
+     *          user you are federating. When you do, session tags override a user tag with the same key. </p>
      *          <p>Tag key–value pairs are not case sensitive, but case is preserved. This means that you
      *          cannot have separate <code>Department</code> and <code>department</code> tag keys. Assume
      *          that the role has the <code>Department</code>=<code>Marketing</code> tag and you pass the
@@ -1103,6 +1121,7 @@ export interface GetFederationTokenResponse {
     /**
      * <p>The temporary security credentials, which include an access key ID, a secret access key,
      *          and a security (or session) token.</p>
+     *
      *          <note>
      *             <p>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.</p>
@@ -1131,34 +1150,34 @@ export declare namespace GetFederationTokenResponse {
 }
 export interface GetSessionTokenRequest {
     /**
-     * <p>The duration, in seconds, that the credentials should remain valid. Acceptable
-     *             durations for IAM user sessions range from 900 seconds (15 minutes) to 129,600 seconds
-     *             (36 hours), with 43,200 seconds (12 hours) as the default. Sessions for Amazon Web Services account
-     *             owners are restricted to a maximum of 3,600 seconds (one hour). If the duration is
-     *             longer than one hour, the session for Amazon Web Services account owners defaults to one hour.</p>
+     * <p>The duration, in seconds, that the credentials should remain valid. Acceptable durations
+     *          for IAM user sessions range from 900 seconds (15 minutes) to 129,600 seconds (36 hours),
+     *          with 43,200 seconds (12 hours) as the default. Sessions for Amazon Web Services account owners are
+     *          restricted to a maximum of 3,600 seconds (one hour). If the duration is longer than one
+     *          hour, the session for Amazon Web Services account owners defaults to one hour.</p>
      */
     DurationSeconds?: number;
     /**
      * <p>The identification number of the MFA device that is associated with the IAM user who
-     *             is making the <code>GetSessionToken</code> call. Specify this value if the IAM user
-     *             has a policy that requires MFA authentication. The value is either the serial number for
-     *             a hardware device (such as <code>GAHT12345678</code>) or an Amazon Resource Name (ARN)
-     *             for a virtual device (such as <code>arn:aws:iam::123456789012:mfa/user</code>). You can
-     *             find the device for an IAM user by going to the Management Console and viewing the user's
-     *             security credentials. </p>
-     *         <p>The regex used to validate this parameter is a string of
+     *          is making the <code>GetSessionToken</code> call. Specify this value if the IAM user has a
+     *          policy that requires MFA authentication. The value is either the serial number for a
+     *          hardware device (such as <code>GAHT12345678</code>) or an Amazon Resource Name (ARN) for a
+     *          virtual device (such as <code>arn:aws:iam::123456789012:mfa/user</code>). You can find the
+     *          device for an IAM user by going to the Amazon Web Services Management Console and viewing the user's security
+     *          credentials. </p>
+     *          <p>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: =,.@:/-</p>
      */
     SerialNumber?: string;
     /**
      * <p>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,
-     *             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.</p>
-     *         <p>The format for this parameter, as described by its regex pattern, is a sequence of six
-     *             numeric digits.</p>
+     *          IAM user to submit an MFA code, specify this 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.</p>
+     *          <p>The format for this parameter, as described by its regex pattern, is a sequence of six
+     *          numeric digits.</p>
      */
     TokenCode?: string;
 }
@@ -1174,8 +1193,8 @@ export declare namespace GetSessionTokenRequest {
  */
 export interface GetSessionTokenResponse {
     /**
-     * <p>The temporary security credentials, which include an access key ID, a secret access
-     *             key, and a security (or session) token.</p>
+     * <p>The temporary security credentials, which include an access key ID, a secret access key,
+     *          and a security (or session) token.</p>
      *
      *          <note>
      *             <p>The size of the security token that STS API operations return is not fixed. We

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-sts",
   "description": "AWS SDK for JavaScript Sts Client for Node.js, Browser and React Native",
-  "version": "3.42.0",
+  "version": "3.43.0",
   "scripts": {
     "build": "yarn build:cjs && yarn build:es && yarn build:types",
     "build:cjs": "tsc -p tsconfig.json",