docs(client-sts): API updates for the AWS Security Token Service

aws · Nov 17, 2023 · 1c081b9 · 1c081b9
1 parent 3ec9ad0
commit 1c081b9
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 8 deletions.
diff --git a/clients/client-sts/src/models/models_0.ts b/clients/client-sts/src/models/models_0.ts
@@ -42,18 +42,21 @@ export interface PolicyDescriptorType {
 
 /**
  * @public
- * <p>Reserved for future use.</p>
+ * <p>Contains information about the provided context. This includes the signed and encrypted
+ *          trusted context assertion and the context provider ARN from which the trusted context
+ *          assertion was generated.</p>
  */
 export interface ProvidedContext {
   /**
    * @public
-   * <p>Reserved for future use.</p>
+   * <p>The context provider ARN from which the trusted context assertion was generated.</p>
    */
   ProviderArn?: string;
 
   /**
    * @public
-   * <p>Reserved for future use.</p>
+   * <p>The signed and encrypted trusted context assertion generated by the context provider.
+   *          The trusted context assertion is signed and encrypted by Amazon Web Services STS.</p>
    */
   ContextAssertion?: string;
 }
@@ -301,7 +304,14 @@ export interface AssumeRoleRequest {
 
   /**
    * @public
-   * <p>Reserved for future use.</p>
+   * <p>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.</p>
+   *          <p>The following is an example of a <code>ProvidedContext</code> value that includes a
+   *          single trusted context assertion and the ARN of the context provider from which the trusted
+   *          context assertion was generated.</p>
+   *          <p>
+   *             <code>[\{"ProviderArn":"arn:aws:iam::aws:contextProvider/identitycenter","ContextAssertion":"trusted-context-assertion"\}]</code>
+   *          </p>
    */
   ProvidedContexts?: ProvidedContext[];
 }

diff --git a/codegen/sdk-codegen/aws-models/sts.json b/codegen/sdk-codegen/aws-models/sts.json
@@ -2386,7 +2386,7 @@
         "ProvidedContexts": {
           "target": "com.amazonaws.sts#ProvidedContextsListType",
           "traits": {
-            "smithy.api#documentation": "<p>Reserved for future use.</p>"
+            "smithy.api#documentation": "<p>A list of previously acquired trusted context assertions in the format of a JSON array.\n         The trusted context assertion is signed and encrypted by Amazon Web Services STS.</p>\n         <p>The following is an example of a <code>ProvidedContext</code> value that includes a\n         single trusted context assertion and the ARN of the context provider from which the trusted\n         context assertion was generated.</p>\n         <p>\n            <code>[{\"ProviderArn\":\"arn:aws:iam::aws:contextProvider/identitycenter\",\"ContextAssertion\":\"trusted-context-assertion\"}]</code>\n         </p>"
           }
         }
       },
@@ -3353,18 +3353,18 @@
         "ProviderArn": {
           "target": "com.amazonaws.sts#arnType",
           "traits": {
-            "smithy.api#documentation": "<p>Reserved for future use.</p>"
+            "smithy.api#documentation": "<p>The context provider ARN from which the trusted context assertion was generated.</p>"
           }
         },
         "ContextAssertion": {
           "target": "com.amazonaws.sts#contextAssertionType",
           "traits": {
-            "smithy.api#documentation": "<p>Reserved for future use.</p>"
+            "smithy.api#documentation": "<p>The signed and encrypted trusted context assertion generated by the context provider.\n         The trusted context assertion is signed and encrypted by Amazon Web Services STS.</p>"
           }
         }
       },
       "traits": {
-        "smithy.api#documentation": "<p>Reserved for future use.</p>"
+        "smithy.api#documentation": "<p>Contains information about the provided context. This includes the signed and encrypted\n         trusted context assertion and the context provider ARN from which the trusted context\n         assertion was generated.</p>"
       }
     },
     "com.amazonaws.sts#ProvidedContextsListType": {