Skip to content

Commit a4b4303

Browse files
author
awstools
committed
feat(client-s3): Amazon S3 introduces support for AWS Dedicated Local Zones
1 parent a4af58b commit a4b4303

34 files changed

+1583
-564
lines changed

‎clients/client-s3/src/commands/AbortMultipartUploadCommand.ts

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -53,8 +53,9 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
5353
* <li>
5454
* <p>
5555
* <b>Directory buckets</b> -
56-
* 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 <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
57-
* </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
56+
* 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 <code>https://<i>bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
57+
* </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
58+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
5859
* <i>Amazon S3 User Guide</i>.</p>
5960
* </li>
6061
* </ul>
@@ -85,7 +86,7 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
8586
* <dd>
8687
* <p>
8788
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>
88-
* <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
89+
* <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>.</p>
8990
* </dd>
9091
* </dl>
9192
* <p>The following operations are related to <code>AbortMultipartUpload</code>:</p>

‎clients/client-s3/src/commands/CompleteMultipartUploadCommand.ts

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -74,8 +74,9 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
7474
* <note>
7575
* <p>
7676
* <b>Directory buckets</b> -
77-
* 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 <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
78-
* </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
77+
* 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 <code>https://<i>bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
78+
* </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
79+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
7980
* <i>Amazon S3 User Guide</i>.</p>
8081
* </note>
8182
* <dl>
@@ -173,7 +174,7 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
173174
* <dd>
174175
* <p>
175176
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>
176-
* <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
177+
* <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>.</p>
177178
* </dd>
178179
* </dl>
179180
* <p>The following operations are related to <code>CompleteMultipartUpload</code>:</p>

‎clients/client-s3/src/commands/CopyObjectCommand.ts

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,9 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
5454
* <li>
5555
* <p>
5656
* <b>Directory buckets </b> -
57-
* 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 <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
58-
* </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
57+
* 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 <code>https://<i>bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
58+
* </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
59+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
5960
* <i>Amazon S3 User Guide</i>.</p>
6061
* </li>
6162
* <li>
@@ -212,7 +213,7 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
212213
* <dd>
213214
* <p>
214215
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>
215-
* <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
216+
* <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>.</p>
216217
* </dd>
217218
* </dl>
218219
* <p>The following operations are related to <code>CopyObject</code>:</p>

‎clients/client-s3/src/commands/CreateBucketCommand.ts

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -57,9 +57,10 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
5757
* </li>
5858
* <li>
5959
* <p>
60-
* <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region_code</i>.amazonaws.com/<i>bucket-name</i>
60+
* <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
6161
* </code>. Virtual-hosted-style requests aren't supported.
62-
* For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
62+
* For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
63+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
6364
* <i>Amazon S3 User Guide</i>.</p>
6465
* </li>
6566
* </ul>
@@ -162,7 +163,7 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
162163
* <dt>HTTP Host header syntax</dt>
163164
* <dd>
164165
* <p>
165-
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region</i>.amazonaws.com</code>.</p>
166+
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
166167
* </dd>
167168
* </dl>
168169
* <p>The following operations are related to <code>CreateBucket</code>:</p>
@@ -190,11 +191,11 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
190191
* CreateBucketConfiguration: { // CreateBucketConfiguration
191192
* LocationConstraint: "af-south-1" || "ap-east-1" || "ap-northeast-1" || "ap-northeast-2" || "ap-northeast-3" || "ap-south-1" || "ap-south-2" || "ap-southeast-1" || "ap-southeast-2" || "ap-southeast-3" || "ca-central-1" || "cn-north-1" || "cn-northwest-1" || "EU" || "eu-central-1" || "eu-north-1" || "eu-south-1" || "eu-south-2" || "eu-west-1" || "eu-west-2" || "eu-west-3" || "me-south-1" || "sa-east-1" || "us-east-2" || "us-gov-east-1" || "us-gov-west-1" || "us-west-1" || "us-west-2",
192193
* Location: { // LocationInfo
193-
* Type: "AvailabilityZone",
194+
* Type: "AvailabilityZone" || "LocalZone",
194195
* Name: "STRING_VALUE",
195196
* },
196197
* Bucket: { // BucketInfo
197-
* DataRedundancy: "SingleAvailabilityZone",
198+
* DataRedundancy: "SingleAvailabilityZone" || "SingleLocalZone",
198199
* Type: "Directory",
199200
* },
200201
* },

‎clients/client-s3/src/commands/CreateMultipartUploadCommand.ts

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,8 +62,9 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
6262
* <li>
6363
* <p>
6464
* <b>Directory buckets </b> -
65-
* 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 <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
66-
* </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
65+
* 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 <code>https://<i>bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
66+
* </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
67+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
6768
* <i>Amazon S3 User Guide</i>.</p>
6869
* </li>
6970
* </ul>
@@ -270,7 +271,7 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
270271
* <dd>
271272
* <p>
272273
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>
273-
* <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
274+
* <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>.</p>
274275
* </dd>
275276
* </dl>
276277
* <p>The following operations are related to <code>CreateMultipartUpload</code>:</p>

‎clients/client-s3/src/commands/CreateSessionCommand.ts

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,8 @@ export interface CreateSessionCommandOutput extends CreateSessionOutput, __Metad
6161
* <note>
6262
* <ul>
6363
* <li>
64-
* <p>You must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
64+
* <p>You must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
65+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
6566
* <i>Amazon S3 User Guide</i>.</p>
6667
* </li>
6768
* <li>
@@ -139,7 +140,7 @@ export interface CreateSessionCommandOutput extends CreateSessionOutput, __Metad
139140
* <dd>
140141
* <p>
141142
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>
142-
* <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
143+
* <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>.</p>
143144
* </dd>
144145
* </dl>
145146
* @example

‎clients/client-s3/src/commands/DeleteBucketCommand.ts

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,9 +40,10 @@ export interface DeleteBucketCommandOutput extends __MetadataBearer {}
4040
* </li>
4141
* <li>
4242
* <p>
43-
* <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region_code</i>.amazonaws.com/<i>bucket-name</i>
43+
* <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
4444
* </code>. Virtual-hosted-style requests aren't supported.
45-
* For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
45+
* For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
46+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
4647
* <i>Amazon S3 User Guide</i>.</p>
4748
* </li>
4849
* </ul>
@@ -69,7 +70,7 @@ export interface DeleteBucketCommandOutput extends __MetadataBearer {}
6970
* <dt>HTTP Host header syntax</dt>
7071
* <dd>
7172
* <p>
72-
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region</i>.amazonaws.com</code>.</p>
73+
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
7374
* </dd>
7475
* </dl>
7576
* <p>The following operations are related to <code>DeleteBucket</code>:</p>

‎clients/client-s3/src/commands/DeleteBucketEncryptionCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {}
7373
* <dt>HTTP Host header syntax</dt>
7474
* <dd>
7575
* <p>
76-
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region</i>.amazonaws.com</code>.</p>
76+
* <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
7777
* </dd>
7878
* </dl>
7979
* <p>The following operations are related to <code>DeleteBucketEncryption</code>:</p>

‎clients/client-s3/src/commands/DeleteBucketLifecycleCommand.ts

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,9 +65,10 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {}
6565
* <i>Amazon S3 User Guide</i>.</p>
6666
* <note>
6767
* <p>
68-
* <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region_code</i>.amazonaws.com/<i>bucket-name</i>
68+
* <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
6969
* </code>. Virtual-hosted-style requests aren't supported.
70-
* For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
70+
* For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
71+
* <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Available Local Zone for directory buckets</a> in the
7172
* <i>Amazon S3 User Guide</i>.</p>
7273
* </note>
7374
* </li>

0 commit comments

Comments
 (0)