aws-sdk-core 3.186.0 → 3.187.0

data/lib/aws-sdk-ssooidc/errors.rb

@@ -35,6 +35,7 @@ module Aws::SSOOIDC
   # * {InvalidClientMetadataException}
   # * {InvalidGrantException}
   # * {InvalidRequestException}
+  # * {InvalidRequestRegionException}
   # * {InvalidScopeException}
   # * {SlowDownException}
   # * {UnauthorizedClientException}
@@ -206,6 +207,36 @@ module Aws::SSOOIDC
       end
     end
 
+    class InvalidRequestRegionException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SSOOIDC::Types::InvalidRequestRegionException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def error
+        @data[:error]
+      end
+
+      # @return [String]
+      def error_description
+        @data[:error_description]
+      end
+
+      # @return [String]
+      def endpoint
+        @data[:endpoint]
+      end
+
+      # @return [String]
+      def region
+        @data[:region]
+      end
+    end
+
     class InvalidScopeException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-ssooidc/plugins/endpoints.rb

@@ -58,6 +58,8 @@ module Aws::SSOOIDC
           case context.operation_name
           when :create_token
             Aws::SSOOIDC::Endpoints::CreateToken.build(context)
+          when :create_token_with_iam
+            Aws::SSOOIDC::Endpoints::CreateTokenWithIAM.build(context)
           when :register_client
             Aws::SSOOIDC::Endpoints::RegisterClient.build(context)
           when :start_device_authorization

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

@@ -13,9 +13,13 @@ module Aws::SSOOIDC
     # You do not have sufficient access to perform this action.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `access_denied`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/AccessDeniedException AWS API Documentation
@@ -31,9 +35,13 @@ module Aws::SSOOIDC
     # session token is pending.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `authorization_pending`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/AuthorizationPendingException AWS API Documentation
@@ -46,8 +54,8 @@ module Aws::SSOOIDC
     end
 
     # @!attribute [rw] client_id
-    #   The unique identifier string for each client. This value should come
-    #   from the persisted result of the RegisterClient API.
+    #   The unique identifier string for the client or application. This
+    #   value comes from the result of the RegisterClient API.
     #   @return [String]
     #
     # @!attribute [rw] client_secret
@@ -56,38 +64,40 @@ module Aws::SSOOIDC
     #   @return [String]
     #
     # @!attribute [rw] grant_type
-    #   Supports grant types for the authorization code, refresh token, and
-    #   device code request. For device code requests, specify the following
-    #   value:
+    #   Supports the following OAuth grant types: Device Code and Refresh
+    #   Token. Specify either of the following values, depending on the
+    #   grant type that you want:
+    #
+    #   * Device Code - `urn:ietf:params:oauth:grant-type:device_code`
     #
-    #   `urn:ietf:params:oauth:grant-type:device_code `
+    #   * Refresh Token - `refresh_token`
     #
     #   For information about how to obtain the device code, see the
     #   StartDeviceAuthorization topic.
     #   @return [String]
     #
     # @!attribute [rw] device_code
-    #   Used only when calling this API for the device code grant type. This
-    #   short-term code is used to identify this authentication attempt.
-    #   This should come from an in-memory reference to the result of the
-    #   StartDeviceAuthorization API.
+    #   Used only when calling this API for the Device Code grant type. This
+    #   short-term code is used to identify this authorization request. This
+    #   comes from the result of the StartDeviceAuthorization API.
     #   @return [String]
     #
     # @!attribute [rw] code
-    #   The authorization code received from the authorization service. This
-    #   parameter is required to perform an authorization grant request to
-    #   get access to a token.
+    #   Used only when calling this API for the Authorization Code grant
+    #   type. The short-term code is used to identify this authorization
+    #   request. This grant type is currently unsupported for the
+    #   CreateToken API.
     #   @return [String]
     #
     # @!attribute [rw] refresh_token
-    #   Currently, `refreshToken` is not yet implemented and is not
-    #   supported. For more information about the features and limitations
-    #   of the current IAM Identity Center OIDC implementation, see
-    #   *Considerations for Using this Guide* in the [IAM Identity Center
-    #   OIDC API Reference][1].
+    #   Used only when calling this API for the Refresh Token grant type.
+    #   This token is used to refresh short-term tokens, such as the access
+    #   token, that might expire.
     #
-    #   The token used to obtain an access token in the event that the
-    #   access token is invalid or expired.
+    #   For more information about the features and limitations of the
+    #   current IAM Identity Center OIDC implementation, see *Considerations
+    #   for Using this Guide* in the [IAM Identity Center OIDC API
+    #   Reference][1].
     #
     #
     #
@@ -95,15 +105,17 @@ module Aws::SSOOIDC
     #   @return [String]
     #
     # @!attribute [rw] scope
-    #   The list of scopes that is defined by the client. Upon
-    #   authorization, this list is used to restrict permissions when
-    #   granting an access token.
+    #   The list of scopes for which authorization is requested. The access
+    #   token that is issued is limited to the scopes that are granted. If
+    #   this value is not specified, IAM Identity Center authorizes all
+    #   scopes that are configured for the client during the call to
+    #   RegisterClient.
     #   @return [Array<String>]
     #
     # @!attribute [rw] redirect_uri
-    #   The location of the application that will receive the authorization
-    #   code. Users authorize the service to send the request to this
-    #   location.
+    #   Used only when calling this API for the Authorization Code grant
+    #   type. This value specifies the location of the client or application
+    #   that has registered to receive the authorization code.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/CreateTokenRequest AWS API Documentation
@@ -117,18 +129,18 @@ module Aws::SSOOIDC
       :refresh_token,
       :scope,
       :redirect_uri)
-      SENSITIVE = []
+      SENSITIVE = [:client_secret, :refresh_token]
       include Aws::Structure
     end
 
     # @!attribute [rw] access_token
-    #   An opaque token to access IAM Identity Center resources assigned to
-    #   a user.
+    #   A bearer token to access AWS accounts and applications assigned to a
+    #   user.
     #   @return [String]
     #
     # @!attribute [rw] token_type
     #   Used to notify the client that the returned token is an access
-    #   token. The supported type is `BearerToken`.
+    #   token. The supported token type is `Bearer`.
     #   @return [String]
     #
     # @!attribute [rw] expires_in
@@ -136,44 +148,211 @@ module Aws::SSOOIDC
     #   @return [Integer]
     #
     # @!attribute [rw] refresh_token
-    #   Currently, `refreshToken` is not yet implemented and is not
-    #   supported. For more information about the features and limitations
-    #   of the current IAM Identity Center OIDC implementation, see
-    #   *Considerations for Using this Guide* in the [IAM Identity Center
-    #   OIDC API Reference][1].
-    #
     #   A token that, if present, can be used to refresh a previously issued
     #   access token that might have expired.
     #
+    #   For more information about the features and limitations of the
+    #   current IAM Identity Center OIDC implementation, see *Considerations
+    #   for Using this Guide* in the [IAM Identity Center OIDC API
+    #   Reference][1].
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html
     #   @return [String]
     #
     # @!attribute [rw] id_token
-    #   Currently, `idToken` is not yet implemented and is not supported.
+    #   The `idToken` is not implemented or supported. For more information
+    #   about the features and limitations of the current IAM Identity
+    #   Center OIDC implementation, see *Considerations for Using this
+    #   Guide* in the [IAM Identity Center OIDC API Reference][1].
+    #
+    #   A JSON Web Token (JWT) that identifies who is associated with the
+    #   issued access token.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/CreateTokenResponse AWS API Documentation
+    #
+    class CreateTokenResponse < Struct.new(
+      :access_token,
+      :token_type,
+      :expires_in,
+      :refresh_token,
+      :id_token)
+      SENSITIVE = [:access_token, :refresh_token, :id_token]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] client_id
+    #   The unique identifier string for the client or application. This
+    #   value is an application ARN that has OAuth grants configured.
+    #   @return [String]
+    #
+    # @!attribute [rw] grant_type
+    #   Supports the following OAuth grant types: Authorization Code,
+    #   Refresh Token, JWT Bearer, and Token Exchange. Specify one of the
+    #   following values, depending on the grant type that you want:
+    #
+    #   * Authorization Code - `authorization_code`
+    #
+    #   * Refresh Token - `refresh_token`
+    #
+    #   * JWT Bearer - `urn:ietf:params:oauth:grant-type:jwt-bearer`
+    #
+    #   * Token Exchange -
+    #   `urn:ietf:params:oauth:grant-type:token-exchange`
+    #   @return [String]
+    #
+    # @!attribute [rw] code
+    #   Used only when calling this API for the Authorization Code grant
+    #   type. This short-term code is used to identify this authorization
+    #   request. The code is obtained through a redirect from IAM Identity
+    #   Center to a redirect URI persisted in the Authorization Code
+    #   GrantOptions for the application.
+    #   @return [String]
+    #
+    # @!attribute [rw] refresh_token
+    #   Used only when calling this API for the Refresh Token grant type.
+    #   This token is used to refresh short-term tokens, such as the access
+    #   token, that might expire.
+    #
     #   For more information about the features and limitations of the
     #   current IAM Identity Center OIDC implementation, see *Considerations
     #   for Using this Guide* in the [IAM Identity Center OIDC API
     #   Reference][1].
     #
-    #   The identifier of the user that associated with the access token, if
-    #   present.
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html
+    #   @return [String]
+    #
+    # @!attribute [rw] assertion
+    #   Used only when calling this API for the JWT Bearer grant type. This
+    #   value specifies the JSON Web Token (JWT) issued by a trusted token
+    #   issuer. To authorize a trusted token issuer, configure the JWT
+    #   Bearer GrantOptions for the application.
+    #   @return [String]
+    #
+    # @!attribute [rw] scope
+    #   The list of scopes for which authorization is requested. The access
+    #   token that is issued is limited to the scopes that are granted. If
+    #   the value is not specified, IAM Identity Center authorizes all
+    #   scopes configured for the application, including the following
+    #   default scopes: `openid`, `aws`, `sts:identity_context`.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] redirect_uri
+    #   Used only when calling this API for the Authorization Code grant
+    #   type. This value specifies the location of the client or application
+    #   that has registered to receive the authorization code.
+    #   @return [String]
+    #
+    # @!attribute [rw] subject_token
+    #   Used only when calling this API for the Token Exchange grant type.
+    #   This value specifies the subject of the exchange. The value of the
+    #   subject token must be an access token issued by IAM Identity Center
+    #   to a different client or application. The access token must have
+    #   authorized scopes that indicate the requested application as a
+    #   target audience.
+    #   @return [String]
+    #
+    # @!attribute [rw] subject_token_type
+    #   Used only when calling this API for the Token Exchange grant type.
+    #   This value specifies the type of token that is passed as the subject
+    #   of the exchange. The following value is supported:
+    #
+    #   * Access Token - `urn:ietf:params:oauth:token-type:access_token`
+    #   @return [String]
+    #
+    # @!attribute [rw] requested_token_type
+    #   Used only when calling this API for the Token Exchange grant type.
+    #   This value specifies the type of token that the requester can
+    #   receive. The following values are supported:
+    #
+    #   * Access Token - `urn:ietf:params:oauth:token-type:access_token`
+    #
+    #   * Refresh Token - `urn:ietf:params:oauth:token-type:refresh_token`
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/CreateTokenWithIAMRequest AWS API Documentation
+    #
+    class CreateTokenWithIAMRequest < Struct.new(
+      :client_id,
+      :grant_type,
+      :code,
+      :refresh_token,
+      :assertion,
+      :scope,
+      :redirect_uri,
+      :subject_token,
+      :subject_token_type,
+      :requested_token_type)
+      SENSITIVE = [:refresh_token, :assertion, :subject_token]
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] access_token
+    #   A bearer token to access AWS accounts and applications assigned to a
+    #   user.
+    #   @return [String]
+    #
+    # @!attribute [rw] token_type
+    #   Used to notify the requester that the returned token is an access
+    #   token. The supported token type is `Bearer`.
+    #   @return [String]
+    #
+    # @!attribute [rw] expires_in
+    #   Indicates the time in seconds when an access token will expire.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] refresh_token
+    #   A token that, if present, can be used to refresh a previously issued
+    #   access token that might have expired.
+    #
+    #   For more information about the features and limitations of the
+    #   current IAM Identity Center OIDC implementation, see *Considerations
+    #   for Using this Guide* in the [IAM Identity Center OIDC API
+    #   Reference][1].
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/singlesignon/latest/OIDCAPIReference/Welcome.html
     #   @return [String]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/CreateTokenResponse AWS API Documentation
+    # @!attribute [rw] id_token
+    #   A JSON Web Token (JWT) that identifies the user associated with the
+    #   issued access token.
+    #   @return [String]
     #
-    class CreateTokenResponse < Struct.new(
+    # @!attribute [rw] issued_token_type
+    #   Indicates the type of tokens that are issued by IAM Identity Center.
+    #   The following values are supported:
+    #
+    #   * Access Token - `urn:ietf:params:oauth:token-type:access_token`
+    #
+    #   * Refresh Token - `urn:ietf:params:oauth:token-type:refresh_token`
+    #   @return [String]
+    #
+    # @!attribute [rw] scope
+    #   The list of scopes for which authorization is granted. The access
+    #   token that is issued is limited to the scopes that are granted.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/CreateTokenWithIAMResponse AWS API Documentation
+    #
+    class CreateTokenWithIAMResponse < Struct.new(
       :access_token,
       :token_type,
       :expires_in,
       :refresh_token,
-      :id_token)
-      SENSITIVE = []
+      :id_token,
+      :issued_token_type,
+      :scope)
+      SENSITIVE = [:access_token, :refresh_token, :id_token]
       include Aws::Structure
     end
 
@@ -181,9 +360,13 @@ module Aws::SSOOIDC
     # longer valid.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `expired_token`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/ExpiredTokenException AWS API Documentation
@@ -199,9 +382,13 @@ module Aws::SSOOIDC
     # process a request.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `server_error`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InternalServerException AWS API Documentation
@@ -218,9 +405,13 @@ module Aws::SSOOIDC
     # `clientId` or an expired `clientSecret`.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `invalid_client`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InvalidClientException AWS API Documentation
@@ -236,9 +427,13 @@ module Aws::SSOOIDC
     # registration is invalid.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `invalid_client_metadata`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InvalidClientMetadataException AWS API Documentation
@@ -254,9 +449,13 @@ module Aws::SSOOIDC
     # a client makes a CreateToken request with an invalid grant type.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `invalid_grant`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InvalidGrantException AWS API Documentation
@@ -272,9 +471,13 @@ module Aws::SSOOIDC
     # example, a required parameter might be missing or out of range.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `invalid_request`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InvalidRequestException AWS API Documentation
@@ -286,12 +489,50 @@ module Aws::SSOOIDC
       include Aws::Structure
     end
 
+    # Indicates that a token provided as input to the request was issued by
+    # and is only usable by calling IAM Identity Center endpoints in another
+    # region.
+    #
+    # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `invalid_request`.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
+    #   @return [String]
+    #
+    # @!attribute [rw] endpoint
+    #   Indicates the IAM Identity Center endpoint which the requester may
+    #   call with this token.
+    #   @return [String]
+    #
+    # @!attribute [rw] region
+    #   Indicates the region which the requester may call with this token.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InvalidRequestRegionException AWS API Documentation
+    #
+    class InvalidRequestRegionException < Struct.new(
+      :error,
+      :error_description,
+      :endpoint,
+      :region)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Indicates that the scope provided in the request is invalid.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `invalid_scope`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/InvalidScopeException AWS API Documentation
@@ -349,11 +590,11 @@ module Aws::SSOOIDC
     #   @return [Integer]
     #
     # @!attribute [rw] authorization_endpoint
-    #   The endpoint where the client can request authorization.
+    #   An endpoint that the client can use to request authorization.
     #   @return [String]
     #
     # @!attribute [rw] token_endpoint
-    #   The endpoint where the client can get an access token.
+    #   An endpoint that the client can use to create tokens.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/RegisterClientResponse AWS API Documentation
@@ -365,7 +606,7 @@ module Aws::SSOOIDC
       :client_secret_expires_at,
       :authorization_endpoint,
       :token_endpoint)
-      SENSITIVE = []
+      SENSITIVE = [:client_secret]
       include Aws::Structure
     end
 
@@ -373,9 +614,12 @@ module Aws::SSOOIDC
     # more than the service can handle.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be `slow_down`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/SlowDownException AWS API Documentation
@@ -399,8 +643,9 @@ module Aws::SSOOIDC
     #   @return [String]
     #
     # @!attribute [rw] start_url
-    #   The URL for the AWS access portal. For more information, see [Using
-    #   the AWS access portal][1] in the *IAM Identity Center User Guide*.
+    #   The URL for the Amazon Web Services access portal. For more
+    #   information, see [Using the Amazon Web Services access portal][1] in
+    #   the *IAM Identity Center User Guide*.
     #
     #
     #
@@ -413,7 +658,7 @@ module Aws::SSOOIDC
       :client_id,
       :client_secret,
       :start_url)
-      SENSITIVE = []
+      SENSITIVE = [:client_secret]
       include Aws::Structure
     end
 
@@ -466,9 +711,13 @@ module Aws::SSOOIDC
     # client.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `unauthorized_client`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/UnauthorizedClientException AWS API Documentation
@@ -484,9 +733,13 @@ module Aws::SSOOIDC
     # service.
     #
     # @!attribute [rw] error
+    #   Single error code. For this exception the value will be
+    #   `unsupported_grant_type`.
     #   @return [String]
     #
     # @!attribute [rw] error_description
+    #   Human-readable text providing additional information, used to assist
+    #   the client developer in understanding the error that occurred.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sso-oidc-2019-06-10/UnsupportedGrantTypeException AWS API Documentation

data/lib/aws-sdk-ssooidc.rb

@@ -54,6 +54,6 @@ require_relative 'aws-sdk-ssooidc/customizations'
 # @!group service
 module Aws::SSOOIDC
 
-  GEM_VERSION = '3.186.0'
+  GEM_VERSION = '3.187.0'
 
 end

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

@@ -767,7 +767,15 @@ module Aws::STS
     #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_control-access_monitor.html
     #
     # @option params [Array<Types::ProvidedContext>] :provided_contexts
-    #   Reserved for future use.
+    #   A list of previously acquired trusted context assertions in the format
+    #   of a JSON array. The trusted context assertion is signed and encrypted
+    #   by Amazon Web Services STS.
+    #
+    #   The following is an example of a `ProvidedContext` value that includes
+    #   a single trusted context assertion and the ARN of the context provider
+    #   from which the trusted context assertion was generated.
+    #
+    #   `[\{"ProviderArn":"arn:aws:iam::aws:contextProvider/identitycenter","ContextAssertion":"trusted-context-assertion"\}]`
     #
     # @return [Types::AssumeRoleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2344,7 +2352,7 @@ module Aws::STS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-core'
-      context[:gem_version] = '3.186.0'
+      context[:gem_version] = '3.187.0'
       Seahorse::Client::Request.new(handlers, context)
     end