diff --git a/manifest.json b/manifest.json index 1dc0c5b45..bae1f311e 100644 --- a/manifest.json +++ b/manifest.json @@ -1,6 +1,6 @@ { "variables": { - "${LATEST}": "3.339.6" + "${LATEST}": "3.339.8" }, "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json", "services": { diff --git a/src/Service/CloudFormation/CHANGELOG.md b/src/Service/CloudFormation/CHANGELOG.md index 510d8c4a6..24f88fb19 100644 --- a/src/Service/CloudFormation/CHANGELOG.md +++ b/src/Service/CloudFormation/CHANGELOG.md @@ -5,6 +5,7 @@ ### Added - AWS api-change: Added `us-isof-east-1` and `us-isof-south-1` regions +- AWS api-change: Added `ResourceStatus` constants for new StackRefactor apis. ## 1.7.2 diff --git a/src/Service/CloudFormation/src/Enum/ResourceStatus.php b/src/Service/CloudFormation/src/Enum/ResourceStatus.php index dbdcb9683..3b1acecdf 100644 --- a/src/Service/CloudFormation/src/Enum/ResourceStatus.php +++ b/src/Service/CloudFormation/src/Enum/ResourceStatus.php @@ -11,6 +11,12 @@ final class ResourceStatus public const DELETE_FAILED = 'DELETE_FAILED'; public const DELETE_IN_PROGRESS = 'DELETE_IN_PROGRESS'; public const DELETE_SKIPPED = 'DELETE_SKIPPED'; + public const EXPORT_COMPLETE = 'EXPORT_COMPLETE'; + public const EXPORT_FAILED = 'EXPORT_FAILED'; + public const EXPORT_IN_PROGRESS = 'EXPORT_IN_PROGRESS'; + public const EXPORT_ROLLBACK_COMPLETE = 'EXPORT_ROLLBACK_COMPLETE'; + public const EXPORT_ROLLBACK_FAILED = 'EXPORT_ROLLBACK_FAILED'; + public const EXPORT_ROLLBACK_IN_PROGRESS = 'EXPORT_ROLLBACK_IN_PROGRESS'; public const IMPORT_COMPLETE = 'IMPORT_COMPLETE'; public const IMPORT_FAILED = 'IMPORT_FAILED'; public const IMPORT_IN_PROGRESS = 'IMPORT_IN_PROGRESS'; @@ -37,6 +43,12 @@ public static function exists(string $value): bool self::DELETE_FAILED => true, self::DELETE_IN_PROGRESS => true, self::DELETE_SKIPPED => true, + self::EXPORT_COMPLETE => true, + self::EXPORT_FAILED => true, + self::EXPORT_IN_PROGRESS => true, + self::EXPORT_ROLLBACK_COMPLETE => true, + self::EXPORT_ROLLBACK_FAILED => true, + self::EXPORT_ROLLBACK_IN_PROGRESS => true, self::IMPORT_COMPLETE => true, self::IMPORT_FAILED => true, self::IMPORT_IN_PROGRESS => true, diff --git a/src/Service/CloudFormation/src/ValueObject/Parameter.php b/src/Service/CloudFormation/src/ValueObject/Parameter.php index f153518a5..1be1b0a4b 100644 --- a/src/Service/CloudFormation/src/ValueObject/Parameter.php +++ b/src/Service/CloudFormation/src/ValueObject/Parameter.php @@ -32,8 +32,8 @@ final class Parameter /** * Read-only. The value that corresponds to a Systems Manager parameter key. This field is returned only for Systems - * Manager parameter types in the template. For more information, see Use CloudFormation-supplied parameter types [^1] - * in the *CloudFormation User Guide*. + * Manager parameter types in the template. For more information, see Specify existing resources at runtime with + * CloudFormation-supplied parameter types [^1] in the *CloudFormation User Guide*. * * [^1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-supplied-parameter-types.html * diff --git a/src/Service/CloudFormation/src/ValueObject/StackEvent.php b/src/Service/CloudFormation/src/ValueObject/StackEvent.php index c67b6d137..d5c6357d2 100644 --- a/src/Service/CloudFormation/src/ValueObject/StackEvent.php +++ b/src/Service/CloudFormation/src/ValueObject/StackEvent.php @@ -125,7 +125,7 @@ final class StackEvent private $hookStatusReason; /** - * Invocation points are points in provisioning logic where hooks are initiated. + * Invocation points are points in provisioning logic where Hooks are initiated. * * @var HookInvocationPoint::*|null */ diff --git a/src/Service/Comprehend/CHANGELOG.md b/src/Service/Comprehend/CHANGELOG.md index 6c4050d20..d7ce327e8 100644 --- a/src/Service/Comprehend/CHANGELOG.md +++ b/src/Service/Comprehend/CHANGELOG.md @@ -5,6 +5,7 @@ ### Added - AWS api-change: Added `us-isof-east-1` and `us-isof-south-1` regions +- AWS api-change: Added `fips-ca-central-1` region ## 1.2.0 diff --git a/src/Service/Comprehend/src/ComprehendClient.php b/src/Service/Comprehend/src/ComprehendClient.php index 10db45d02..24caae351 100644 --- a/src/Service/Comprehend/src/ComprehendClient.php +++ b/src/Service/Comprehend/src/ComprehendClient.php @@ -57,6 +57,13 @@ protected function getEndpointMetadata(?string $region): array } switch ($region) { + case 'fips-ca-central-1': + return [ + 'endpoint' => 'https://comprehend-fips.ca-central-1.amazonaws.com', + 'signRegion' => 'ca-central-1', + 'signService' => 'comprehend', + 'signVersions' => ['v4'], + ]; case 'fips-us-east-1': return [ 'endpoint' => 'https://comprehend-fips.us-east-1.amazonaws.com', diff --git a/src/Service/S3/CHANGELOG.md b/src/Service/S3/CHANGELOG.md index 88b1c1d1a..b5f83485e 100644 --- a/src/Service/S3/CHANGELOG.md +++ b/src/Service/S3/CHANGELOG.md @@ -6,6 +6,7 @@ - AWS api-change: This change enhances integrity protections for new SDK requests to S3. S3 SDKs now support the CRC64NVME checksum algorithm, full object checksums for multipart S3 objects, and new default integrity protections for S3 requests. - AWS api-change: Added `us-isof-east-1` and `us-isof-south-1` regions +- AWS api-change: Updated list of the valid AWS Region values for the LocationConstraint parameter for general purpose buckets. ## 2.7.0 diff --git a/src/Service/S3/src/Enum/BucketLocationConstraint.php b/src/Service/S3/src/Enum/BucketLocationConstraint.php index cdd40e4a5..9da56d370 100644 --- a/src/Service/S3/src/Enum/BucketLocationConstraint.php +++ b/src/Service/S3/src/Enum/BucketLocationConstraint.php @@ -12,6 +12,8 @@ final class BucketLocationConstraint public const AP_SOUTHEAST_1 = 'ap-southeast-1'; public const AP_SOUTHEAST_2 = 'ap-southeast-2'; public const AP_SOUTHEAST_3 = 'ap-southeast-3'; + public const AP_SOUTHEAST_4 = 'ap-southeast-4'; + public const AP_SOUTHEAST_5 = 'ap-southeast-5'; public const AP_SOUTH_1 = 'ap-south-1'; public const AP_SOUTH_2 = 'ap-south-2'; public const CA_CENTRAL_1 = 'ca-central-1'; @@ -19,12 +21,15 @@ final class BucketLocationConstraint public const CN_NORTH_1 = 'cn-north-1'; public const EU = 'EU'; public const EU_CENTRAL_1 = 'eu-central-1'; + public const EU_CENTRAL_2 = 'eu-central-2'; public const EU_NORTH_1 = 'eu-north-1'; public const EU_SOUTH_1 = 'eu-south-1'; public const EU_SOUTH_2 = 'eu-south-2'; public const EU_WEST_1 = 'eu-west-1'; public const EU_WEST_2 = 'eu-west-2'; public const EU_WEST_3 = 'eu-west-3'; + public const IL_CENTRAL_1 = 'il-central-1'; + public const ME_CENTRAL_1 = 'me-central-1'; public const ME_SOUTH_1 = 'me-south-1'; public const SA_EAST_1 = 'sa-east-1'; public const US_EAST_2 = 'us-east-2'; @@ -44,6 +49,8 @@ public static function exists(string $value): bool self::AP_SOUTHEAST_1 => true, self::AP_SOUTHEAST_2 => true, self::AP_SOUTHEAST_3 => true, + self::AP_SOUTHEAST_4 => true, + self::AP_SOUTHEAST_5 => true, self::AP_SOUTH_1 => true, self::AP_SOUTH_2 => true, self::CA_CENTRAL_1 => true, @@ -51,12 +58,15 @@ public static function exists(string $value): bool self::CN_NORTH_1 => true, self::EU => true, self::EU_CENTRAL_1 => true, + self::EU_CENTRAL_2 => true, self::EU_NORTH_1 => true, self::EU_SOUTH_1 => true, self::EU_SOUTH_2 => true, self::EU_WEST_1 => true, self::EU_WEST_2 => true, self::EU_WEST_3 => true, + self::IL_CENTRAL_1 => true, + self::ME_CENTRAL_1 => true, self::ME_SOUTH_1 => true, self::SA_EAST_1 => true, self::US_EAST_2 => true, diff --git a/src/Service/S3/src/Input/AbortMultipartUploadRequest.php b/src/Service/S3/src/Input/AbortMultipartUploadRequest.php index b1e6d2fe9..840778863 100644 --- a/src/Service/S3/src/Input/AbortMultipartUploadRequest.php +++ b/src/Service/S3/src/Input/AbortMultipartUploadRequest.php @@ -16,9 +16,9 @@ final class AbortMultipartUploadRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -29,11 +29,11 @@ final class AbortMultipartUploadRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php b/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php index 51ebadc64..c24c15207 100644 --- a/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php +++ b/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php @@ -18,9 +18,9 @@ final class CompleteMultipartUploadRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -31,11 +31,11 @@ final class CompleteMultipartUploadRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/CopyObjectRequest.php b/src/Service/S3/src/Input/CopyObjectRequest.php index e06544a5f..f18531d08 100644 --- a/src/Service/S3/src/Input/CopyObjectRequest.php +++ b/src/Service/S3/src/Input/CopyObjectRequest.php @@ -50,9 +50,9 @@ final class CopyObjectRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * > Copying objects across different Amazon Web Services Regions isn't supported when the source or destination bucket * > is in Amazon Web Services Local Zones. The source and destination buckets must have the same parent Amazon Web @@ -67,11 +67,14 @@ final class CopyObjectRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form - * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must use the Outpost bucket access point ARN + * or the access point alias for the destination bucket. You can only copy objects within the same Outpost bucket. It's + * not supported to copy objects across different Amazon Web Services Outposts, between buckets on the same Outposts, or + * between Outposts buckets and any other bucket types. For more information about S3 on Outposts, see What is S3 on + * Outposts? [^3] in the *S3 on Outposts guide*. When you use this action with S3 on Outposts through the REST API, you + * must direct requests to the S3 on Outposts hostname, in the format + * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. The hostname isn't required when you + * use the Amazon Web Services CLI or SDKs. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html @@ -510,14 +513,12 @@ final class CopyObjectRequest extends Input * any of the officially supported Amazon Web Services SDKs and Amazon Web Services CLI, see Specifying the Signature * Version in Request Authentication [^1] in the *Amazon S3 User Guide*. * - * **Directory buckets** - If you specify `x-amz-server-side-encryption` with `aws:kms`, the ` - * x-amz-server-side-encryption-aws-kms-key-id` header is implicitly assigned the ID of the KMS symmetric encryption - * customer managed key that's configured for your directory bucket's default encryption setting. If you want to specify - * the ` x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you can only specify it with the ID (Key ID or - * Key ARN) of the KMS customer managed key that's configured for your directory bucket's default encryption setting. - * Otherwise, you get an HTTP `400 Bad Request` error. Only use the key ID or key ARN. The key alias format of the KMS - * key isn't supported. Your SSE-KMS configuration can only support 1 customer managed key [^2] per directory bucket for - * the lifetime of the bucket. The Amazon Web Services managed key [^3] (`aws/s3`) isn't supported. + * **Directory buckets** - To encrypt data using SSE-KMS, it's recommended to specify the `x-amz-server-side-encryption` + * header to `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id` header implicitly uses the bucket's + * default KMS customer managed key ID. If you want to explicitly set the ` x-amz-server-side-encryption-aws-kms-key-id` + * header, it must match the bucket's default customer managed key (using key ID or ARN, not alias). Your SSE-KMS + * configuration can only support 1 customer managed key [^2] per directory bucket's lifetime. The Amazon Web Services + * managed key [^3] (`aws/s3`) isn't supported. Incorrect key specification results in an HTTP `400 Bad Request` error. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version * [^2]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk diff --git a/src/Service/S3/src/Input/CreateMultipartUploadRequest.php b/src/Service/S3/src/Input/CreateMultipartUploadRequest.php index 799e0cc79..ecc91e172 100644 --- a/src/Service/S3/src/Input/CreateMultipartUploadRequest.php +++ b/src/Service/S3/src/Input/CreateMultipartUploadRequest.php @@ -45,9 +45,9 @@ final class CreateMultipartUploadRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -58,11 +58,11 @@ final class CreateMultipartUploadRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html @@ -418,14 +418,12 @@ final class CreateMultipartUploadRequest extends Input * `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the Amazon Web Services managed key (`aws/s3`) to * protect the data. * - * **Directory buckets** - If you specify `x-amz-server-side-encryption` with `aws:kms`, the ` - * x-amz-server-side-encryption-aws-kms-key-id` header is implicitly assigned the ID of the KMS symmetric encryption - * customer managed key that's configured for your directory bucket's default encryption setting. If you want to specify - * the ` x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you can only specify it with the ID (Key ID or - * Key ARN) of the KMS customer managed key that's configured for your directory bucket's default encryption setting. - * Otherwise, you get an HTTP `400 Bad Request` error. Only use the key ID or key ARN. The key alias format of the KMS - * key isn't supported. Your SSE-KMS configuration can only support 1 customer managed key [^1] per directory bucket for - * the lifetime of the bucket. The Amazon Web Services managed key [^2] (`aws/s3`) isn't supported. + * **Directory buckets** - To encrypt data using SSE-KMS, it's recommended to specify the `x-amz-server-side-encryption` + * header to `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id` header implicitly uses the bucket's + * default KMS customer managed key ID. If you want to explicitly set the ` x-amz-server-side-encryption-aws-kms-key-id` + * header, it must match the bucket's default customer managed key (using key ID or ARN, not alias). Your SSE-KMS + * configuration can only support 1 customer managed key [^1] per directory bucket's lifetime. The Amazon Web Services + * managed key [^2] (`aws/s3`) isn't supported. Incorrect key specification results in an HTTP `400 Bad Request` error. * * [^1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk * [^2]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk diff --git a/src/Service/S3/src/Input/DeleteObjectRequest.php b/src/Service/S3/src/Input/DeleteObjectRequest.php index 4f72e3414..c0e3c689c 100644 --- a/src/Service/S3/src/Input/DeleteObjectRequest.php +++ b/src/Service/S3/src/Input/DeleteObjectRequest.php @@ -16,9 +16,9 @@ final class DeleteObjectRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -29,11 +29,11 @@ final class DeleteObjectRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html @@ -106,7 +106,7 @@ final class DeleteObjectRequest extends Input * * > This functionality is only supported for directory buckets. * - * [^1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232 + * [^1]: https://tools.ietf.org/html/rfc7232 * * @var string|null */ diff --git a/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php b/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php index ac99ef348..09d409d6b 100644 --- a/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php +++ b/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php @@ -19,11 +19,11 @@ final class DeleteObjectTaggingRequest extends Input * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more * information about access point ARNs, see Using access points [^1] in the *Amazon S3 User Guide*. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html diff --git a/src/Service/S3/src/Input/DeleteObjectsRequest.php b/src/Service/S3/src/Input/DeleteObjectsRequest.php index 75441fb18..ad9f65ab9 100644 --- a/src/Service/S3/src/Input/DeleteObjectsRequest.php +++ b/src/Service/S3/src/Input/DeleteObjectsRequest.php @@ -18,9 +18,9 @@ final class DeleteObjectsRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -31,11 +31,11 @@ final class DeleteObjectsRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/GetObjectRequest.php b/src/Service/S3/src/Input/GetObjectRequest.php index 5e4e276cd..3f3c47505 100644 --- a/src/Service/S3/src/Input/GetObjectRequest.php +++ b/src/Service/S3/src/Input/GetObjectRequest.php @@ -17,9 +17,9 @@ final class GetObjectRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -34,11 +34,11 @@ final class GetObjectRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html @@ -291,12 +291,6 @@ final class GetObjectRequest extends Input /** * To retrieve the checksum, this mode must be enabled. * - * **General purpose buckets** - In addition, if you enable checksum mode and the object is uploaded with a checksum - * [^1] and encrypted with an Key Management Service (KMS) key, you must have permission to use the `kms:Decrypt` action - * to retrieve the checksum. - * - * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html - * * @var ChecksumMode::*|null */ private $checksumMode; diff --git a/src/Service/S3/src/Input/GetObjectTaggingRequest.php b/src/Service/S3/src/Input/GetObjectTaggingRequest.php index cc3def1a1..7ca511854 100644 --- a/src/Service/S3/src/Input/GetObjectTaggingRequest.php +++ b/src/Service/S3/src/Input/GetObjectTaggingRequest.php @@ -20,11 +20,11 @@ final class GetObjectTaggingRequest extends Input * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more * information about access point ARNs, see Using access points [^1] in the *Amazon S3 User Guide*. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html diff --git a/src/Service/S3/src/Input/HeadBucketRequest.php b/src/Service/S3/src/Input/HeadBucketRequest.php index 76ffaf5a2..0353115dd 100644 --- a/src/Service/S3/src/Input/HeadBucketRequest.php +++ b/src/Service/S3/src/Input/HeadBucketRequest.php @@ -15,9 +15,9 @@ final class HeadBucketRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -33,11 +33,11 @@ final class HeadBucketRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^4] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^4] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/HeadObjectRequest.php b/src/Service/S3/src/Input/HeadObjectRequest.php index 811366012..854b6aee3 100644 --- a/src/Service/S3/src/Input/HeadObjectRequest.php +++ b/src/Service/S3/src/Input/HeadObjectRequest.php @@ -17,9 +17,9 @@ final class HeadObjectRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -30,11 +30,11 @@ final class HeadObjectRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/ListMultipartUploadsRequest.php b/src/Service/S3/src/Input/ListMultipartUploadsRequest.php index 2e38ffbfe..5b1e306b3 100644 --- a/src/Service/S3/src/Input/ListMultipartUploadsRequest.php +++ b/src/Service/S3/src/Input/ListMultipartUploadsRequest.php @@ -17,9 +17,9 @@ final class ListMultipartUploadsRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -30,11 +30,11 @@ final class ListMultipartUploadsRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/ListObjectsV2Request.php b/src/Service/S3/src/Input/ListObjectsV2Request.php index 857d0860f..39a92a3d5 100644 --- a/src/Service/S3/src/Input/ListObjectsV2Request.php +++ b/src/Service/S3/src/Input/ListObjectsV2Request.php @@ -16,9 +16,9 @@ final class ListObjectsV2Request extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -29,11 +29,11 @@ final class ListObjectsV2Request extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/ListPartsRequest.php b/src/Service/S3/src/Input/ListPartsRequest.php index f3bc1344d..ffd96c5a7 100644 --- a/src/Service/S3/src/Input/ListPartsRequest.php +++ b/src/Service/S3/src/Input/ListPartsRequest.php @@ -16,9 +16,9 @@ final class ListPartsRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -29,11 +29,11 @@ final class ListPartsRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/PutBucketCorsRequest.php b/src/Service/S3/src/Input/PutBucketCorsRequest.php index 07fa42449..726e23b5b 100644 --- a/src/Service/S3/src/Input/PutBucketCorsRequest.php +++ b/src/Service/S3/src/Input/PutBucketCorsRequest.php @@ -46,10 +46,11 @@ final class PutBucketCorsRequest extends Input private $contentMd5; /** - * Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide - * any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding - * `x-amz-checksum` or `x-amz-trailer` header sent. Otherwise, Amazon S3 fails the request with the HTTP status code - * `400 Bad Request`. For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*. + * Indicates the algorithm used to create the checksum for the request when you use the SDK. This header will not + * provide any additional functionality if you don't use the SDK. When you send this header, there must be a + * corresponding `x-amz-checksum` or `x-amz-trailer` header sent. Otherwise, Amazon S3 fails the request with the HTTP + * status code `400 Bad Request`. For more information, see Checking object integrity [^1] in the *Amazon S3 User + * Guide*. * * If you provide an individual checksum, Amazon S3 ignores any provided `ChecksumAlgorithm` parameter. * diff --git a/src/Service/S3/src/Input/PutBucketTaggingRequest.php b/src/Service/S3/src/Input/PutBucketTaggingRequest.php index 387d633ae..506ea83cb 100644 --- a/src/Service/S3/src/Input/PutBucketTaggingRequest.php +++ b/src/Service/S3/src/Input/PutBucketTaggingRequest.php @@ -35,10 +35,11 @@ final class PutBucketTaggingRequest extends Input private $contentMd5; /** - * Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide - * any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding - * `x-amz-checksum` or `x-amz-trailer` header sent. Otherwise, Amazon S3 fails the request with the HTTP status code - * `400 Bad Request`. For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*. + * Indicates the algorithm used to create the checksum for the request when you use the SDK. This header will not + * provide any additional functionality if you don't use the SDK. When you send this header, there must be a + * corresponding `x-amz-checksum` or `x-amz-trailer` header sent. Otherwise, Amazon S3 fails the request with the HTTP + * status code `400 Bad Request`. For more information, see Checking object integrity [^1] in the *Amazon S3 User + * Guide*. * * If you provide an individual checksum, Amazon S3 ignores any provided `ChecksumAlgorithm` parameter. * diff --git a/src/Service/S3/src/Input/PutObjectAclRequest.php b/src/Service/S3/src/Input/PutObjectAclRequest.php index 650280932..2571ffd34 100644 --- a/src/Service/S3/src/Input/PutObjectAclRequest.php +++ b/src/Service/S3/src/Input/PutObjectAclRequest.php @@ -41,11 +41,11 @@ final class PutObjectAclRequest extends Input * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more * information about access point ARNs, see Using access points [^1] in the *Amazon S3 User Guide*. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html diff --git a/src/Service/S3/src/Input/PutObjectRequest.php b/src/Service/S3/src/Input/PutObjectRequest.php index c28de0394..1873a89d7 100644 --- a/src/Service/S3/src/Input/PutObjectRequest.php +++ b/src/Service/S3/src/Input/PutObjectRequest.php @@ -58,9 +58,9 @@ final class PutObjectRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -71,11 +71,11 @@ final class PutObjectRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html @@ -500,14 +500,12 @@ final class PutObjectRequest extends Input * `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the Amazon Web Services managed key (`aws/s3`) to * protect the data. * - * **Directory buckets** - If you specify `x-amz-server-side-encryption` with `aws:kms`, the ` - * x-amz-server-side-encryption-aws-kms-key-id` header is implicitly assigned the ID of the KMS symmetric encryption - * customer managed key that's configured for your directory bucket's default encryption setting. If you want to specify - * the ` x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you can only specify it with the ID (Key ID or - * Key ARN) of the KMS customer managed key that's configured for your directory bucket's default encryption setting. - * Otherwise, you get an HTTP `400 Bad Request` error. Only use the key ID or key ARN. The key alias format of the KMS - * key isn't supported. Your SSE-KMS configuration can only support 1 customer managed key [^1] per directory bucket for - * the lifetime of the bucket. The Amazon Web Services managed key [^2] (`aws/s3`) isn't supported. + * **Directory buckets** - To encrypt data using SSE-KMS, it's recommended to specify the `x-amz-server-side-encryption` + * header to `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id` header implicitly uses the bucket's + * default KMS customer managed key ID. If you want to explicitly set the ` x-amz-server-side-encryption-aws-kms-key-id` + * header, it must match the bucket's default customer managed key (using key ID or ARN, not alias). Your SSE-KMS + * configuration can only support 1 customer managed key [^1] per directory bucket's lifetime. The Amazon Web Services + * managed key [^2] (`aws/s3`) isn't supported. Incorrect key specification results in an HTTP `400 Bad Request` error. * * [^1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk * [^2]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk diff --git a/src/Service/S3/src/Input/PutObjectTaggingRequest.php b/src/Service/S3/src/Input/PutObjectTaggingRequest.php index d8a21a78f..b5fe8c170 100644 --- a/src/Service/S3/src/Input/PutObjectTaggingRequest.php +++ b/src/Service/S3/src/Input/PutObjectTaggingRequest.php @@ -23,11 +23,11 @@ final class PutObjectTaggingRequest extends Input * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more * information about access point ARNs, see Using access points [^1] in the *Amazon S3 User Guide*. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^2] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html diff --git a/src/Service/S3/src/Input/UploadPartCopyRequest.php b/src/Service/S3/src/Input/UploadPartCopyRequest.php index 04bd4db72..08b158589 100644 --- a/src/Service/S3/src/Input/UploadPartCopyRequest.php +++ b/src/Service/S3/src/Input/UploadPartCopyRequest.php @@ -16,9 +16,9 @@ final class UploadPartCopyRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * > Copying objects across different Amazon Web Services Regions isn't supported when the source or destination bucket * > is in Amazon Web Services Local Zones. The source and destination buckets must have the same parent Amazon Web @@ -33,11 +33,11 @@ final class UploadPartCopyRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Input/UploadPartRequest.php b/src/Service/S3/src/Input/UploadPartRequest.php index 77d91c521..398874235 100644 --- a/src/Service/S3/src/Input/UploadPartRequest.php +++ b/src/Service/S3/src/Input/UploadPartRequest.php @@ -24,9 +24,9 @@ final class UploadPartRequest extends Input * **Directory buckets** - When you use this operation with a directory bucket, you must use virtual-hosted-style * requests in the format `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. Path-style requests are not * supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names - * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, `*DOC-EXAMPLE-BUCKET*--*usw2-az1*--x-s3`). - * For information about bucket naming restrictions, see Directory bucket naming rules [^1] in the *Amazon S3 User - * Guide*. + * must follow the format `*bucket-base-name*--*zone-id*--x-s3` (for example, + * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket + * naming rules [^1] in the *Amazon S3 User Guide*. * * **Access points** - When you use this action with an access point, you must provide the alias of the access point in * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests @@ -37,11 +37,11 @@ final class UploadPartRequest extends Input * * > Access points and Object Lambda access points are not supported by directory buckets. * - * **S3 on Outposts** - When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on - * Outposts hostname. The S3 on Outposts hostname takes the form + * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts + * hostname. The S3 on Outposts hostname takes the form * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. When you use this action with S3 on - * Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. - * For more information about S3 on Outposts ARNs, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. + * Outposts, the destination bucket must be the Outposts access point ARN or the access point alias. For more + * information about S3 on Outposts, see What is S3 on Outposts? [^3] in the *Amazon S3 User Guide*. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html diff --git a/src/Service/S3/src/Result/DeleteObjectOutput.php b/src/Service/S3/src/Result/DeleteObjectOutput.php index 63cbfdc1b..54eb85673 100644 --- a/src/Service/S3/src/Result/DeleteObjectOutput.php +++ b/src/Service/S3/src/Result/DeleteObjectOutput.php @@ -11,10 +11,12 @@ class DeleteObjectOutput extends Result /** * Indicates whether the specified object version that was permanently deleted was (true) or was not (false) a delete * marker before deletion. In a simple DELETE, this header indicates whether (true) or not (false) the current version - * of the object is a delete marker. + * of the object is a delete marker. To learn more about delete markers, see Working with delete markers [^1]. * * > This functionality is not supported for directory buckets. * + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html + * * @var bool|null */ private $deleteMarker; diff --git a/src/Service/S3/src/Result/ListObjectVersionsOutput.php b/src/Service/S3/src/Result/ListObjectVersionsOutput.php index 603a552d7..5268e58ab 100644 --- a/src/Service/S3/src/Result/ListObjectVersionsOutput.php +++ b/src/Service/S3/src/Result/ListObjectVersionsOutput.php @@ -69,7 +69,10 @@ class ListObjectVersionsOutput extends Result implements \IteratorAggregate private $versions; /** - * Container for an object that is a delete marker. + * Container for an object that is a delete marker. To learn more about delete markers, see Working with delete markers + * [^1]. + * + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html * * @var DeleteMarkerEntry[] */ diff --git a/src/Service/S3/src/S3Client.php b/src/Service/S3/src/S3Client.php index 5a82af420..96c7a5d1a 100644 --- a/src/Service/S3/src/S3Client.php +++ b/src/Service/S3/src/S3Client.php @@ -120,10 +120,10 @@ class S3Client extends AbstractApi * > the `AbortMultipartUpload` operation to abort all the in-progress multipart uploads. * > - **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^3] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^3] in the *Amazon S3 User Guide*. * > * * - `Permissions`: @@ -153,7 +153,7 @@ class S3Client extends AbstractApi * - ListMultipartUploads [^11] * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html - * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html @@ -260,10 +260,10 @@ public function bucketNotExists($input): BucketNotExistsWaiter * * > **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal endpoint. * > These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are + * > not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^5] in the *Amazon S3 User Guide*. For more information about endpoints in - * > Local Zones, see Available Local Zone for directory buckets [^6] in the *Amazon S3 User Guide*. + * > Local Zones, see Concepts for directory buckets in Local Zones [^6] in the *Amazon S3 User Guide*. * * - `Permissions`: * @@ -329,7 +329,7 @@ public function bucketNotExists($input): BucketNotExistsWaiter * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html - * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html @@ -390,10 +390,10 @@ public function completeMultipartUpload($input): CompleteMultipartUploadOutput * > Multi-Region Access Point ARN. * > - **Directory buckets ** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^3] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^3] in the *Amazon S3 User Guide*. * > - VPC endpoints don't support cross-Region requests (including copies). If you're using VPC endpoints, your source * > and destination buckets should be in the same Amazon Web Services Region as your VPC endpoint. * > @@ -480,8 +480,13 @@ public function completeMultipartUpload($input): CompleteMultipartUploadOutput * pricing information, see Amazon S3 pricing [^10]. * - `HTTP Host header syntax`: * - * **Directory buckets ** - The HTTP Host header syntax is - * `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. + * - **Directory buckets ** - The HTTP Host header syntax is + * `*Bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com`. + * - **Amazon S3 on Outposts** - When you use this action with S3 on Outposts through the REST API, you must direct + * requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form + * `*AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com`. The hostname isn't required when + * you use the Amazon Web Services CLI or SDKs. + * * * The following operations are related to `CopyObject`: * @@ -489,7 +494,7 @@ public function completeMultipartUpload($input): CompleteMultipartUploadOutput * - GetObject [^12] * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html - * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^4]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html @@ -583,7 +588,7 @@ public function copyObject($input): CopyObjectOutput * > `https://s3express-control.*region-code*.amazonaws.com/*bucket-name*`. Virtual-hosted-style requests aren't * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^4] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^5] in the *Amazon S3 User Guide*. + * > in Local Zones, see Concepts for directory buckets in Local Zones [^5] in the *Amazon S3 User Guide*. * > * * - `Permissions`: @@ -645,7 +650,7 @@ public function copyObject($input): CopyObjectOutput * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html - * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html @@ -708,10 +713,10 @@ public function createBucket($input): CreateBucketOutput * > - **Directory buckets ** - S3 Lifecycle is not supported by directory buckets. * > - **Directory buckets ** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^4] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^5] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^4] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^5] in the *Amazon S3 User Guide*. * > * * - `Request signing`: @@ -840,7 +845,7 @@ public function createBucket($input): CreateBucketOutput * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config - * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions @@ -924,7 +929,7 @@ public function createMultipartUpload($input): CreateMultipartUploadOutput * > `https://s3express-control.*region-code*.amazonaws.com/*bucket-name*`. Virtual-hosted-style requests aren't * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^1] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^2] in the *Amazon S3 User Guide*. + * > in Local Zones, see Concepts for directory buckets in Local Zones [^2] in the *Amazon S3 User Guide*. * > * * - `Permissions`: @@ -946,7 +951,7 @@ public function createMultipartUpload($input): CreateMultipartUploadOutput * - CreateBucket [^4] * - DeleteObject [^5] * - * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html @@ -1027,10 +1032,10 @@ public function deleteBucketCors($input): Result * > `versionId` query parameter in the request. * > - **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^3] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^4] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^3] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^4] in the *Amazon S3 User Guide*. * > * * To remove a specific version, you must use the `versionId` query parameter. Using this query parameter permanently @@ -1080,7 +1085,7 @@ public function deleteBucketCors($input): Result * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html - * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete @@ -1159,19 +1164,19 @@ public function deleteObjectTagging($input): DeleteObjectTaggingOutput * object keys that you want to delete, then this operation provides a suitable alternative to sending individual delete * requests, reducing per-request overhead. * - * The request can contain a list of up to 1000 keys that you want to delete. In the XML, you provide the object key + * The request can contain a list of up to 1,000 keys that you want to delete. In the XML, you provide the object key * names, and optionally, version IDs if you want to delete a specific version of the object from a versioning-enabled * bucket. For each key, Amazon S3 performs a delete operation and returns the result of that delete, success or - * failure, in the response. Note that if the object specified in the request is not found, Amazon S3 returns the result - * as deleted. + * failure, in the response. If the object specified in the request isn't found, Amazon S3 confirms the deletion by + * returning the result as deleted. * * > - **Directory buckets** - S3 Versioning isn't enabled and supported for directory buckets. * > - **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^1] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^2] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^1] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^2] in the *Amazon S3 User Guide*. * > * * The operation supports two modes for the response: verbose and quiet. By default, the operation uses verbose mode in @@ -1227,7 +1232,7 @@ public function deleteObjectTagging($input): DeleteObjectTaggingOutput * - ListParts [^9] * - AbortMultipartUpload [^10] * - * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html @@ -1378,13 +1383,13 @@ public function getBucketEncryption($input): GetBucketEncryptionOutput * Bucket Specification [^1] in the *Amazon S3 User Guide*. * * **Directory buckets** - Only virtual-hosted-style requests are supported. For a virtual hosted-style request example, - * if you have the object `photos/2006/February/sample.jpg` in the bucket named `examplebucket--use1-az5--x-s3`, specify - * the object key name as `/photos/2006/February/sample.jpg`. Also, when you make requests to this API operation, your - * requests are sent to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format - * `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for directory - * buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about endpoints in Local - * Zones, see Available Local Zone for directory buckets [^3] in the *Amazon S3 User Guide*. + * if you have the object `photos/2006/February/sample.jpg` in the bucket named `amzn-s3-demo-bucket--usw2-az1--x-s3`, + * specify the object key name as `/photos/2006/February/sample.jpg`. Also, when you make requests to this API + * operation, your requests are sent to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the + * format `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are + * not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for + * directory buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about endpoints in + * Local Zones, see Concepts for directory buckets in Local Zones [^3] in the *Amazon S3 User Guide*. * * - `Permissions`: * @@ -1478,7 +1483,7 @@ public function getBucketEncryption($input): GetBucketEncryptionOutput * - GetObjectAcl [^11] * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket - * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html @@ -1720,10 +1725,10 @@ public function getObjectTagging($input): GetObjectTaggingOutput * * > For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints * > support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^8] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^9] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^8] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^9] in the *Amazon S3 User Guide*. * * * The following actions are related to `HeadObject`: @@ -1738,7 +1743,7 @@ public function getObjectTagging($input): GetObjectTaggingOutput * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html - * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html @@ -1848,10 +1853,10 @@ public function listBuckets($input = []): ListBucketsOutput * * > **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal endpoint. * > These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are + * > not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^2] in the *Amazon S3 User Guide*. For more information about endpoints in - * > Local Zones, see Available Local Zone for directory buckets [^3] in the *Amazon S3 User Guide*. + * > Local Zones, see Concepts for directory buckets in Local Zones [^3] in the *Amazon S3 User Guide*. * * - `Permissions`: * @@ -1893,7 +1898,7 @@ public function listBuckets($input = []): ListBucketsOutput * - AbortMultipartUpload [^11] * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html - * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html @@ -1994,10 +1999,10 @@ public function listObjectVersions($input): ListObjectVersionsOutput * > only to in-progress multipart uploads. * > - **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^3] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^4] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^3] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^4] in the *Amazon S3 User Guide*. * > * * - `Permissions`: @@ -2039,7 +2044,7 @@ public function listObjectVersions($input): ListObjectVersionsOutput * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html - * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html @@ -2098,10 +2103,10 @@ public function listObjectsV2($input): ListObjectsV2Output * * > **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal endpoint. * > These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are + * > not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^3] in the *Amazon S3 User Guide*. For more information about endpoints in - * > Local Zones, see Available Local Zone for directory buckets [^4] in the *Amazon S3 User Guide*. + * > Local Zones, see Concepts for directory buckets in Local Zones [^4] in the *Amazon S3 User Guide*. * * - `Permissions`: * @@ -2136,7 +2141,7 @@ public function listObjectsV2($input): ListObjectsV2Output * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html - * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html @@ -2455,10 +2460,10 @@ public function putBucketTagging($input): Result * > affect permissions. All objects written to the bucket by any account will be owned by the bucket owner. * > - **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal * > endpoint. These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for - * > directory buckets in Availability Zones [^1] in the *Amazon S3 User Guide*. For more information about endpoints - * > in Local Zones, see Available Local Zone for directory buckets [^2] in the *Amazon S3 User Guide*. + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests + * > are not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints + * > for directory buckets in Availability Zones [^1] in the *Amazon S3 User Guide*. For more information about + * > endpoints in Local Zones, see Concepts for directory buckets in Local Zones [^2] in the *Amazon S3 User Guide*. * > * * Amazon S3 is a distributed system. If it receives multiple write requests for the same object simultaneously, it @@ -2469,12 +2474,23 @@ public function putBucketTagging($input): Result * * > This functionality is not supported for directory buckets. * + * - **If-None-Match** - Uploads the object only if the object key name does not already exist in the specified bucket. + * Otherwise, Amazon S3 returns a `412 Precondition Failed` error. If a conflicting operation occurs during the + * upload, S3 returns a `409 ConditionalRequestConflict` response. On a 409 failure, retry the upload. + * + * Expects the * character (asterisk). + * + * For more information, see Add preconditions to S3 operations with conditional requests [^4] in the *Amazon S3 User + * Guide* or RFC 7232 [^5]. + * + * > This functionality is not supported for S3 on Outposts. + * * - **S3 Versioning** - When you enable versioning for a bucket, if Amazon S3 receives multiple write requests for the * same object simultaneously, it stores all versions of the objects. For each write request that is made to the same * object, Amazon S3 automatically generates a unique version ID of that object being stored in Amazon S3. You can * retrieve, replace, or delete any version of the object. For more information about versioning, see Adding Objects - * to Versioning-Enabled Buckets [^4] in the *Amazon S3 User Guide*. For information about returning the versioning - * state of a bucket, see GetBucketVersioning [^5]. + * to Versioning-Enabled Buckets [^6] in the *Amazon S3 User Guide*. For information about returning the versioning + * state of a bucket, see GetBucketVersioning [^7]. * * > This functionality is not supported for directory buckets. * @@ -2492,13 +2508,13 @@ public function putBucketTagging($input): Result * `s3:PutObjectTagging`. * * - **Directory bucket permissions** - To grant access to this API operation on a directory bucket, we recommend that - * you use the `CreateSession` [^6] API operation for session-based authorization. Specifically, you grant the + * you use the `CreateSession` [^8] API operation for session-based authorization. Specifically, you grant the * `s3express:CreateSession` permission to the directory bucket in a bucket policy or an IAM identity-based policy. * Then, you make the `CreateSession` API call on the bucket to obtain a session token. With the session token in * your request header, you can make API requests to this operation. After the session token expires, you make * another `CreateSession` API call to generate a new session token for use. Amazon Web Services CLI or SDKs create * session and refresh the session token automatically to avoid service interruptions when a session expires. For - * more information about authorization, see `CreateSession` [^7]. + * more information about authorization, see `CreateSession` [^9]. * * If the object is encrypted with SSE-KMS, you must also have the `kms:GenerateDataKey` and `kms:Decrypt` * permissions in IAM identity-based policies and KMS key policies for the KMS key. @@ -2518,18 +2534,20 @@ public function putBucketTagging($input): Result * * For more information about related Amazon S3 APIs, see the following: * - * - CopyObject [^8] - * - DeleteObject [^9] + * - CopyObject [^10] + * - DeleteObject [^11] * - * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html - * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html - * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html - * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html - * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html - * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html - * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html + * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html + * [^5]: https://datatracker.ietf.org/doc/rfc7232/ + * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html + * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html + * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html + * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html + * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html + * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html * * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPUT.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html @@ -2841,10 +2859,10 @@ public function putObjectTagging($input): PutObjectTaggingOutput * * > **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal endpoint. * > These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are + * > not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^5] in the *Amazon S3 User Guide*. For more information about endpoints in - * > Local Zones, see Available Local Zone for directory buckets [^6] in the *Amazon S3 User Guide*. + * > Local Zones, see Concepts for directory buckets in Local Zones [^6] in the *Amazon S3 User Guide*. * * - `Permissions`: * @@ -2938,7 +2956,7 @@ public function putObjectTagging($input): PutObjectTaggingOutput * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html - * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html @@ -3008,10 +3026,10 @@ public function uploadPart($input): UploadPartOutput * * > **Directory buckets** - For directory buckets, you must make requests for this API operation to the Zonal endpoint. * > These endpoints support virtual-hosted-style requests in the format - * > `https://*bucket-name*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are not - * > supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for + * > `https://*amzn-s3-demo-bucket*.s3express-*zone-id*.*region-code*.amazonaws.com/*key-name*`. Path-style requests are + * > not supported. For more information about endpoints in Availability Zones, see Regional and Zonal endpoints for * > directory buckets in Availability Zones [^5] in the *Amazon S3 User Guide*. For more information about endpoints in - * > Local Zones, see Available Local Zone for directory buckets [^6] in the *Amazon S3 User Guide*. + * > Local Zones, see Concepts for directory buckets in Local Zones [^6] in the *Amazon S3 User Guide*. * * - `Authentication and authorization`: * @@ -3112,7 +3130,7 @@ public function uploadPart($input): UploadPartOutput * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html - * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html + * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html diff --git a/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php b/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php index 81c5d8d16..cb8010d86 100644 --- a/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php +++ b/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php @@ -13,14 +13,16 @@ final class CreateBucketConfiguration /** * Specifies the Region where the bucket will be created. You might choose a Region to optimize latency, minimize costs, * or address regulatory requirements. For example, if you reside in Europe, you will probably find it advantageous to - * create buckets in the Europe (Ireland) Region. For more information, see Accessing a bucket [^1] in the *Amazon S3 - * User Guide*. + * create buckets in the Europe (Ireland) Region. * * If you don't specify a Region, the bucket is created in the US East (N. Virginia) Region (us-east-1) by default. + * Configurations using the value `EU` will create a bucket in `eu-west-1`. + * + * For a list of the valid values for all of the Amazon Web Services Regions, see Regions and Endpoints [^1]. * * > This functionality is not supported for directory buckets. * - * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro + * [^1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region * * @var BucketLocationConstraint::*|null */ @@ -29,9 +31,9 @@ final class CreateBucketConfiguration /** * Specifies the location where the bucket will be created. * - * **Directory buckets ** - The location type is Availability Zone or Local Zone. When the location type is Local Zone, - * your Local Zone must be in opt-in status. Otherwise, you get an HTTP `400 Bad Request` error with the error code - * `Access denied`. To learn more about opt-in Local Zones, see Opt-in Dedicated Local Zones [^1]in the *Amazon S3 User + * **Directory buckets ** - The location type is Availability Zone or Local Zone. To use the Local Zone location type, + * your account must be enabled for Dedicated Local Zones. Otherwise, you get an HTTP `403 Forbidden` error with the + * error code `AccessDenied`. To learn more, see Enable accounts for Dedicated Local Zones [^1] in the *Amazon S3 User * Guide*. * * > This functionality is only supported by directory buckets. diff --git a/src/Service/S3/src/ValueObject/DeleteMarkerEntry.php b/src/Service/S3/src/ValueObject/DeleteMarkerEntry.php index 18569b70c..dd758a019 100644 --- a/src/Service/S3/src/ValueObject/DeleteMarkerEntry.php +++ b/src/Service/S3/src/ValueObject/DeleteMarkerEntry.php @@ -8,7 +8,7 @@ final class DeleteMarkerEntry { /** - * The account that created the delete marker.>. + * The account that created the delete marker. * * @var Owner|null */ diff --git a/src/Service/S3/src/ValueObject/DeletedObject.php b/src/Service/S3/src/ValueObject/DeletedObject.php index 04e22c5a9..1d3439a83 100644 --- a/src/Service/S3/src/ValueObject/DeletedObject.php +++ b/src/Service/S3/src/ValueObject/DeletedObject.php @@ -26,10 +26,12 @@ final class DeletedObject /** * Indicates whether the specified object version that was permanently deleted was (true) or was not (false) a delete * marker before deletion. In a simple DELETE, this header indicates whether (true) or not (false) the current version - * of the object is a delete marker. + * of the object is a delete marker. To learn more about delete markers, see Working with delete markers [^1]. * * > This functionality is not supported for directory buckets. * + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html + * * @var bool|null */ private $deleteMarker; diff --git a/src/Service/S3/src/ValueObject/LocationInfo.php b/src/Service/S3/src/ValueObject/LocationInfo.php index 517f85cef..44f91ea3b 100644 --- a/src/Service/S3/src/ValueObject/LocationInfo.php +++ b/src/Service/S3/src/ValueObject/LocationInfo.php @@ -9,7 +9,7 @@ * Specifies the location where the bucket will be created. * * For directory buckets, the location type is Availability Zone or Local Zone. For more information about directory - * buckets, see Directory buckets [^1] in the *Amazon S3 User Guide*. + * buckets, see Working with directory buckets [^1] in the *Amazon S3 User Guide*. * * > This functionality is only supported by directory buckets. * diff --git a/src/Service/S3/src/ValueObject/ServerSideEncryptionByDefault.php b/src/Service/S3/src/ValueObject/ServerSideEncryptionByDefault.php index 8a7a3c7e2..b35ad498f 100644 --- a/src/Service/S3/src/ValueObject/ServerSideEncryptionByDefault.php +++ b/src/Service/S3/src/ValueObject/ServerSideEncryptionByDefault.php @@ -15,7 +15,7 @@ * > time that you add an object encrypted with SSE-KMS to a bucket. By default, Amazon S3 uses this KMS key for * > SSE-KMS. * > - **Directory buckets** - Your SSE-KMS configuration can only support 1 customer managed key [^2] per directory - * > bucket for the lifetime of the bucket. The Amazon Web Services managed key [^3] (`aws/s3`) isn't supported. + * > bucket's lifetime. The Amazon Web Services managed key [^3] (`aws/s3`) isn't supported. * > - **Directory buckets** - For directory buckets, there are only two supported options for server-side encryption: * > SSE-S3 and SSE-KMS. * > diff --git a/src/Service/Translate/CHANGELOG.md b/src/Service/Translate/CHANGELOG.md index eb2625f4d..88f69ea9b 100644 --- a/src/Service/Translate/CHANGELOG.md +++ b/src/Service/Translate/CHANGELOG.md @@ -5,6 +5,8 @@ ### Added - AWS api-change: Added `us-isof-east-1` and `us-isof-south-1` regions +- AWS api-change: Added `us-iso-east-1-fips` region +- ``` ## 1.1.0 diff --git a/src/Service/Translate/src/TranslateClient.php b/src/Service/Translate/src/TranslateClient.php index 6b4068d48..9487d6db8 100644 --- a/src/Service/Translate/src/TranslateClient.php +++ b/src/Service/Translate/src/TranslateClient.php @@ -127,6 +127,13 @@ protected function getEndpointMetadata(?string $region): array 'signService' => 'translate', 'signVersions' => ['v4'], ]; + case 'us-iso-east-1-fips': + return [ + 'endpoint' => 'https://translate-fips.us-iso-east-1.c2s.ic.gov', + 'signRegion' => 'us-iso-east-1', + 'signService' => 'translate', + 'signVersions' => ['v4'], + ]; } return [