forked from awsdocs/aws-doc-sdk-examples
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
JavaScript (v3): S3 - Standardize S3 examples as per the audit. 🧵 1/2 (…
- Loading branch information
Showing
55 changed files
with
2,026 additions
and
601 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,7 +1,14 @@ | ||
| // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. | ||
| // SPDX-License-Identifier: Apache-2.0 | ||
| import { fileURLToPath } from "url"; | ||
|
|
||
| export const getEnv = (/** @type {string} */ key) => process.env[key]; | ||
| export const setEnv = (/** @type {string} */ key, value) => { | ||
| process.env[key] = value; | ||
| }; | ||
|
|
||
| /** | ||
| * Check if the running file was run directly. | ||
| * @param {string | URL} fileUrl | ||
| */ | ||
| export const isMain = (fileUrl) => process.argv[1] === fileURLToPath(fileUrl); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,33 +1,81 @@ | ||
| // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. | ||
| // SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| import { fileURLToPath } from "url"; | ||
|
|
||
| // snippet-start:[s3.JavaScript.buckets.copyObjectV3] | ||
| import { S3Client, CopyObjectCommand } from "@aws-sdk/client-s3"; | ||
|
|
||
| const client = new S3Client({}); | ||
| import { | ||
| S3Client, | ||
| CopyObjectCommand, | ||
| ObjectNotInActiveTierError, | ||
| waitUntilObjectExists, | ||
| } from "@aws-sdk/client-s3"; | ||
|
|
||
| /** | ||
| * Copy an Amazon S3 object from one bucket to another. | ||
| * Copy an S3 object from one bucket to another. | ||
| * | ||
| * @param {{ | ||
| * sourceBucket: string, | ||
| * sourceKey: string, | ||
| * destinationBucket: string, | ||
| * destinationKey: string }} config | ||
| */ | ||
| export const main = async () => { | ||
| const command = new CopyObjectCommand({ | ||
| CopySource: "SOURCE_BUCKET/SOURCE_OBJECT_KEY", | ||
| Bucket: "DESTINATION_BUCKET", | ||
| Key: "NEW_OBJECT_KEY", | ||
| }); | ||
| export const main = async ({ | ||
| sourceBucket, | ||
| sourceKey, | ||
| destinationBucket, | ||
| destinationKey, | ||
| }) => { | ||
| const client = new S3Client({}); | ||
|
|
||
| try { | ||
| const response = await client.send(command); | ||
| console.log(response); | ||
| } catch (err) { | ||
| console.error(err); | ||
| await client.send( | ||
| new CopyObjectCommand({ | ||
| CopySource: `${sourceBucket}/${sourceKey}`, | ||
| Bucket: destinationBucket, | ||
| Key: destinationKey, | ||
| }), | ||
| ); | ||
| await waitUntilObjectExists( | ||
| { client }, | ||
| { Bucket: destinationBucket, Key: destinationKey }, | ||
| ); | ||
| console.log( | ||
| `Successfully copied ${sourceBucket}/${sourceKey} to ${destinationBucket}/${destinationKey}`, | ||
| ); | ||
| } catch (caught) { | ||
| if (caught instanceof ObjectNotInActiveTierError) { | ||
| console.error( | ||
| `Could not copy ${sourceKey} from ${sourceBucket}. Object is not in the active tier.`, | ||
| ); | ||
| } else { | ||
| throw caught; | ||
| } | ||
| } | ||
| }; | ||
| // snippet-end:[s3.JavaScript.buckets.copyObjectV3] | ||
|
|
||
| // Invoke main function if this file was run directly. | ||
| // Call function if run directly | ||
| import { fileURLToPath } from "url"; | ||
| import { parseArgs } from "util"; | ||
|
|
||
| if (process.argv[1] === fileURLToPath(import.meta.url)) { | ||
| main(); | ||
| const options = { | ||
| sourceBucket: { | ||
| type: "string", | ||
| default: "source-bucket", | ||
| }, | ||
| sourceKey: { | ||
| type: "string", | ||
| default: "todo.txt", | ||
| }, | ||
| destinationBucket: { | ||
| type: "string", | ||
| default: "destination-bucket", | ||
| }, | ||
| destinationKey: { | ||
| type: "string", | ||
| default: "todo.txt", | ||
| }, | ||
| }; | ||
| const { values } = parseArgs({ options }); | ||
| main(values); | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,30 +1,64 @@ | ||
| // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. | ||
| // SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| import { fileURLToPath } from "url"; | ||
|
|
||
| // snippet-start:[s3.JavaScript.buckets.createBucketV3] | ||
| import { CreateBucketCommand, S3Client } from "@aws-sdk/client-s3"; | ||
|
|
||
| const client = new S3Client({}); | ||
| import { | ||
| BucketAlreadyExists, | ||
| BucketAlreadyOwnedByYou, | ||
| CreateBucketCommand, | ||
| S3Client, | ||
| waitUntilBucketExists, | ||
| } from "@aws-sdk/client-s3"; | ||
|
|
||
| export const main = async () => { | ||
| const command = new CreateBucketCommand({ | ||
| // The name of the bucket. Bucket names are unique and have several other constraints. | ||
| // See https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html | ||
| Bucket: "bucket-name", | ||
| }); | ||
| /** | ||
| * Create an Amazon S3 bucket. | ||
| * @param {{ bucketName: string }} config | ||
| */ | ||
| export const main = async ({ bucketName }) => { | ||
| const client = new S3Client({}); | ||
|
|
||
| try { | ||
| const { Location } = await client.send(command); | ||
| const { Location } = await client.send( | ||
| new CreateBucketCommand({ | ||
| // The name of the bucket. Bucket names are unique and have several other constraints. | ||
| // See https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html | ||
| Bucket: bucketName, | ||
| }), | ||
| ); | ||
| await waitUntilBucketExists({ client }, { Bucket: bucketName }); | ||
| console.log(`Bucket created with location ${Location}`); | ||
| } catch (err) { | ||
| console.error(err); | ||
| } catch (caught) { | ||
| if (caught instanceof BucketAlreadyExists) { | ||
| console.error( | ||
| `The bucket "${bucketName}" already exists in another AWS account. Bucket names must be globally unique.`, | ||
| ); | ||
| } | ||
| // WARNING: If you try to create a bucket in the North Virginia region, | ||
| // and you already own a bucket in that region with the same name, this | ||
| // error will not be thrown. Instead, the call will return successfully | ||
| // and the ACL on that bucket will be reset. | ||
| else if (caught instanceof BucketAlreadyOwnedByYou) { | ||
| console.error( | ||
| `The bucket "${bucketName}" already exists in this AWS account.`, | ||
| ); | ||
| } else { | ||
| throw caught; | ||
| } | ||
| } | ||
| }; | ||
| // snippet-end:[s3.JavaScript.buckets.createBucketV3] | ||
|
|
||
| // Invoke main function if this file was run directly. | ||
| // Call function if run directly | ||
| import { fileURLToPath } from "url"; | ||
| import { parseArgs } from "util"; | ||
|
|
||
| if (process.argv[1] === fileURLToPath(import.meta.url)) { | ||
| main(); | ||
| const options = { | ||
| bucketName: { | ||
| type: "string", | ||
| default: "bucket-name", | ||
| }, | ||
| }; | ||
| const { values } = parseArgs({ options }); | ||
| main(values); | ||
| } |
60 changes: 44 additions & 16 deletions
60
javascriptv3/example_code/s3/actions/delete-bucket-policy.js
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,29 +1,57 @@ | ||
| // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. | ||
| // SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| import { fileURLToPath } from "url"; | ||
|
|
||
| // snippet-start:[s3.JavaScript.policy.deleteBucketPolicyV3] | ||
| import { DeleteBucketPolicyCommand, S3Client } from "@aws-sdk/client-s3"; | ||
|
|
||
| const client = new S3Client({}); | ||
| import { | ||
| DeleteBucketPolicyCommand, | ||
| S3Client, | ||
| S3ServiceException, | ||
| } from "@aws-sdk/client-s3"; | ||
|
|
||
| // This will remove the policy from the bucket. | ||
| export const main = async () => { | ||
| const command = new DeleteBucketPolicyCommand({ | ||
| Bucket: "test-bucket", | ||
| }); | ||
| /** | ||
| * Remove the policy from an Amazon S3 bucket. | ||
| * @param {{ bucketName: string }} | ||
| */ | ||
| export const main = async ({ bucketName }) => { | ||
| const client = new S3Client({}); | ||
|
|
||
| try { | ||
| const response = await client.send(command); | ||
| console.log(response); | ||
| } catch (err) { | ||
| console.error(err); | ||
| await client.send( | ||
| new DeleteBucketPolicyCommand({ | ||
| Bucket: bucketName, | ||
| }), | ||
| ); | ||
| console.log(`Bucket policy deleted from "${bucketName}".`); | ||
| } catch (caught) { | ||
| if ( | ||
| caught instanceof S3ServiceException && | ||
| caught.name === "NoSuchBucket" | ||
| ) { | ||
| console.error( | ||
| `Error from S3 while deleting policy from ${bucketName}. The bucket doesn't exist.`, | ||
| ); | ||
| } else if (caught instanceof S3ServiceException) { | ||
| console.error( | ||
| `Error from S3 while deleting policy from ${bucketName}. ${caught.name}: ${caught.message}`, | ||
| ); | ||
| } else { | ||
| throw caught; | ||
| } | ||
| } | ||
| }; | ||
| // snippet-end:[s3.JavaScript.policy.deleteBucketPolicyV3] | ||
|
|
||
| // Invoke main function if this file was run directly. | ||
| // Call function if run directly | ||
| import { fileURLToPath } from "url"; | ||
| import { parseArgs } from "util"; | ||
|
|
||
| if (process.argv[1] === fileURLToPath(import.meta.url)) { | ||
| main(); | ||
| const options = { | ||
| bucketName: { | ||
| type: "string", | ||
| default: "amzn-s3-demo-bucket", | ||
| }, | ||
| }; | ||
| const { values } = parseArgs({ options }); | ||
| main(values); | ||
| } |
Oops, something went wrong.