update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.284.1"
+        "${LATEST}": "3.287.0"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {

src/Core/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Changed
 
 - Allow passing explicit null values for optional fields of input objects
+- AWS enhancement: Documentation updates.
 
 ### Fixed
 

src/Core/src/Sts/Input/AssumeRoleRequest.php

@@ -230,7 +230,13 @@ final class AssumeRoleRequest extends Input
     private $sourceIdentity;
 
     /**
-     * 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"}]`
      *
      * @var ProvidedContext[]|null
      */

src/Core/src/Sts/ValueObject/ProvidedContext.php

@@ -3,19 +3,21 @@
 namespace AsyncAws\Core\Sts\ValueObject;
 
 /**
- * Reserved for future use.
+ * 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.
  */
 final class ProvidedContext
 {
     /**
-     * Reserved for future use.
+     * The context provider ARN from which the trusted context assertion was generated.
      *
      * @var string|null
      */
     private $providerArn;
 
     /**
-     * Reserved for future use.
+     * 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.
      *
      * @var string|null
      */

src/Service/Athena/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 
 - Added `il-central-1` region
+- AWS api-change: Adding SerivicePreProcessing time metric
 
 ### Changed
 

src/Service/Athena/src/AthenaClient.php

@@ -406,11 +406,6 @@ public function listDatabases($input): ListDatabasesOutput
      * access to the specified workgroup. If a workgroup is not specified, lists the saved queries for the primary
      * workgroup.
      *
-     * For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples [^1] in the *Amazon Athena
-     * User Guide*.
-     *
-     * [^1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
-     *
      * @see https://docs.aws.amazon.com/athena/latest/APIReference/API_ListNamedQueries.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-athena-2017-05-18.html#listnamedqueries
      *
@@ -436,14 +431,9 @@ public function listNamedQueries($input = []): ListNamedQueriesOutput
     }
 
     /**
-     * Provides a list of available query execution IDs for the queries in the specified workgroup. If a workgroup is not
-     * specified, returns a list of query execution IDs for the primary workgroup. Requires you to have access to the
-     * workgroup in which the queries ran.
-     *
-     * For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples [^1] in the *Amazon Athena
-     * User Guide*.
-     *
-     * [^1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
+     * Provides a list of available query execution IDs for the queries in the specified workgroup. Athena keeps a query
+     * history for 45 days. If a workgroup is not specified, returns a list of query execution IDs for the primary
+     * workgroup. Requires you to have access to the workgroup in which the queries ran.
      *
      * @see https://docs.aws.amazon.com/athena/latest/APIReference/API_ListQueryExecutions.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-athena-2017-05-18.html#listqueryexecutions
@@ -504,6 +494,10 @@ public function listTableMetadata($input): ListTableMetadataOutput
      * Submits calculations for execution within a session. You can supply the code to run as an inline code block within
      * the request.
      *
+     * > The request syntax requires the StartCalculationExecutionRequest$CodeBlock parameter or the
+     * > CalculationConfiguration$CodeBlock parameter, but not both. Because CalculationConfiguration$CodeBlock is
+     * > deprecated, use the StartCalculationExecutionRequest$CodeBlock parameter instead.
+     *
      * @see https://docs.aws.amazon.com/athena/latest/APIReference/API_StartCalculationExecution.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-athena-2017-05-18.html#startcalculationexecution
      *
@@ -641,11 +635,6 @@ public function stopCalculationExecution($input): StopCalculationExecutionRespon
     /**
      * Stops a query execution. Requires you to have access to the workgroup in which the query ran.
      *
-     * For code samples using the Amazon Web Services SDK for Java, see Examples and Code Samples [^1] in the *Amazon Athena
-     * User Guide*.
-     *
-     * [^1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
-     *
      * @see https://docs.aws.amazon.com/athena/latest/APIReference/API_StopQueryExecution.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-athena-2017-05-18.html#stopqueryexecution
      *

src/Service/Athena/src/Input/StartCalculationExecutionRequest.php

@@ -34,7 +34,8 @@ final class StartCalculationExecutionRequest extends Input
     private $calculationConfiguration;
 
     /**
-     * A string that contains the code of the calculation.
+     * A string that contains the code of the calculation. Use this parameter instead of CalculationConfiguration$CodeBlock,
+     * which is deprecated.
      *
      * @var string|null
      */

src/Service/Athena/src/Result/GetQueryExecutionOutput.php

@@ -123,6 +123,7 @@ private function populateResultQueryExecutionStatistics(array $json): QueryExecu
             'DataManifestLocation' => isset($json['DataManifestLocation']) ? (string) $json['DataManifestLocation'] : null,
             'TotalExecutionTimeInMillis' => isset($json['TotalExecutionTimeInMillis']) ? (int) $json['TotalExecutionTimeInMillis'] : null,
             'QueryQueueTimeInMillis' => isset($json['QueryQueueTimeInMillis']) ? (int) $json['QueryQueueTimeInMillis'] : null,
+            'ServicePreProcessingTimeInMillis' => isset($json['ServicePreProcessingTimeInMillis']) ? (int) $json['ServicePreProcessingTimeInMillis'] : null,
             'QueryPlanningTimeInMillis' => isset($json['QueryPlanningTimeInMillis']) ? (int) $json['QueryPlanningTimeInMillis'] : null,
             'ServiceProcessingTimeInMillis' => isset($json['ServiceProcessingTimeInMillis']) ? (int) $json['ServiceProcessingTimeInMillis'] : null,
             'ResultReuseInformation' => empty($json['ResultReuseInformation']) ? null : $this->populateResultResultReuseInformation($json['ResultReuseInformation']),

src/Service/Athena/src/ValueObject/CustomerContentEncryptionConfiguration.php

@@ -5,13 +5,13 @@
 use AsyncAws\Core\Exception\InvalidArgument;
 
 /**
- * Specifies the KMS key that is used to encrypt the user's data stores in Athena. This setting does not apply to Athena
- * SQL workgroups.
+ * Specifies the customer managed KMS key that is used to encrypt the user's data stores in Athena. When an Amazon Web
+ * Services managed key is used, this value is null. This setting does not apply to Athena SQL workgroups.
  */
 final class CustomerContentEncryptionConfiguration
 {
     /**
-     * The KMS key that is used to encrypt the user's data stores in Athena.
+     * The customer managed KMS key that is used to encrypt the user's data stores in Athena.
      *
      * @var string
      */

src/Service/Athena/src/ValueObject/DataCatalog.php

@@ -63,8 +63,6 @@ final class DataCatalog
      *
      *   - The `GLUE` data catalog type also applies to the default `AwsDataCatalog` that already exists in your account, of
      *     which you can have only one and cannot modify.
-     *   - Queries that specify a Glue Data Catalog other than the default `AwsDataCatalog` must be run on Athena engine
-     *     version 2.
      *
      * @var array<string, string>|null
      */