[適用於 JavaScript 的 AWS SDK V3 API 參考指南](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)詳細說明第 3 版適用於 JavaScript 的 AWS SDK (V3) 的所有 API 操作。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 適用於 JavaScript 的 SDK 程式碼範例本節中的主題包含如何使用適用於 JavaScript 的 AWS SDK 搭配各種服務的 APIs 來執行常見任務的範例。在 [AWS GitHub 上的程式碼範例儲存庫中尋找這些範例和其他範例的原始程式碼](https://github.com/awsdocs/aws-doc-sdk-examples)。若要提議新的程式碼範例，讓 AWS 文件團隊考慮生產，請建立請求。該團隊想要產生比僅涵蓋個別 API 呼叫之簡易程式碼更為廣泛的程式碼範例，以涵蓋更為廣泛的案例和使用案例。如需說明，請參閱 [ GitHub 上貢獻準則](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/CONTRIBUTING.md)中的*編寫程式碼*一節。 **重要** 這些範例使用 ECMAScript6 匯入/匯出語法。這需要 Node.js 14.17 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md) 以取得轉換準則。 **Topics** + [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md) + [AWS Elemental MediaConvert 範例](emc-examples.md) + [AWS Lambda 範例](lambda-examples.md) + [Amazon Lex 範例](lex-examples.md) + [Amazon Polly 範例](polly-examples.md) + [Amazon Redshift 範例](redshift-examples.md) + [Amazon Simple Email Service 範例](ses-examples.md) + [Amazon Simple Notification Service 範例](sns-examples.md) + [Amazon Transcribe 範例](Transcribe-examples.md) + [在 Amazon EC2 執行個體上設定 Node.js](setting-up-node-on-ec2-instance.md) + [使用 API Gateway 叫用 Lambda](api-gateway-invoking-lambda-example.md) + [建立排程事件以執行 AWS Lambda 函數](scheduled-events-invoking-lambda-example.md) + [建置 Amazon Lex 聊天機器人](lex-bot-example.md) # JavaScript ES6/CommonJS 語法適用於 JavaScript 的 AWS SDK 程式碼範例以 ECMAScript 6 (ES6) 撰寫。ES6 帶來新的語法和新功能，讓您的程式碼更現代化、更易讀，並執行更多操作。 ES6 要求您使用 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download)不過，如果您願意，您可以使用下列準則將我們的任何範例轉換為 CommonJS 語法： + `"type" : "module"` 從專案環境中`package.json`的移除。 + 將所有 ES6 `import`陳述式轉換為 CommonJS `require`陳述式。例如，轉換： ``` import { CreateBucketCommand } from "@aws-sdk/client-s3"; import { s3 } from "./libs/s3Client.js"; ``` 至其 CommonJS 對等項目： ``` const { CreateBucketCommand } = require("@aws-sdk/client-s3"); const { s3 } = require("./libs/s3Client.js"); ``` + 將所有 ES6 `export`陳述式轉換為 CommonJS `module.exports`陳述式。例如，轉換： ``` export {s3} ``` 至其 CommonJS 對等項目： ``` module.exports = {s3} ``` 下列範例示範在 ES6 和 CommonJS 中建立 Amazon S3 儲存貯體的程式碼範例。 ------ #### [ ES6 ] libs/s3Client.js ``` // Create service client module using ES6 syntax. import { S3Client } from "@aws-sdk/client-s3"; // Set the AWS region const REGION = "eu-west-1"; //e.g. "us-east-1" // Create Amazon S3 service object. const s3 = new S3Client({ region: REGION }); // Export 's3' constant. export {s3}; ``` s3\$1createbucket.js ``` // Get service clients module and commands using ES6 syntax. import { CreateBucketCommand } from "@aws-sdk/client-s3"; import { s3 } from "./libs/s3Client.js"; // Get service clients module and commands using CommonJS syntax. // const { CreateBucketCommand } = require("@aws-sdk/client-s3"); // const { s3 } = require("./libs/s3Client.js"); // Set the bucket parameters const bucketParams = { Bucket: "BUCKET_NAME" }; // Create the Amazon S3 bucket. const run = async () => { try { const data = await s3.send(new CreateBucketCommand(bucketParams)); console.log("Success", data.Location); return data; } catch (err) { console.log("Error", err); } }; run(); ``` ------ #### [ CommonJS ] libs/s3Client.js ``` // Create service client module using CommonJS syntax. const { S3Client } = require("@aws-sdk/client-s3"); // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Amazon S3 service object. const s3 = new S3Client({ region: REGION }); // Export 's3' constant. module.exports ={s3}; ``` s3\$1createbucket.js ``` // Get service clients module and commands using CommonJS syntax. const { CreateBucketCommand } = require("@aws-sdk/client-s3"); const { s3 } = require("./libs/s3Client.js"); // Set the bucket parameters const bucketParams = { Bucket: "BUCKET_NAME" }; // Create the Amazon S3 bucket. const run = async () => { try { const data = await s3.send(new CreateBucketCommand(bucketParams)); console.log("Success", data.Location); return data; } catch (err) { console.log("Error", err); } }; run(); ``` ------ # AWS Elemental MediaConvert 範例 AWS Elemental MediaConvert 是以檔案為基礎的視訊轉碼服務，具有廣播級功能。您可以將其用於建立跨網際網路的廣播資產及隨選視訊 (VOD) 交付資產。如需詳細資訊，請參閱[「*AWS Elemental MediaConvert 使用者指南」*](https://docs.aws.amazon.com/mediaconvert/latest/ug/)。 MediaConvert 的 JavaScript API 透過`MediaConvert`用戶端類別公開。如需詳細資訊，請參閱 API 參考中的[類別：MediaConvert](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/)。 **Topics** + [在 MediaConvert 中建立和管理轉碼任務](emc-examples-jobs.md) + [在 MediaConvert 中使用任務範本](emc-examples-templates.md) # 在 MediaConvert 中建立和管理轉碼任務 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 如何在 MediaConvert 中建立轉碼任務。 + 如何取消轉碼任務。 + 如何擷取已完成轉碼任務的 JSON。 + 如何擷取高達 20 個最近建立任務的 JSON 陣列。 ## 案例在此範例中，您使用 Node.js 模組呼叫 MediaConvert 來建立和管理轉碼任務。此程式碼使用以下 MediaConvert 用戶端類別的方法，使用適用於 JavaScript 的 SDK 來執行此操作： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CancelJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CancelJobCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/GetJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/GetJobCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobsCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobsCommand/) ## 先決條件任務若要設定和執行此範例，請先完成這些任務： + 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code/mediaconvert/README.md) 上的指示。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 + 建立和設定 Amazon S3 儲存貯體，為任務輸入檔案和輸出檔案提供儲存空間。如需詳細資訊，請參閱*AWS Elemental MediaConvert 《使用者指南*》中的[建立檔案的儲存](https://docs.aws.amazon.com/mediaconvert/latest/ug/set-up-file-locations.html)體。 + 將輸入影片上傳至您佈建用於輸入儲存的 Amazon S3 儲存貯體。如需支援的輸入視訊轉碼器和容器清單，請參閱*AWS Elemental MediaConvert 《使用者指南*》中的[支援的輸入轉碼器和容器](https://docs.aws.amazon.com/mediaconvert/latest/ug/reference-codecs-containers-input.html)。 + 建立 IAM 角色，讓 MediaConvert 存取您的輸入檔案，以及儲存輸出檔案的 Amazon S3 儲存貯體。如需詳細資訊，請參閱[《使用者指南》中的設定 IAM 許可](https://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html)。 *AWS Elemental MediaConvert * **重要** 此範例使用 ECMAScript6 (ES6)。這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 不過，如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)。 ## 定義簡單的轉碼任務以檔名 `emc_createjob.js` 建立一個 Node.js 模組。請務必如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立 JSON，定義轉碼任務參數。這些參數相當詳細。您可以使用 [AWS Elemental MediaConvert 主控台](https://console.aws.amazon.com/mediaconvert/)來產生 JSON 任務參數，方法是在主控台中選擇您的任務設定，然後選擇**任務區段底部的顯示任務 JSON**。 ****此範例顯示簡單任務的 JSON。 **注意** 將 *JOB\$1QUEUE\$1ARN* 取代為 MediaConvert 任務佇列、將 *IAM\$1ROLE\$1ARN* 取代為 IAM 角色的 Amazon Resource Name (ARN)、將 *OUTPUT\$1BUCKET\$1NAME* 取代為目的地儲存貯體名稱 - 例如 "s3：//OUTPUT\$1BUCKET\$1NAME/"，以及將 *INPUT\$1BUCKET\$1AND\$1FILENAME* 取代為輸入儲存貯體和檔案名稱 - 例如 "s3：/INPUT\$1BUCKET/FILE\$1NAME"。 ``` const params = { Queue: "JOB_QUEUE_ARN", //JOB_QUEUE_ARN UserMetadata: { Customer: "Amazon", }, Role: "IAM_ROLE_ARN", //IAM_ROLE_ARN Settings: { OutputGroups: [ { Name: "File Group", OutputGroupSettings: { Type: "FILE_GROUP_SETTINGS", FileGroupSettings: { Destination: "OUTPUT_BUCKET_NAME", //OUTPUT_BUCKET_NAME, e.g., "s3://BUCKET_NAME/" }, }, Outputs: [ { VideoDescription: { ScalingBehavior: "DEFAULT", TimecodeInsertion: "DISABLED", AntiAlias: "ENABLED", Sharpness: 50, CodecSettings: { Codec: "H_264", H264Settings: { InterlaceMode: "PROGRESSIVE", NumberReferenceFrames: 3, Syntax: "DEFAULT", Softness: 0, GopClosedCadence: 1, GopSize: 90, Slices: 1, GopBReference: "DISABLED", SlowPal: "DISABLED", SpatialAdaptiveQuantization: "ENABLED", TemporalAdaptiveQuantization: "ENABLED", FlickerAdaptiveQuantization: "DISABLED", EntropyEncoding: "CABAC", Bitrate: 5000000, FramerateControl: "SPECIFIED", RateControlMode: "CBR", CodecProfile: "MAIN", Telecine: "NONE", MinIInterval: 0, AdaptiveQuantization: "HIGH", CodecLevel: "AUTO", FieldEncoding: "PAFF", SceneChangeDetect: "ENABLED", QualityTuningLevel: "SINGLE_PASS", FramerateConversionAlgorithm: "DUPLICATE_DROP", UnregisteredSeiTimecode: "DISABLED", GopSizeUnits: "FRAMES", ParControl: "SPECIFIED", NumberBFramesBetweenReferenceFrames: 2, RepeatPps: "DISABLED", FramerateNumerator: 30, FramerateDenominator: 1, ParNumerator: 1, ParDenominator: 1, }, }, AfdSignaling: "NONE", DropFrameTimecode: "ENABLED", RespondToAfd: "NONE", ColorMetadata: "INSERT", }, AudioDescriptions: [ { AudioTypeControl: "FOLLOW_INPUT", CodecSettings: { Codec: "AAC", AacSettings: { AudioDescriptionBroadcasterMix: "NORMAL", RateControlMode: "CBR", CodecProfile: "LC", CodingMode: "CODING_MODE_2_0", RawFormat: "NONE", SampleRate: 48000, Specification: "MPEG4", Bitrate: 64000, }, }, LanguageCodeControl: "FOLLOW_INPUT", AudioSourceName: "Audio Selector 1", }, ], ContainerSettings: { Container: "MP4", Mp4Settings: { CslgAtom: "INCLUDE", FreeSpaceBox: "EXCLUDE", MoovPlacement: "PROGRESSIVE_DOWNLOAD", }, }, NameModifier: "_1", }, ], }, ], AdAvailOffset: 0, Inputs: [ { AudioSelectors: { "Audio Selector 1": { Offset: 0, DefaultSelection: "NOT_DEFAULT", ProgramSelection: 1, SelectorType: "TRACK", Tracks: [1], }, }, VideoSelector: { ColorSpace: "FOLLOW", }, FilterEnable: "AUTO", PsiControl: "USE_PSI", FilterStrength: 0, DeblockFilter: "DISABLED", DenoiseFilter: "DISABLED", TimecodeSource: "EMBEDDED", FileInput: "INPUT_BUCKET_AND_FILENAME", //INPUT_BUCKET_AND_FILENAME, e.g., "s3://BUCKET_NAME/FILE_NAME" }, ], TimecodeConfig: { Source: "EMBEDDED", }, }, }; ``` ## 建立轉碼任務建立任務參數 JSON 之後，請呼叫非同步`run`方法來叫用`MediaConvert`用戶端服務物件，並傳遞參數。回應 `data` 中會傳回所建立任務的 ID。 ``` const run = async () => { try { const data = await emcClient.send(new CreateJobCommand(params)); console.log("Job created!", data); return data; } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node emc_createjob.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_createjob.js)此完整範例程式碼。 ## 取消轉碼任務以檔名 `emc_canceljob.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括下載所需的用戶端和套件。建立包含要取消任務 ID 的 JSON。然後，透過建立叫用`MediaConvert`用戶端服務物件、傳遞參數的承諾來呼叫 `CancelJobCommand`方法。在 promise 回呼中處理回應。 **注意** 將 *JOB\$1ID* 取代為要取消的任務 ID。 ``` // Import required AWS-SDK clients and commands for Node.js import { CancelJobCommand } from "@aws-sdk/client-mediaconvert"; import { emcClient } from "./libs/emcClient.js"; // Set the parameters const params = { Id: "JOB_ID" }; //JOB_ID const run = async () => { try { const data = await emcClient.send(new CancelJobCommand(params)); console.log(`Job ${params.Id} is canceled`); return data; } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node ec2_canceljob.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_canceljob.js)此範例程式碼。 ## 列出最近的轉碼任務以檔名 `emc_listjobs.js` 建立一個 Node.js 模組。請務必如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立參數 JSON，包括指定要以 `ASCENDING`或 `DESCENDING`順序排序清單的值、要檢查之任務佇列的 Amazon Resource Name (ARN)，以及要包含的任務狀態。然後，透過建立叫用`MediaConvert`用戶端服務物件並傳遞參數的承諾來呼叫 `ListJobsCommand`方法。 **注意** 將 *QUEUE\$1ARN* 取代為要檢查之任務佇列的 Amazon Resource Name (ARN)，並將 *STATUS* 取代為佇列的狀態。 ``` // Import required AWS-SDK clients and commands for Node.js import { ListJobsCommand } from "@aws-sdk/client-mediaconvert"; import { emcClient } from "./libs/emcClient.js"; // Set the parameters const params = { MaxResults: 10, Order: "ASCENDING", Queue: "QUEUE_ARN", Status: "SUBMITTED", // e.g., "SUBMITTED" }; const run = async () => { try { const data = await emcClient.send(new ListJobsCommand(params)); console.log("Success. Jobs: ", data.Jobs); } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node emc_listjobs.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_listjobs.js)此範例程式碼。 # 在 MediaConvert 中使用任務範本 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 如何建立 AWS Elemental MediaConvert 任務範本。 + 如何使用任務範本來建立轉譯任務。 + 如何列出所有任務範本。 + 如何刪除任務範本。 ## 案例在 MediaConvert 中建立轉碼任務所需的 JSON 是詳細的，其中包含大量的設定。您可以在您在建立後續任務能用的任務範本中儲存已知良好的設定，來大幅簡化任務的建立作業。在此範例中，您使用 Node.js 模組呼叫 MediaConvert 來建立、使用和管理任務範本。此程式碼使用以下 MediaConvert 用戶端類別的方法，使用適用於 JavaScript 的 SDK 來執行此操作： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobTemplateCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/CreateJobCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/DeleteJobTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/DeleteJobTemplateCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobTemplatesCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-mediaconvert/Class/ListJobTemplatesCommand/) ## 先決條件任務若要設定和執行此範例，請先完成這些任務： + 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code/mediaconvert/README.md) 上的指示。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 + 建立 IAM 角色，讓 MediaConvert 存取您的輸入檔案，以及儲存輸出檔案的 Amazon S3 儲存貯體。如需詳細資訊，請參閱[《使用者指南》中的設定 IAM 許可](https://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html)。 *AWS Elemental MediaConvert * **重要** 這些範例使用 ECMAScript6 (ES6)。這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 不過，如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)。 ## 建立任務範本以檔名 `emc_create_jobtemplate.js` 建立一個 Node.js 模組。請務必如先前所示設定 SDK，包括安裝所需的用戶端和套件。為範本建立指定 JSON 參數。您可以使用來自先前成功任務的多數 JSON 參數，來在範本中指定 `Settings` 值。此範例使用來自 [在 MediaConvert 中建立和管理轉碼任務](emc-examples-jobs.md)的任務設定。透過建立叫用`MediaConvert`用戶端服務物件並傳遞參數的承諾來呼叫 `CreateJobTemplateCommand`方法。 **注意** 將 *JOB\$1QUEUE\$1ARN* 取代為要檢查之任務佇列的 Amazon Resource Name (ARN)，並將 *BUCKET\$1NAME* 取代為目的地 Amazon S3 儲存貯體的名稱，例如 "s3：//BUCKET\$1NAME/"。 ``` // Import required AWS-SDK clients and commands for Node.js import { CreateJobTemplateCommand } from "@aws-sdk/client-mediaconvert"; import { emcClient } from "./libs/emcClient.js"; const params = { Category: "YouTube Jobs", Description: "Final production transcode", Name: "DemoTemplate", Queue: "JOB_QUEUE_ARN", //JOB_QUEUE_ARN Settings: { OutputGroups: [ { Name: "File Group", OutputGroupSettings: { Type: "FILE_GROUP_SETTINGS", FileGroupSettings: { Destination: "BUCKET_NAME", // BUCKET_NAME e.g., "s3://BUCKET_NAME/" }, }, Outputs: [ { VideoDescription: { ScalingBehavior: "DEFAULT", TimecodeInsertion: "DISABLED", AntiAlias: "ENABLED", Sharpness: 50, CodecSettings: { Codec: "H_264", H264Settings: { InterlaceMode: "PROGRESSIVE", NumberReferenceFrames: 3, Syntax: "DEFAULT", Softness: 0, GopClosedCadence: 1, GopSize: 90, Slices: 1, GopBReference: "DISABLED", SlowPal: "DISABLED", SpatialAdaptiveQuantization: "ENABLED", TemporalAdaptiveQuantization: "ENABLED", FlickerAdaptiveQuantization: "DISABLED", EntropyEncoding: "CABAC", Bitrate: 5000000, FramerateControl: "SPECIFIED", RateControlMode: "CBR", CodecProfile: "MAIN", Telecine: "NONE", MinIInterval: 0, AdaptiveQuantization: "HIGH", CodecLevel: "AUTO", FieldEncoding: "PAFF", SceneChangeDetect: "ENABLED", QualityTuningLevel: "SINGLE_PASS", FramerateConversionAlgorithm: "DUPLICATE_DROP", UnregisteredSeiTimecode: "DISABLED", GopSizeUnits: "FRAMES", ParControl: "SPECIFIED", NumberBFramesBetweenReferenceFrames: 2, RepeatPps: "DISABLED", FramerateNumerator: 30, FramerateDenominator: 1, ParNumerator: 1, ParDenominator: 1, }, }, AfdSignaling: "NONE", DropFrameTimecode: "ENABLED", RespondToAfd: "NONE", ColorMetadata: "INSERT", }, AudioDescriptions: [ { AudioTypeControl: "FOLLOW_INPUT", CodecSettings: { Codec: "AAC", AacSettings: { AudioDescriptionBroadcasterMix: "NORMAL", RateControlMode: "CBR", CodecProfile: "LC", CodingMode: "CODING_MODE_2_0", RawFormat: "NONE", SampleRate: 48000, Specification: "MPEG4", Bitrate: 64000, }, }, LanguageCodeControl: "FOLLOW_INPUT", AudioSourceName: "Audio Selector 1", }, ], ContainerSettings: { Container: "MP4", Mp4Settings: { CslgAtom: "INCLUDE", FreeSpaceBox: "EXCLUDE", MoovPlacement: "PROGRESSIVE_DOWNLOAD", }, }, NameModifier: "_1", }, ], }, ], AdAvailOffset: 0, Inputs: [ { AudioSelectors: { "Audio Selector 1": { Offset: 0, DefaultSelection: "NOT_DEFAULT", ProgramSelection: 1, SelectorType: "TRACK", Tracks: [1], }, }, VideoSelector: { ColorSpace: "FOLLOW", }, FilterEnable: "AUTO", PsiControl: "USE_PSI", FilterStrength: 0, DeblockFilter: "DISABLED", DenoiseFilter: "DISABLED", TimecodeSource: "EMBEDDED", }, ], TimecodeConfig: { Source: "EMBEDDED", }, }, }; const run = async () => { try { // Create a promise on a MediaConvert object const data = await emcClient.send(new CreateJobTemplateCommand(params)); console.log("Success!", data); return data; } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node emc_create_jobtemplate.js ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_create_jobtemplate.js)範例程式碼。 ## 從任務範本建立轉碼任務以檔名 `emc_template_createjob.js` 建立一個 Node.js 模組。請務必如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立任務建立參數 JSON，其中包含要用的任務範本名稱，以及專屬於您在建立之任務的要使用 `Settings`。然後，透過建立叫用`MediaConvert`用戶端服務物件、傳遞參數的承諾來呼叫 `CreateJobsCommand`方法。 **注意** 將 *JOB\$1QUEUE\$1ARN* 取代為任務佇列的 Amazon Resource Name (ARN)，將 *KEY\$1PAIR\$1NAME* 取代為 *TEMPLATE\$1NAME* 取代為，將 *ROLE\$1ARN* 取代為角色的 Amazon Resource Name (ARN)，並將 * INPUT\$1BUCKET\$1AND\$1FILENAME* 取代為輸入儲存貯體和檔案名稱 - 例如 "s3：//BUCKET\$1NAME/FILE\$1NAME"。 ``` // Import required AWS-SDK clients and commands for Node.js import { CreateJobCommand } from "@aws-sdk/client-mediaconvert"; import { emcClient } from "./libs/emcClient.js"; const params = { Queue: "QUEUE_ARN", //QUEUE_ARN JobTemplate: "TEMPLATE_NAME", //TEMPLATE_NAME Role: "ROLE_ARN", //ROLE_ARN Settings: { Inputs: [ { AudioSelectors: { "Audio Selector 1": { Offset: 0, DefaultSelection: "NOT_DEFAULT", ProgramSelection: 1, SelectorType: "TRACK", Tracks: [1], }, }, VideoSelector: { ColorSpace: "FOLLOW", }, FilterEnable: "AUTO", PsiControl: "USE_PSI", FilterStrength: 0, DeblockFilter: "DISABLED", DenoiseFilter: "DISABLED", TimecodeSource: "EMBEDDED", FileInput: "INPUT_BUCKET_AND_FILENAME", //INPUT_BUCKET_AND_FILENAME, e.g., "s3://BUCKET_NAME/FILE_NAME" }, ], }, }; const run = async () => { try { const data = await emcClient.send(new CreateJobCommand(params)); console.log("Success! ", data); return data; } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node emc_template_createjob.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_template_createjob.js)此範例程式碼。 ## 列出您的任務範本以檔名 `emc_listtemplates.js` 建立一個 Node.js 模組。請務必如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件，傳遞 `MediaConvert` 用戶端類別的 `listTemplates` 方法的空請求參數。包含值來判斷要列出哪些範本 (`NAME`, `CREATION DATE`, `SYSTEM`)、要列出多少以及這些範本的排序。若要呼叫 `ListTemplatesCommand`方法，請建立叫用 MediaConvert 用戶端服務物件並傳遞參數的承諾。 ``` // Import required AWS-SDK clients and commands for Node.js import { ListJobTemplatesCommand } from "@aws-sdk/client-mediaconvert"; import { emcClient } from "./libs/emcClient.js"; const params = { ListBy: "NAME", MaxResults: 10, Order: "ASCENDING", }; const run = async () => { try { const data = await emcClient.send(new ListJobTemplatesCommand(params)); console.log("Success ", data.JobTemplates); return data; } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node emc_listtemplates.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_template_createjob.js)此範例程式碼。 ## 刪除任務範本以檔名 `emc_deletetemplate.js` 建立一個 Node.js 模組。請務必如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件，為 `MediaConvert` 用戶端類別的 `DeleteJobTemplateCommand` 方法傳遞您要刪除做為參數的任務範本名稱。若要呼叫 `DeleteJobTemplateCommand`方法，請建立叫用 MediaConvert 用戶端服務物件並傳遞參數的承諾。 ``` // Import required AWS-SDK clients and commands for Node.js import { DeleteJobTemplateCommand } from "@aws-sdk/client-mediaconvert"; import { emcClient } from "./libs/emcClient.js"; // Set the parameters const params = { Name: "test" }; //TEMPLATE_NAME const run = async () => { try { const data = await emcClient.send(new DeleteJobTemplateCommand(params)); console.log( "Success, template deleted! Request ID:", data.$metadata.requestId, ); return data; } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node emc_deletetemplate.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/mediaconvert/src/emc_deletetemplate.js)此範例程式碼。 # AWS Lambda 範例 AWS Lambda 是一種無伺服器運算服務，可讓您執行程式碼，而無需佈建或管理伺服器、建立工作負載感知叢集擴展邏輯、維護事件整合，或管理執行時間。的 JavaScript API 透過 [LambdaService](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-lambda/) 用戶端類別 AWS Lambda 公開。以下是示範如何建立 Lambda 函數並將其與適用於 JavaScript 的 AWS SDK v3 搭配使用的範例清單： + [使用 API Gateway 叫用 Lambda](api-gateway-invoking-lambda-example.md) + [建立排程事件以執行 AWS Lambda 函數](scheduled-events-invoking-lambda-example.md) # Amazon Lex 範例 Amazon Lex 是一種 AWS 服務，可使用語音和文字將對話界面建置到應用程式中。 Amazon Lex 的 JavaScript API 透過 [Lex 執行期服務](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-lex-runtime-service/)用戶端類別公開。 + [建置 Amazon Lex 聊天機器人](lex-bot-example.md) # Amazon Polly 範例 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 使用 Amazon Polly 將錄製的音訊上傳至 Amazon S3 ## 案例在此範例中，一系列 Node.js 模組用於使用以下 Amazon S3 用戶端類別的方法，使用 Amazon Polly 自動將錄製的音訊上傳至 Amazon S3： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-polly/Class/StartSpeechSynthesisTaskCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-polly/Class/StartSpeechSynthesisTaskCommand/) ## 先決條件任務若要設定和執行此範例，您必須先完成這些任務： + 依照[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascriptv3/example_code/s3/README.md) 上的指示，設定專案環境以執行節點 JavaScript 範例。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 + 建立 AWS Identity and Access Management (IAM) 未驗證的 Amazon Cognito 使用者角色輪詢：SynthesizeSpeech 許可，以及連接 IAM 角色的 Amazon Cognito 身分集區。以下[使用建立 AWS 資源 CloudFormation](#polly-example-synthesize-to-s3-create-resources)章節說明如何建立這些資源。 **注意** 此範例使用 Amazon Cognito，但如果您沒有使用 Amazon Cognito，您的 AWS 使用者必須擁有下列 IAM 許可政策 **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "mobileanalytics:PutEvents", "cognito-sync:*" ], "Resource": "*", "Effect": "Allow" }, { "Action": "polly:SynthesizeSpeech", "Resource": "*", "Effect": "Allow" } ] } ``` ## 使用建立 AWS 資源 CloudFormation CloudFormation 可讓您以可預測且重複的方式建立和佈建 AWS 基礎設施部署。如需的詳細資訊 CloudFormation，請參閱[AWS CloudFormation 《使用者指南》](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/)。若要建立 CloudFormation 堆疊： 1. 在 [AWS CLI 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)中安裝和設定 AWS CLI 下列指示。 1. 在專案資料夾的`setup.yaml`根目錄中建立名為的檔案，並將 [ GitHub 上的此處](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/polly/general-examples/src/setup.yaml)內容複製到其中。 **注意** CloudFormation 範本是使用 [ GitHub 上此處](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/resources/cdk/javascript_example_code_polly_aws_service/)提供的 AWS CDK 產生。如需的詳細資訊 AWS CDK，請參閱 [AWS Cloud Development Kit (AWS CDK) 開發人員指南](https://docs.aws.amazon.com/cdk/latest/guide/)。 1. 從命令列執行下列命令，將 *STACK\$1NAME* 取代為堆疊的唯一名稱。 **重要** 堆疊名稱在 AWS 區域和 AWS 帳戶中必須是唯一的。您最多可以指定 128 個字元，且允許使用數字和連字號。 ``` aws cloudformation create-stack --stack-name STACK_NAME --template-body file://setup.yaml --capabilities CAPABILITY_IAM ``` 如需`create-stack`命令參數的詳細資訊，請參閱 [AWS CLI 命令參考指南](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-stack.html)和 [CloudFormation 使用者指南](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-cli-creating-stack.html)。 1. 導覽至 CloudFormation 管理主控台，選擇 **Stacks**，選擇堆疊名稱，然後選擇**資源**索引標籤以檢視建立的資源清單。 ![\[CloudFormation 資源\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/cfn_polly.png) ## 使用 Amazon Polly 將錄製的音訊上傳至 Amazon S3 以檔名 `polly_synthesize_to_s3.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。在程式碼中，輸入 *REGION* 和 *BUCKET\$1NAME*。若要存取 Amazon Polly，請建立`Polly`用戶端服務物件。`IdentityPoolId` 將 *"IDENTITY\$1POOL\$1ID"* 取代為您為此範例建立的 Amazon Cognito 身分集區**範例頁面**中的。這也會傳遞給每個用戶端物件。呼叫 Amazon Polly 用戶端服務物件的 `StartSpeechSynthesisCommand`方法合成語音訊息，並將其上傳至 Amazon S3 儲存貯體。 ``` import { StartSpeechSynthesisTaskCommand } from "@aws-sdk/client-polly"; import { pollyClient } from "./libs/pollyClient.js"; // Create the parameters const params = { OutputFormat: "mp3", OutputS3BucketName: "videoanalyzerbucket", Text: "Hello David, How are you?", TextType: "text", VoiceId: "Joanna", SampleRate: "22050", }; const run = async () => { try { await pollyClient.send(new StartSpeechSynthesisTaskCommand(params)); console.log(`Success, audio file added to ${params.OutputS3BucketName}`); } catch (err) { console.log("Error putting object", err); } }; run(); ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascriptv3/example_code/polly/general-examples/src/polly_synthesize_to_s3.js)找到這個範本程式碼。 # Amazon Redshift 範例 Amazon Redshift 是一種在雲端中完全受管的 PB 級資料倉儲服務。Amazon Redshift 資料倉儲是稱為節點**的運算資源的集合，組織成稱為叢集**的群組。每個叢集皆執行 Amazon Redshift 引擎並包含一或多個資料庫。 ![\[JavaScript 環境、軟體開發套件和 Amazon Redshift 之間的關係\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/code-samples-redshift.png) Amazon Redshift 的 JavaScript API 透過 [Amazon Redshift](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/Redshift/) 用戶端類別公開。 **Topics** + [Amazon Redshift 範例](redshift-examples-section.md) # Amazon Redshift 範例在此範例中，一系列 Node.js 模組用於建立、修改、描述的參數，然後使用下列 `Redshift`用戶端類別方法刪除 Amazon Redshift 叢集： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/CreateClusterCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/CreateClusterCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/ModifyClusterCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/ModifyClusterCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DescribeClustersCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DescribeClustersCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DeleteClusterCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DeleteClusterCommand/) 如需 Amazon Redshift 使用者的詳細資訊，請參閱 [Amazon Redshift 入門指南](https://docs.aws.amazon.com/redshift/latest/gsg/getting-started.html)。 ## 先決條件任務若要設定和執行此範例，您必須先完成這些任務： + 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/redshift/README.md) 上的指示。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 **重要** 這些範例示範如何使用 ECMAScript6 (ES6) 匯入/匯出用戶端服務物件和命令。這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md) ## 建立 Amazon Redshift 叢集此範例示範如何使用建立 Amazon Redshift 叢集適用於 JavaScript 的 AWS SDK。如需詳細資訊，請參閱 [CreateCluster](https://docs.aws.amazon.com/redshift/latest/APIReference/API_CreateCluster)。 **重要** *您即將建立的叢集是即時的（而不是在沙盒中執行）。您需要支付叢集的標準 Amazon Redshift 使用費，直到刪除叢集為止。如果您在建立叢集時以相同的坐姿刪除叢集，則總費用最少。 * 建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`redshiftClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Redshift 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { RedshiftClient } from "@aws-sdk/client-redshift"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Redshift service object. const redshiftClient = new RedshiftClient({ region: REGION }); export { redshiftClient }; ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js)範例程式碼。以檔名 `redshift-create-cluster.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。建立參數物件，指定要佈建的節點類型，以及在叢集中自動建立的資料庫執行個體主登入憑證，最後是叢集類型。 **注意** 將 *CLUSTER\$1NAME* 取代為叢集的名稱。對於 *NODE\$1TYPE*，指定要佈建的節點類型，例如 'dc2.large'。*MASTER\$1USERNAME* 和 *MASTER\$1USER\$1PASSWORD* 是叢集中資料庫執行個體主要使用者的登入憑證。針對 *CLUSTER\$1TYPE*，輸入叢集的類型。如果您指定 `single-node`，則不需要 `NumberOfNodes` 參數。其餘參數為選用。 ``` // Import required AWS SDK clients and commands for Node.js import { CreateClusterCommand } from "@aws-sdk/client-redshift"; import { redshiftClient } from "./libs/redshiftClient.js"; const params = { ClusterIdentifier: "CLUSTER_NAME", // Required NodeType: "NODE_TYPE", //Required MasterUsername: "MASTER_USER_NAME", // Required - must be lowercase MasterUserPassword: "MASTER_USER_PASSWORD", // Required - must contain at least one uppercase letter, and one number ClusterType: "CLUSTER_TYPE", // Required IAMRoleARN: "IAM_ROLE_ARN", // Optional - the ARN of an IAM role with permissions your cluster needs to access other AWS services on your behalf, such as Amazon S3. ClusterSubnetGroupName: "CLUSTER_SUBNET_GROUPNAME", //Optional - the name of a cluster subnet group to be associated with this cluster. Defaults to 'default' if not specified. DBName: "DATABASE_NAME", // Optional - defaults to 'dev' if not specified Port: "PORT_NUMBER", // Optional - defaults to '5439' if not specified }; const run = async () => { try { const data = await redshiftClient.send(new CreateClusterCommand(params)); console.log( `Cluster ${data.Cluster.ClusterIdentifier} successfully created`, ); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node redshift-create-cluster.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-create-cluster.js)找到這個範本程式碼。 ## 修改 Amazon Redshift 叢集此範例說明如何使用修改 Amazon Redshift 叢集的主要使用者密碼適用於 JavaScript 的 AWS SDK。如需您可以修改哪些其他設定的詳細資訊，請參閱 [ModifyCluster](https://docs.aws.amazon.com/redshift/latest/APIReference/API_ModifyCluster.html)。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`redshiftClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Redshift 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { RedshiftClient } from "@aws-sdk/client-redshift"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Redshift service object. const redshiftClient = new RedshiftClient({ region: REGION }); export { redshiftClient }; ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js)範例程式碼。以檔名 `redshift-modify-cluster.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。指定 AWS 區域、您要修改的叢集名稱，以及新的主要使用者密碼。 **注意** 將 *CLUSTER\$1NAME* 取代為叢集的名稱，並將 *MASTER\$1USER\$1PASSWORD* 取代為新的主要使用者密碼。 ``` // Import required AWS SDK clients and commands for Node.js import { ModifyClusterCommand } from "@aws-sdk/client-redshift"; import { redshiftClient } from "./libs/redshiftClient.js"; // Set the parameters const params = { ClusterIdentifier: "CLUSTER_NAME", MasterUserPassword: "NEW_MASTER_USER_PASSWORD", }; const run = async () => { try { const data = await redshiftClient.send(new ModifyClusterCommand(params)); console.log("Success was modified.", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node redshift-modify-cluster.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-modify-cluster.js)找到這個範本程式碼。 ## 檢視 Amazon Redshift 叢集的詳細資訊此範例說明如何使用檢視 Amazon Redshift 叢集的詳細資訊適用於 JavaScript 的 AWS SDK。如需選用的詳細資訊，請參閱 [DescribeClusters](https://docs.aws.amazon.com/redshift/latest/APIReference/API_DescribeClusters.html)。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`redshiftClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Redshift 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { RedshiftClient } from "@aws-sdk/client-redshift"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Redshift service object. const redshiftClient = new RedshiftClient({ region: REGION }); export { redshiftClient }; ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js)範例程式碼。以檔名 `redshift-describe-clusters.js` 建立一個 Node.js 模組。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。指定 AWS 區域、您要修改的叢集名稱，以及新的主要使用者密碼。 **注意** 將 *CLUSTER\$1NAME* 取代為叢集的名稱。 ``` // Import required AWS SDK clients and commands for Node.js import { DescribeClustersCommand } from "@aws-sdk/client-redshift"; import { redshiftClient } from "./libs/redshiftClient.js"; const params = { ClusterIdentifier: "CLUSTER_NAME", }; const run = async () => { try { const data = await redshiftClient.send(new DescribeClustersCommand(params)); console.log("Success", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node redshift-describe-clusters.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-describe-clusters.js)找到這個範本程式碼。 ## 刪除 Amazon Redshift 叢集此範例說明如何使用檢視 Amazon Redshift 叢集的詳細資訊適用於 JavaScript 的 AWS SDK。如需您可以修改哪些其他設定的詳細資訊，請參閱 [DeleteCluster](https://docs.aws.amazon.com/redshift/latest/APIReference/API_DeleteCluster.html)。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`redshiftClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon Redshift 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { RedshiftClient } from "@aws-sdk/client-redshift"; // Set the AWS Region. const REGION = "REGION"; //e.g. "us-east-1" // Create Redshift service object. const redshiftClient = new RedshiftClient({ region: REGION }); export { redshiftClient }; ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js)範例程式碼。使用名為的檔案建立 Node.js 模組`redshift-delete-clusters.js`。請務必如先前所示設定軟體開發套件，包括安裝所需的用戶端和套件。指定 AWS 區域、您要修改的叢集名稱，以及新的主要使用者密碼。指定是否要在刪除之前儲存叢集的最終快照，如果是，則指定快照的 ID。 **注意** 將 *CLUSTER\$1NAME* 取代為叢集的名稱。對於 *SkipFinalClusterSnapshot*，指定是否在刪除叢集之前建立叢集的最終快照。如果您指定 'false'，請在 *CLUSTER\$1SNAPSHOT\$1ID* 中指定最終叢集快照的 ID。您可以按一下**叢集**儀表板上叢集**快照**欄中的連結，然後向下捲動至**快照**窗格，以取得此 ID。請注意，桿`rs:`不屬於快照 ID。 ``` // Import required AWS SDK clients and commands for Node.js import { DeleteClusterCommand } from "@aws-sdk/client-redshift"; import { redshiftClient } from "./libs/redshiftClient.js"; const params = { ClusterIdentifier: "CLUSTER_NAME", SkipFinalClusterSnapshot: false, FinalClusterSnapshotIdentifier: "CLUSTER_SNAPSHOT_ID", }; const run = async () => { try { const data = await redshiftClient.send(new DeleteClusterCommand(params)); console.log("Success, cluster deleted. ", data); return data; // For unit tests. } catch (err) { console.log("Error", err); } }; run(); ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node redshift-delete-cluster.js ``` 您可以在 [GitHub 上](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-delete-cluster.js)找到這個範本程式碼。 # Amazon Simple Email Service 範例 Amazon Simple Email Service (Amazon SES) 是一種雲端電子郵件傳送服務，旨在協助數位行銷人員和應用程式開發人員傳送行銷、通知和交易電子郵件。這是一個可靠且經濟實惠的服務，適合透過電子郵件與客戶保持聯繫的所有規模公司使用。 ![\[JavaScript 環境、軟體開發套件和 Amazon SES 之間的關係\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/code-samples-ses.png) Amazon SES 的 JavaScript API 透過`SES`用戶端類別公開。如需使用 Amazon SES 用戶端類別的詳細資訊，請參閱 API 參考中的[類別：SES](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SES/)。 **Topics** + [管理 Amazon SES 身分](ses-examples-managing-identities.md) + [在 Amazon SES 中使用電子郵件範本](ses-examples-creating-template.md) + [使用 Amazon SES 傳送電子郵件](ses-examples-sending-email.md) # 管理 Amazon SES 身分 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 如何驗證與 Amazon SES 搭配使用的電子郵件地址和網域。 + 如何將 AWS Identity and Access Management (IAM) 政策指派給您的 Amazon SES 身分。 + 如何列出您 AWS 帳戶的所有 Amazon SES 身分。 + 如何刪除與 Amazon SES 搭配使用的身分。 Amazon SES *身分*是 Amazon SES 用來傳送電子郵件的電子郵件地址或網域。Amazon SES 要求您驗證電子郵件身分，確認您擁有這些身分，並防止其他人使用這些身分。如需如何在 Amazon SES 中驗證電子郵件地址和網域的詳細資訊，請參閱《Amazon Simple Email Service [開發人員指南》中的在 Amazon SES 中驗證電子郵件地址和網域](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html)。如需在 Amazon SES 中傳送授權的資訊，請參閱 [Amazon SES 傳送授權概觀](Amazon Simple Email Service Developer Guidesending-authorization-overview.html)。 ## 案例在此範例中，您使用一系列 Node.js 模組來驗證和管理 Amazon SES 身分。Node.js 模組使用以下`SES`用戶端類別的方法，使用適用於 JavaScript 的 SDK 來驗證電子郵件地址和網域： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/ListIdentitiesCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/ListIdentitiesCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/DeleteIdentityCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/DeleteIdentityCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/VerifyEmailIdentityCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/VerifyEmailIdentityCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/VerifyDomainIdentityCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/VerifyDomainIdentityCommand/) ## 先決條件任務若要設定和執行此範例，您必須先完成這些任務： + 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/ses/README.md) 上的指示。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 **重要** 這些範例示範如何使用 ECMAScript6 (ES6) 匯入/匯出用戶端服務物件和命令。這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)。 ## 列出您的身分在此範例中，使用 Node.js 模組列出要與 Amazon SES 搭配使用的電子郵件地址和網域。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_listidentities.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件，以傳遞 `SES` 用戶端類別的 `ListIdentitiesCommand` 方法之 `IdentityType` 和其他參數。若要呼叫 `ListIdentitiesCommand`方法，請叫用 Amazon SES 服務物件，傳遞參數物件。 `data` 傳回的包含 `IdentityType` 參數指定的網域身分陣列。 **注意** 將 *IdentityType* 取代為身分類型，可以是 "EmailAddress" 或 "Domain"。 ``` import { ListIdentitiesCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const createListIdentitiesCommand = () => new ListIdentitiesCommand({ IdentityType: "EmailAddress", MaxItems: 10 }); const run = async () => { const listIdentitiesCommand = createListIdentitiesCommand(); try { return await sesClient.send(listIdentitiesCommand); } catch (err) { console.log("Failed to list identities.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node ses_listidentities.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_listidentities.js)此範例程式碼。 ## 驗證電子郵件地址身分在此範例中，使用 Node.js 模組來驗證要與 Amazon SES 搭配使用的電子郵件寄件者。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_verifyemailidentity.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括下載所需的用戶端和套件。建立物件以傳遞 `SES` 用戶端類別的 `VerifyEmailIdentityCommand` 方法之 `EmailAddress` 參數。若要呼叫 `VerifyEmailIdentityCommand`方法，請叫用 Amazon SES 用戶端服務物件，傳遞參數。 **注意** 將 *EMAIL\$1ADDRESS* 取代為電子郵件地址，例如 name@example.com。 ``` // Import required AWS SDK clients and commands for Node.js import { VerifyEmailIdentityCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const EMAIL_ADDRESS = "name@example.com"; const createVerifyEmailIdentityCommand = (emailAddress) => { return new VerifyEmailIdentityCommand({ EmailAddress: emailAddress }); }; const run = async () => { const verifyEmailIdentityCommand = createVerifyEmailIdentityCommand(EMAIL_ADDRESS); try { return await sesClient.send(verifyEmailIdentityCommand); } catch (err) { console.log("Failed to verify email identity.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。網域會新增至要驗證的 Amazon SES。 ``` node ses_verifyemailidentity.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_verifyemailidentity.js)此範例程式碼。 ## 驗證網域身分在此範例中，使用 Node.js 模組來驗證要與 Amazon SES 搭配使用的電子郵件網域。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_verifydomainidentity.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件以傳遞 `SES` 用戶端類別的 `VerifyDomainIdentityCommand` 方法之 `Domain` 參數。若要呼叫 `VerifyDomainIdentityCommand`方法，請叫用 Amazon SES 用戶端服務物件，傳遞參數物件。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 以網域名稱取代 *DOMAIN\$1NAME*。 ``` import { VerifyDomainIdentityCommand } from "@aws-sdk/client-ses"; import { getUniqueName, postfix, } from "@aws-doc-sdk-examples/lib/utils/util-string.js"; import { sesClient } from "./libs/sesClient.js"; /** * You must have access to the domain's DNS settings to complete the * domain verification process. */ const DOMAIN_NAME = postfix(getUniqueName("Domain"), ".example.com"); const createVerifyDomainIdentityCommand = () => { return new VerifyDomainIdentityCommand({ Domain: DOMAIN_NAME }); }; const run = async () => { const VerifyDomainIdentityCommand = createVerifyDomainIdentityCommand(); try { return await sesClient.send(VerifyDomainIdentityCommand); } catch (err) { console.log("Failed to verify domain.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。網域會新增至要驗證的 Amazon SES。 ``` node ses_verifydomainidentity.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_verifydomainidentity.js)此範例程式碼。 ## 刪除身分在此範例中，使用 Node.js 模組來刪除與 Amazon SES 搭配使用的電子郵件地址或網域。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)範例程式碼。以檔名 `ses_deleteidentity.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件以傳遞 `SES` 用戶端類別的 `DeleteIdentityCommand` 方法之 `Identity` 參數。若要呼叫 `DeleteIdentityCommand`方法，請建立 `request`以叫用 Amazon SES 用戶端服務物件，並傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *IDENTITY\$1EMAIL* 取代為要刪除之身分的電子郵件。 ``` import { DeleteIdentityCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const IDENTITY_EMAIL = "fake@example.com"; const createDeleteIdentityCommand = (identityName) => { return new DeleteIdentityCommand({ Identity: identityName, }); }; const run = async () => { const deleteIdentityCommand = createDeleteIdentityCommand(IDENTITY_EMAIL); try { return await sesClient.send(deleteIdentityCommand); } catch (err) { console.log("Failed to delete identity.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。 ``` node ses_deleteidentity.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_deleteidentity.js)此範例程式碼。 # 在 Amazon SES 中使用電子郵件範本 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 如何取得所有電子郵件範本的清單。 + 如何擷取和更新電子郵件範本。 + 如何建立和刪除電子郵件範本。 Amazon SES 可讓您使用電子郵件範本傳送個人化電子郵件訊息。如需如何在 Amazon SES 中建立和使用電子郵件範本的詳細資訊，請參閱《Amazon Simple Email Service 開發人員指南》中的[使用 Amazon SES API 傳送個人化](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-personalized-email-api.html)電子郵件。 ## 案例在此範例中，您會使用一系列的 Node.js 模組以使用電子郵件範本。Node.js 模組使用適用於 JavaScript 的 SDK，使用以下`SES`用戶端類別的方法建立和使用電子郵件範本： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/ListTemplatesCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/ListTemplatesCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/CreateTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/CreateTemplateCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/GetTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/GetTemplateCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/DeleteTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/DeleteTemplateCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/UpdateTemplateCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/UpdateTemplateCommand/) ## 先決條件任務若要設定和執行此範例，您必須先完成這些任務： + 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/ses/README.md) 上的指示。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 **重要** 這些範例示範如何使用 ECMAScript6 (ES6) 匯入/匯出用戶端服務物件和命令。這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)。 ## 列出您的電子郵件範本在此範例中，使用 Node.js 模組建立與 Amazon SES 搭配使用的電子郵件範本。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製下面的程式碼並將其貼入其中，這會建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_listtemplates.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件以傳遞 `SES` 用戶端類別的 `ListTemplatesCommand` 方法之參數。若要呼叫 `ListTemplatesCommand`方法，請叫用 Amazon SES 用戶端服務物件，並傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 ``` import { ListTemplatesCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const createListTemplatesCommand = (maxItems) => new ListTemplatesCommand({ MaxItems: maxItems }); const run = async () => { const listTemplatesCommand = createListTemplatesCommand(10); try { return await sesClient.send(listTemplatesCommand); } catch (err) { console.log("Failed to list templates.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。Amazon SES 會傳回範本清單。 ``` node ses_listtemplates.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_listtemplates.js)此範例程式碼。 ## 取得電子郵件範本在此範例中，使用 Node.js 模組取得要與 Amazon SES 搭配使用的電子郵件範本。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製並貼上以下程式碼，以建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_gettemplate.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件以傳遞 `SES` 用戶端類別的 `GetTemplateCommand` 方法之 `TemplateName` 參數。若要呼叫 `GetTemplateCommand`方法，請叫用 Amazon SES 用戶端服務物件，傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *TEMPLATE\$1NAME* 取代為要傳回的範本名稱。 ``` import { GetTemplateCommand } from "@aws-sdk/client-ses"; import { getUniqueName } from "@aws-doc-sdk-examples/lib/utils/util-string.js"; import { sesClient } from "./libs/sesClient.js"; const TEMPLATE_NAME = getUniqueName("TemplateName"); const createGetTemplateCommand = (templateName) => new GetTemplateCommand({ TemplateName: templateName }); const run = async () => { const getTemplateCommand = createGetTemplateCommand(TEMPLATE_NAME); try { return await sesClient.send(getTemplateCommand); } catch (caught) { if (caught instanceof Error && caught.name === "MessageRejected") { /** @type { import('@aws-sdk/client-ses').MessageRejected} */ const messageRejectedError = caught; return messageRejectedError; } throw caught; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。Amazon SES 會傳回範本詳細資訊。 ``` node ses_gettemplate.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_gettemplate.js)此範例程式碼。 ## 建立電子郵件範本在此範例中，使用 Node.js 模組建立與 Amazon SES 搭配使用的電子郵件範本。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製並貼上以下程式碼，以建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_createtemplate.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件以傳遞 `SES` 用戶端類別的 `CreateTemplateCommand` 方法 (包括 `TemplateName`、`HtmlPart`、`SubjectPart` 和 `TextPart`) 之參數。若要呼叫 `CreateTemplateCommand`方法，請叫用 Amazon SES 用戶端服務物件，並傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *TEMPLATE\$1NAME* 取代為新範本的名稱、將 *HtmlPart* 取代為 HTML 標記的電子郵件內容，並將 *SubjectPart* 取代為電子郵件的主旨。 ``` import { CreateTemplateCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; import { getUniqueName } from "@aws-doc-sdk-examples/lib/utils/util-string.js"; const TEMPLATE_NAME = getUniqueName("TestTemplateName"); const createCreateTemplateCommand = () => { return new CreateTemplateCommand({ /** * The template feature in Amazon SES is based on the Handlebars template system. */ Template: { /** * The name of an existing template in Amazon SES. */ TemplateName: TEMPLATE_NAME, HtmlPart: `

Hello, {{contact.firstName}}!

Did you know Amazon has a mascot named Peccy?

`, SubjectPart: "Amazon Tip", }, }); }; const run = async () => { const createTemplateCommand = createCreateTemplateCommand(); try { return await sesClient.send(createTemplateCommand); } catch (err) { console.log("Failed to create template.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。範本會新增至 Amazon SES。 ``` node ses_createtemplate.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_createtemplate.js)此範例程式碼。 ## 更新電子郵件範本在此範例中，使用 Node.js 模組建立與 Amazon SES 搭配使用的電子郵件範本。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製並貼上以下程式碼，以建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)範例程式碼。以檔名 `ses_updatetemplate.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立一個物件，並搭配需要的 `TemplateName` 參數 (傳遞至 `SES` 用戶端類別的 `UpdateTemplateCommand` 方法之參數)，以傳遞您要在範本中更新的 `Template` 參數值。若要呼叫 `UpdateTemplateCommand`方法，請叫用 Amazon SES 服務物件，並傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *TEMPLATE\$1NAME* 取代為範本的名稱，並將 *HTML\$1PART* 取代為電子郵件的 HTML 標記內容。 ``` import { UpdateTemplateCommand } from "@aws-sdk/client-ses"; import { getUniqueName } from "@aws-doc-sdk-examples/lib/utils/util-string.js"; import { sesClient } from "./libs/sesClient.js"; const TEMPLATE_NAME = getUniqueName("TemplateName"); const HTML_PART = "

Hello, World!

"; const createUpdateTemplateCommand = () => { return new UpdateTemplateCommand({ Template: { TemplateName: TEMPLATE_NAME, HtmlPart: HTML_PART, SubjectPart: "Example", TextPart: "Updated template text.", }, }); }; const run = async () => { const updateTemplateCommand = createUpdateTemplateCommand(); try { return await sesClient.send(updateTemplateCommand); } catch (err) { console.log("Failed to update template.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。Amazon SES 會傳回範本詳細資訊。 ``` node ses_updatetemplate.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_updatetemplate.js)此範例程式碼。 ## 刪除電子郵件範本在此範例中，使用 Node.js 模組建立與 Amazon SES 搭配使用的電子郵件範本。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製並貼上以下程式碼，以建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_deletetemplate.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件以傳遞需要的 `TemplateName` 參數至 `SES` 用戶端類別的 `DeleteTemplateCommand` 方法。若要呼叫 `DeleteTemplateCommand`方法，請叫用 Amazon SES 服務物件，傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *TEMPLATE\$1NAME* 取代為要刪除的範本名稱。 ``` import { DeleteTemplateCommand } from "@aws-sdk/client-ses"; import { getUniqueName } from "@aws-doc-sdk-examples/lib/utils/util-string.js"; import { sesClient } from "./libs/sesClient.js"; const TEMPLATE_NAME = getUniqueName("TemplateName"); const createDeleteTemplateCommand = (templateName) => new DeleteTemplateCommand({ TemplateName: templateName }); const run = async () => { const deleteTemplateCommand = createDeleteTemplateCommand(TEMPLATE_NAME); try { return await sesClient.send(deleteTemplateCommand); } catch (err) { console.log("Failed to delete template.", err); return err; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。Amazon SES 會傳回範本詳細資訊。 ``` node ses_deletetemplate.js ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_deletetemplate.js)此範例程式碼。 # 使用 Amazon SES 傳送電子郵件 ![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/zh_tw/sdk-for-javascript/v3/developer-guide/images/nodeicon.png) **這個 Node.js 程式碼範例會說明：** + 傳送文字或 HTML 電子郵件。 + 根據電子郵件範本傳送電子郵件。 + 根據電子郵件範本傳送大量電子郵件。 Amazon SES API 為您提供兩種不同的方法來傳送電子郵件，具體取決於您希望對電子郵件訊息合成的控制程度：格式化和原始。如需詳細資訊，請參閱[使用 Amazon SES API 傳送格式化的電子郵件](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-formatted.html)和[使用 Amazon SES API 傳送原始電子郵件](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-raw.html)。 ## 案例在此範例中，您會使用一系列的 Node.js 模組，以多種不同方式傳送電子郵件。Node.js 模組使用適用於 JavaScript 的 SDK，使用以下`SES`用戶端類別的方法建立和使用電子郵件範本： + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SendEmailCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SendEmailCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SendTemplatedEmailCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SendTemplatedEmailCommand/) + [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SendBulkTemplatedEmailCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-ses/Class/SendBulkTemplatedEmailCommand/) ## 先決條件任務若要設定和執行此範例，您必須先完成這些任務： + 設定專案環境以執行這些 Node TypeScript 範例，並安裝必要的適用於 JavaScript 的 AWS SDK 和第三方模組。遵循[ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/ses/README.md) 上的指示。 + 透過使用者登入資料建立共用組態檔。如需提供共用登入資料檔案的詳細資訊，請參閱 *AWS SDKs * [和工具參考指南中的共用組態和登入資料檔案](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html)。 **重要** 這些範例示範如何使用 ECMAScript6 (ES6) 匯入/匯出用戶端服務物件和命令。這需要 Node.js 13.x 版或更新版本。若要下載並安裝最新版本的 Node.js，請參閱 [Node.js 下載。](https://nodejs.org/en/download) 如果您偏好使用 CommonJS 語法，請參閱 [JavaScript ES6/CommonJS 語法](sdk-example-javascript-syntax.md)。 ## 電子郵件訊息傳送要求 Amazon SES 會撰寫電子郵件訊息，並立即將訊息排入佇列以供傳送。若要使用 `SendEmailCommand` 方法傳送電子郵件，您的訊息必須符合下列需求： + 您必須從已驗證的電子郵件地址或網域傳送訊息。如果您要使用非驗證的地址或網域來傳送電子郵件，則該操作會導致 `"Email address not verified"` 錯誤。 + 如果您的帳戶仍在 Amazon SES 沙盒中，您只能傳送至驗證的地址或網域，或傳送至與 Amazon SES 信箱模擬器關聯的電子郵件地址。如需詳細資訊，請參閱《Amazon Simple Email Service 開發人員指南[》中的驗證電子郵件地址和網域](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-addresses-and-domains.html)。 + 訊息的總大小 (包括附件) 必須小於 10 MB。 + 該訊息至少必須含有一個收件人電子郵件地址。收件人地址可為 To (收件人)：地址、CC (副本)：地址或 BCC (密件副本)：地址。如果收件人電子郵件地址無效（即不是的格式`UserName@[SubDomain.]Domain.TopLevelDomain`)，即使訊息包含其他有效的收件人，也會拒絕整個訊息。 + 訊息不能包含跨收件人：、CC：和 BCC：欄位的 50 個以上的收件人。若您需要傳送電子郵件訊息給更多的收件人，則您必須將收件人清單分成 50 人或更少人的群組，然後再多次呼叫 `sendEmail` 方法以傳送訊息至個別群組。 ## 傳送電子郵件在此範例中，使用 Node.js 模組以搭配 Amazon SES 傳送電子郵件。建立`libs`目錄，並建立檔案名稱為的 Node.js 模組`sesClient.js`。複製並貼上以下程式碼，以建立 Amazon SES 用戶端物件。將 *REGION* 取代為您的 AWS 區域。 ``` import { SESClient } from "@aws-sdk/client-ses"; // Set the AWS Region. const REGION = "us-east-1"; // Credentials are automatically resolved using the AWS SDK credential provider chain. // For more information, see https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html // Create SES service object. const sesClient = new SESClient({ region: REGION }); export { sesClient }; ``` 您可以在 [ GitHub 上找到](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/libs/sesClient.js)此範例程式碼。以檔名 `ses_sendemail.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立物件，以將定義要傳送之電子郵件的參數值傳遞至`SES`用戶端類別的 `SendEmailCommand`方法，包括傳送者和接收者地址、主旨和電子郵件內文。若要呼叫 `SendEmailCommand`方法，請叫用 Amazon SES 服務物件，傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *toAddress* 取代為傳送電子郵件的地址，並將 *fromAddress* 取代為傳送電子郵件的地址。 ``` import { SendEmailCommand } from "@aws-sdk/client-ses"; import { sesClient } from "./libs/sesClient.js"; const createSendEmailCommand = (toAddress, fromAddress) => { return new SendEmailCommand({ Destination: { /* required */ CcAddresses: [ /* more items */ ], ToAddresses: [ toAddress, /* more To-email addresses */ ], }, Message: { /* required */ Body: { /* required */ Html: { Charset: "UTF-8", Data: "HTML_FORMAT_BODY", }, Text: { Charset: "UTF-8", Data: "TEXT_FORMAT_BODY", }, }, Subject: { Charset: "UTF-8", Data: "EMAIL_SUBJECT", }, }, Source: fromAddress, ReplyToAddresses: [ /* more items */ ], }); }; const run = async () => { const sendEmailCommand = createSendEmailCommand( "recipient@example.com", "sender@example.com", ); try { return await sesClient.send(sendEmailCommand); } catch (caught) { if (caught instanceof Error && caught.name === "MessageRejected") { /** @type { import('@aws-sdk/client-ses').MessageRejected} */ const messageRejectedError = caught; return messageRejectedError; } throw caught; } }; ``` 若要執行範例，請在命令提示中輸入以下內容。電子郵件會排入佇列以供 Amazon SES 傳送。 ``` node ses_sendemail.js ``` 您可以在 [ GitHub 上找到此](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/ses/src/ses_sendemail.js)範例程式碼。 ## 使用範本傳送電子郵件在此範例中，使用 Node.js 模組以搭配 Amazon SES 傳送電子郵件。以檔名 `ses_sendtemplatedemail.js` 建立一個 Node.js 模組。如先前所示設定 SDK，包括安裝所需的用戶端和套件。建立一個物件以傳遞定義欲傳送電子郵件的參數值，包括寄件者和接收者地址、主旨、電子郵件本文 (純文字和 HTML 格式)，至 `SES` 用戶端類別的 `SendTemplatedEmailCommand` 方法。若要呼叫 `SendTemplatedEmailCommand`方法，請叫用 Amazon SES 用戶端服務物件，並傳遞參數。 **注意** 此範例會匯入並使用所需的 AWS Service V3 套件用戶端、V3 命令，並以非同步/等待模式使用 `send`方法。您可以使用 V2 命令來建立此範例，方法是進行一些次要變更。如需詳細資訊，請參閱[使用 v3 命令](migrating.md#using_v3_commands)。 **注意** 將 *REGION* 取代為您的 AWS 區域，將 *USER* 取代為要傳送電子郵件的名稱和電子郵件地址，將 *VERIFIED\$1EMAIL* 取代為傳送電子郵件的地址，將 *TEMPLATE\$1NAME* 取代為範本的名稱。 ``` import { SendTemplatedEmailCommand } from "@aws-sdk/client-ses"; import { getUniqueName, postfix, } from "@aws-doc-sdk-examples/lib/utils/util-string.js"; import { sesClient } from "./libs/sesClient.js"; /** * Replace this with the name of an existing template. */ const TEMPLATE_NAME = getUniqueName("ReminderTemplate"); /** * Replace these with existing verified emails. */ const VERIFIED_EMAIL = postfix(getUniqueName("Bilbo"), "@example.com"); const USER = { firstName: "Bilbo", emailAddress: VERIFIED_EMAIL }; /** * * @param { { emailAddress: string, firstName: string } } user * @param { string } templateName - The name of an existing template in Amazon SES. * @returns { SendTemplatedEmailCommand } */ const createReminderEmailCommand = (user, templateName) => { return new SendTemplatedEmailCommand({ /** * Here's an example of how a template would be replaced with user data: * Template:

Hello {{contact.firstName}},