Skip to content

Commit 4c759ab

Browse files
async-aws-botjderusse
async-aws-bot
and
jderusse
authored
Update generated code (#1904)
* update generated code * Update src/Service/S3/CHANGELOG.md --------- Co-authored-by: Jérémy Derussé <[email protected]>
1 parent 1dea7c5 commit 4c759ab

File tree

8 files changed

+131
-19
lines changed

8 files changed

+131
-19
lines changed

‎manifest.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"variables": {
3-
"${LATEST}": "3.344.7"
3+
"${LATEST}": "3.346.0"
44
},
55
"endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
66
"services": {

‎src/Service/CloudWatchLogs/CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
## NOT RELEASED
44

5+
### Changed
6+
7+
- AWS enhancement: Documentation updates.
8+
59
## 2.7.0
610

711
### Added

‎src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -257,21 +257,22 @@ public function filterLogEvents($input = []): FilterLogEventsResponse
257257
*
258258
* - The maximum batch size is 1,048,576 bytes. This size is calculated as the sum of all event messages in UTF-8, plus
259259
* 26 bytes for each log event.
260-
* - None of the log events in the batch can be more than 2 hours in the future.
261-
* - None of the log events in the batch can be more than 14 days in the past. Also, none of the log events can be from
262-
* earlier than the retention period of the log group.
260+
* - Events more than 2 hours in the future are rejected while processing remaining valid events.
261+
* - Events older than 14 days or preceding the log group's retention period are rejected while processing remaining
262+
* valid events.
263263
* - The log events in the batch must be in chronological order by their timestamp. The timestamp is the time that the
264264
* event occurred, expressed as the number of milliseconds after `Jan 1, 1970 00:00:00 UTC`. (In Amazon Web Services
265265
* Tools for PowerShell and the Amazon Web Services SDK for .NET, the timestamp is specified in .NET format:
266266
* `yyyy-mm-ddThh:mm:ss`. For example, `2017-09-15T13:45:30`.)
267-
* - A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.
267+
* - A batch of log events in a single request must be in a chronological order. Otherwise, the operation fails.
268268
* - Each log event can be no larger than 1 MB.
269269
* - The maximum number of log events in a batch is 10,000.
270-
* -
271-
* - ! The quota of five requests per second per log stream has been removed. Instead, `PutLogEvents` actions are
272-
* - throttled based on a per-second per-account quota. You can request an increase to the per-second throttling quota
273-
* - by using the Service Quotas service.
274-
* -
270+
* - For valid events (within 14 days in the past to 2 hours in future), the time span in a single batch cannot exceed
271+
* 24 hours. Otherwise, the operation fails.
272+
*
273+
* ! The quota of five requests per second per log stream has been removed. Instead, `PutLogEvents` actions are
274+
* ! throttled based on a per-second per-account quota. You can request an increase to the per-second throttling quota
275+
* ! by using the Service Quotas service.
275276
*
276277
* If a call to `PutLogEvents` returns "UnrecognizedClientException" the most likely cause is a non-valid Amazon Web
277278
* Services access key ID or secret key.

‎src/Service/S3/CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
### Added
66

77
- AWS api-change: Rework regions configuration
8+
- AWS api-change: Added `tagCount` property to the HeadObject response
89

910
## 2.9.1
1011

‎src/Service/S3/src/Result/HeadObjectOutput.php

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -367,6 +367,19 @@ class HeadObjectOutput extends Result
367367
*/
368368
private $partsCount;
369369

370+
/**
371+
* The number of tags, if any, on the object, when you have the relevant permission to read object tags.
372+
*
373+
* You can use GetObjectTagging [^1] to retrieve the tag set associated with an object.
374+
*
375+
* > This functionality is not supported for directory buckets.
376+
*
377+
* [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
378+
*
379+
* @var int|null
380+
*/
381+
private $tagCount;
382+
370383
/**
371384
* The Object Lock mode, if any, that's in effect for this object. This header is only returned if the requester has the
372385
* `s3:GetObjectRetention` permission. For more information about S3 Object Lock, see Object Lock [^1].
@@ -674,6 +687,13 @@ public function getStorageClass(): ?string
674687
return $this->storageClass;
675688
}
676689

690+
public function getTagCount(): ?int
691+
{
692+
$this->initialize();
693+
694+
return $this->tagCount;
695+
}
696+
677697
public function getVersionId(): ?string
678698
{
679699
$this->initialize();
@@ -725,6 +745,7 @@ protected function populateResult(Response $response): void
725745
$this->requestCharged = $headers['x-amz-request-charged'][0] ?? null;
726746
$this->replicationStatus = $headers['x-amz-replication-status'][0] ?? null;
727747
$this->partsCount = isset($headers['x-amz-mp-parts-count'][0]) ? (int) $headers['x-amz-mp-parts-count'][0] : null;
748+
$this->tagCount = isset($headers['x-amz-tagging-count'][0]) ? (int) $headers['x-amz-tagging-count'][0] : null;
728749
$this->objectLockMode = $headers['x-amz-object-lock-mode'][0] ?? null;
729750
$this->objectLockRetainUntilDate = isset($headers['x-amz-object-lock-retain-until-date'][0]) ? new \DateTimeImmutable($headers['x-amz-object-lock-retain-until-date'][0]) : null;
730751
$this->objectLockLegalHoldStatus = $headers['x-amz-object-lock-legal-hold'][0] ?? null;

‎src/Service/S3/src/Result/ListObjectsV2Output.php

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -120,8 +120,7 @@ class ListObjectsV2Output extends Result implements \IteratorAggregate
120120

121121
/**
122122
* If `ContinuationToken` was sent with the request, it is included in the response. You can use the returned
123-
* `ContinuationToken` for pagination of the list response. You can use this `ContinuationToken` for pagination of the
124-
* list results.
123+
* `ContinuationToken` for pagination of the list response.
125124
*
126125
* @var string|null
127126
*/

‎src/Service/S3/src/S3Client.php

Lines changed: 85 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -374,6 +374,15 @@ public function completeMultipartUpload($input): CompleteMultipartUploadOutput
374374
}
375375

376376
/**
377+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
378+
* ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
379+
* ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
380+
* ! However, you will no longer be able to create new Email Grantee ACLs.
381+
* !
382+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
383+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
384+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
385+
*
377386
* Creates a copy of an object that is already stored in Amazon S3.
378387
*
379388
* > You can store individual objects of up to 5 TB in Amazon S3. You create a copy of your object up to 5 GB in size in
@@ -565,6 +574,23 @@ public function copyObject($input): CopyObjectOutput
565574
}
566575

567576
/**
577+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
578+
* ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
579+
* ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
580+
* ! However, you will no longer be able to create new Email Grantee ACLs.
581+
* !
582+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
583+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
584+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
585+
*
586+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
587+
* ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
588+
* ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
589+
* !
590+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
591+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
592+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
593+
*
568594
* > This action creates an Amazon S3 bucket. To create an Amazon S3 on Outposts bucket, see `CreateBucket` [^1].
569595
*
570596
* Creates a new S3 bucket. To create a bucket, you must set up Amazon S3 and have a valid Amazon Web Services Access
@@ -691,6 +717,15 @@ public function createBucket($input): CreateBucketOutput
691717
}
692718

693719
/**
720+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
721+
* ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
722+
* ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
723+
* ! However, you will no longer be able to create new Email Grantee ACLs.
724+
* !
725+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
726+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
727+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
728+
*
694729
* This action initiates a multipart upload and returns an upload ID. This upload ID is used to associate all of the
695730
* parts in the specific multipart upload. You specify this upload ID in each of your subsequent upload part requests
696731
* (see UploadPart [^1]). You also include this upload ID in the final request to either complete or abort the multipart
@@ -1779,6 +1814,14 @@ public function headObject($input): HeadObjectOutput
17791814
}
17801815

17811816
/**
1817+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
1818+
* ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
1819+
* ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
1820+
* !
1821+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
1822+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
1823+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
1824+
*
17821825
* > This operation is not supported for directory buckets.
17831826
*
17841827
* Returns a list of all buckets owned by the authenticated sender of the request. To grant IAM permission to use this
@@ -1814,6 +1857,14 @@ public function listBuckets($input = []): ListBucketsOutput
18141857
}
18151858

18161859
/**
1860+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
1861+
* ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
1862+
* ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
1863+
* !
1864+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
1865+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
1866+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
1867+
*
18171868
* This operation lists in-progress multipart uploads in a bucket. An in-progress multipart upload is a multipart upload
18181869
* that has been initiated by the `CreateMultipartUpload` request, but has not yet been completed or aborted.
18191870
*
@@ -1921,6 +1972,14 @@ public function listMultipartUploads($input): ListMultipartUploadsOutput
19211972
}
19221973

19231974
/**
1975+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
1976+
* ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
1977+
* ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
1978+
* !
1979+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
1980+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
1981+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
1982+
*
19241983
* > This operation is not supported for directory buckets.
19251984
*
19261985
* Returns metadata about all versions of the objects in a bucket. You can also use request parameters as selection
@@ -2071,6 +2130,14 @@ public function listObjectsV2($input): ListObjectsV2Output
20712130
}
20722131

20732132
/**
2133+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
2134+
* ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
2135+
* ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
2136+
* !
2137+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
2138+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
2139+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
2140+
*
20742141
* Lists the parts that have been uploaded for a specific multipart upload.
20752142
*
20762143
* To use this operation, you must provide the `upload ID` in the request. You obtain this uploadID by sending the
@@ -2433,6 +2500,15 @@ public function putBucketTagging($input): Result
24332500
}
24342501

24352502
/**
2503+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
2504+
* ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
2505+
* ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
2506+
* ! However, you will no longer be able to create new Email Grantee ACLs.
2507+
* !
2508+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
2509+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
2510+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
2511+
*
24362512
* Adds an object to a bucket.
24372513
*
24382514
* > - Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the entire object to the
@@ -2661,7 +2737,8 @@ public function putObject($input): PutObjectOutput
26612737
* - `Grantee Values`:
26622738
*
26632739
* You can specify the person (grantee) to whom you're assigning access rights (using request elements) in the
2664-
* following ways:
2740+
* following ways. For examples of how to specify these grantee values in JSON format, see the Amazon Web Services CLI
2741+
* example in Enabling Amazon S3 server access logging [^7] in the *Amazon S3 User Guide*.
26652742
*
26662743
* - By the person's ID:
26672744
*
@@ -2693,7 +2770,7 @@ public function putObject($input): PutObjectOutput
26932770
* > - Europe (Ireland)
26942771
* > - South America (São Paulo)
26952772
* >
2696-
* > For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints [^7] in the Amazon
2773+
* > For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints [^8] in the Amazon
26972774
* > Web Services General Reference.
26982775
*
26992776
*
@@ -2704,18 +2781,19 @@ public function putObject($input): PutObjectOutput
27042781
*
27052782
* The following operations are related to `PutObjectAcl`:
27062783
*
2707-
* - CopyObject [^8]
2708-
* - GetObject [^9]
2784+
* - CopyObject [^9]
2785+
* - GetObject [^10]
27092786
*
27102787
* [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
27112788
* [^2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
27122789
* [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
27132790
* [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
27142791
* [^5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
27152792
* [^6]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2716-
* [^7]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2717-
* [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2718-
* [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
2793+
* [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html
2794+
* [^8]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2795+
* [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
2796+
* [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
27192797
*
27202798
* @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html
27212799
* @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#putobjectacl

‎src/Service/S3/src/ValueObject/Owner.php

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,14 @@
33
namespace AsyncAws\S3\ValueObject;
44

55
/**
6+
* ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
7+
* ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
8+
* ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
9+
* !
10+
* ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
11+
* ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
12+
* ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
13+
*
614
* Container for the owner's display name and ID.
715
*/
816
final class Owner

0 commit comments

Comments
 (0)