update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.284.1"
+        "${LATEST}": "3.287.1"
     },
     "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
      */

src/Service/Athena/src/ValueObject/QueryExecutionStatistics.php

@@ -50,6 +50,13 @@ final class QueryExecutionStatistics
      */
     private $queryQueueTimeInMillis;
 
+    /**
+     * The number of milliseconds that Athena took to preprocess the query before submitting the query to the query engine.
+     *
+     * @var int|null
+     */
+    private $servicePreProcessingTimeInMillis;
+
     /**
      * The number of milliseconds that Athena took to plan the query processing flow. This includes the time spent
      * retrieving table partitions from the data source. Note that because the query engine performs the query planning,
@@ -81,6 +88,7 @@ final class QueryExecutionStatistics
      *   DataManifestLocation?: null|string,
      *   TotalExecutionTimeInMillis?: null|int,
      *   QueryQueueTimeInMillis?: null|int,
+     *   ServicePreProcessingTimeInMillis?: null|int,
      *   QueryPlanningTimeInMillis?: null|int,
      *   ServiceProcessingTimeInMillis?: null|int,
      *   ResultReuseInformation?: null|ResultReuseInformation|array,
@@ -93,6 +101,7 @@ public function __construct(array $input)
         $this->dataManifestLocation = $input['DataManifestLocation'] ?? null;
         $this->totalExecutionTimeInMillis = $input['TotalExecutionTimeInMillis'] ?? null;
         $this->queryQueueTimeInMillis = $input['QueryQueueTimeInMillis'] ?? null;
+        $this->servicePreProcessingTimeInMillis = $input['ServicePreProcessingTimeInMillis'] ?? null;
         $this->queryPlanningTimeInMillis = $input['QueryPlanningTimeInMillis'] ?? null;
         $this->serviceProcessingTimeInMillis = $input['ServiceProcessingTimeInMillis'] ?? null;
         $this->resultReuseInformation = isset($input['ResultReuseInformation']) ? ResultReuseInformation::create($input['ResultReuseInformation']) : null;
@@ -105,6 +114,7 @@ public function __construct(array $input)
      *   DataManifestLocation?: null|string,
      *   TotalExecutionTimeInMillis?: null|int,
      *   QueryQueueTimeInMillis?: null|int,
+     *   ServicePreProcessingTimeInMillis?: null|int,
      *   QueryPlanningTimeInMillis?: null|int,
      *   ServiceProcessingTimeInMillis?: null|int,
      *   ResultReuseInformation?: null|ResultReuseInformation|array,
@@ -145,6 +155,11 @@ public function getResultReuseInformation(): ?ResultReuseInformation
         return $this->resultReuseInformation;
     }
 
+    public function getServicePreProcessingTimeInMillis(): ?int
+    {
+        return $this->servicePreProcessingTimeInMillis;
+    }
+
     public function getServiceProcessingTimeInMillis(): ?int
     {
         return $this->serviceProcessingTimeInMillis;

src/Service/Athena/src/ValueObject/SessionConfiguration.php

@@ -8,7 +8,8 @@
 final class SessionConfiguration
 {
     /**
-     * The ARN of the execution role used for the session.
+     * The ARN of the execution role used in a Spark session to access user resources. This property applies only to
+     * Spark-enabled workgroups.
      *
      * @var string|null
      */

src/Service/Athena/src/ValueObject/WorkGroupConfiguration.php

@@ -78,7 +78,8 @@ final class WorkGroupConfiguration
     private $additionalConfiguration;
 
     /**
-     * Role used in a session for accessing the user's resources.
+     * Role used in a Spark session for accessing the user's resources. This property applies only to Spark-enabled
+     * workgroups.
      *
      * @var string|null
      */

src/Service/CloudFormation/src/CloudFormationClient.php

@@ -49,7 +49,7 @@ public function describeStackDriftDetectionStatus($input): DescribeStackDriftDet
 
     /**
      * Returns all stack related events for a specified stack in reverse chronological order. For more information about a
-     * stack's event history, go to Stacks [^1] in the CloudFormation User Guide.
+     * stack's event history, go to Stacks [^1] in the *CloudFormation User Guide*.
      *
      * > You can list events for stacks that have failed to create or have been deleted by specifying the unique stack
      * > identifier (stack ID).
@@ -77,7 +77,7 @@ public function describeStackEvents($input = []): DescribeStackEventsOutput
      * Returns the description for the specified stack; if no stack name was specified, then it returns the description for
      * all the stacks created.
      *
-     * > If the stack doesn't exist, an `ValidationError` is returned.
+     * > If the stack doesn't exist, a `ValidationError` is returned.
      *
      * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_DescribeStacks.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-cloudformation-2010-05-15.html#describestacks

src/Service/EventBridge/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Introduces a new rule state ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS for matching with Get, List and Describe AWS API call events from CloudTrail.
+
 ### Changed
 
 - Allow passing explicit null values for optional fields of input objects

src/Service/EventBridge/src/EventBridgeClient.php

@@ -17,8 +17,17 @@ class EventBridgeClient extends AbstractApi
     /**
      * Sends custom events to Amazon EventBridge so that they can be matched to rules.
      *
+     * The maximum size for a PutEvents event entry is 256 KB. Entry size is calculated including the event and any
+     * necessary characters and keys of the JSON representation of the event. To learn more, see Calculating PutEvents event
+     * entry size [^1] in the *Amazon EventBridge User Guide*
+     *
+     * PutEvents accepts the data in JSON format. For the JSON number (integer) data type, the constraints are: a minimum
+     * value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807.
+     *
      * > PutEvents will only process nested JSON up to 1100 levels deep.
      *
+     * [^1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevent-size.html
+     *
      * @see https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-events-2015-10-07.html#putevents
      *

src/Service/EventBridge/src/ValueObject/PutEventsRequestEntry.php

@@ -21,6 +21,11 @@ final class PutEventsRequestEntry
     /**
      * The source of the event.
      *
+     * > `Detail`, `DetailType`, and `Source` are required for EventBridge to successfully send an event to an event bus. If
+     * > you include event entries in a request that do not include each of those properties, EventBridge fails that entry.
+     * > If you submit a request in which *none* of the entries have each of these properties, EventBridge fails the entire
+     * > request.
+     *
      * @var string|null
      */
     private $source;
@@ -36,12 +41,22 @@ final class PutEventsRequestEntry
     /**
      * Free-form string, with a maximum of 128 characters, used to decide what fields to expect in the event detail.
      *
+     * > `Detail`, `DetailType`, and `Source` are required for EventBridge to successfully send an event to an event bus. If
+     * > you include event entries in a request that do not include each of those properties, EventBridge fails that entry.
+     * > If you submit a request in which *none* of the entries have each of these properties, EventBridge fails the entire
+     * > request.
+     *
      * @var string|null
      */
     private $detailType;
 
     /**
-     * A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested subobjects.
+     * A valid JSON object. There is no other schema imposed. The JSON object may contain fields and nested sub-objects.
+     *
+     * > `Detail`, `DetailType`, and `Source` are required for EventBridge to successfully send an event to an event bus. If
+     * > you include event entries in a request that do not include each of those properties, EventBridge fails that entry.
+     * > If you submit a request in which *none* of the entries have each of these properties, EventBridge fails the entire
+     * > request.
      *
      * @var string|null
      */
@@ -51,9 +66,10 @@ final class PutEventsRequestEntry
      * The name or ARN of the event bus to receive the event. Only the rules that are associated with this event bus are
      * used to match the event. If you omit this, the default event bus is used.
      *
-     * > If you're using a global endpoint with a custom bus, you must enter the name, not the ARN, of the event bus in
-     * > either the primary or secondary Region here and the corresponding event bus in the other Region will be determined
-     * > based on the endpoint referenced by the `EndpointId`.
+     * > If you're using a global endpoint with a custom bus, you can enter either the name or Amazon Resource Name (ARN) of
+     * > the event bus in either the primary or secondary Region here. EventBridge then determines the corresponding event
+     * > bus in the other Region based on the endpoint referenced by the `EndpointId`. Specifying the event bus ARN is
+     * > preferred.
      *
      * @var string|null
      */

src/Service/EventBridge/src/ValueObject/PutEventsResultEntry.php

@@ -2,9 +2,15 @@
 
 namespace AsyncAws\EventBridge\ValueObject;
 
+use AsyncAws\Core\Exception\InvalidArgument;
+
 /**
- * Represents an event that failed to be submitted. For information about the errors that are common to all actions, see
- * Common Errors [^1].
+ * Represents the results of an event submitted to an event bus.
+ *
+ * If the submission was successful, the entry has the event ID in it. Otherwise, you can use the error code and error
+ * message to identify the problem with the entry.
+ *
+ * For information about the errors that are common to all actions, see Common Errors [^1].
  *
  * [^1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html
  */
@@ -20,6 +26,43 @@ final class PutEventsResultEntry
     /**
      * The error code that indicates why the event submission failed.
      *
+     * Retryable errors include:
+     *
+     * - `InternalFailure [^1]`
+     *
+     *   The request processing has failed because of an unknown error, exception or failure.
+     * - `ThrottlingException [^2]`
+     *
+     *   The request was denied due to request throttling.
+     *
+     * Non-retryable errors include:
+     *
+     * - `AccessDeniedException [^3]`
+     *
+     *   You do not have sufficient access to perform this action.
+     * - `InvalidAccountIdException`
+     *
+     *   The account ID provided is not valid.
+     * - `InvalidArgument`
+     *
+     *   A specified parameter is not valid.
+     * - `MalformedDetail`
+     *
+     *   The JSON provided is not valid.
+     * - `RedactionFailure`
+     *
+     *   Redacting the CloudTrail event failed.
+     * - `NotAuthorizedForSourceException`
+     *
+     *   You do not have permissions to publish events with this source onto this event bus.
+     * - `NotAuthorizedForDetailTypeException`
+     *
+     *   You do not have permissions to publish events with this detail type onto this event bus.
+     *
+     * [^1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html
+     * [^2]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html
+     * [^3]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/CommonErrors.html
+     *
      * @var string|null
      */
     private $errorCode;

src/Service/Iot/CHANGELOG.md

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