指定自定义终端节点 - AWS SDK for JavaScript

我们已宣布即将终止对 AWS SDK for JavaScript v2 的支持。建议您迁移到 AWS SDK for JavaScript v3。有关日期、其他详细信息以及如何迁移的信息,请参阅链接的公告。

指定自定义终端节点

在 SDK for JavaScript 中调用 API 方法针对的是服务端点 URI。默认情况下,这些终端节点是根据您为代码配置的区域构建的。但是,在某些情况下,您需要为 API 调用指定自定义终端节点。

终端节点字符串格式

终端节点值应为以下格式的字符串:

https://{service}.{region}.amazonaws.com

ap-northeast-3 区域的终端节点

日本的 ap-northeast-3 区域不会被区域枚举 API(例如 EC2.describeRegions)返回。要定义此区域的终端节点,请遵循前面描述的格式。因此,此区域的 Amazon EC2 端点将是

ec2.ap-northeast-3.amazonaws.com

MediaConvert 的端点

您需要创建一个与 MediaConvert 配合使用的自定义端点。每个客户账户都分配了自己的终端节点,您必须使用该终端节点。以下示例演示如何将自定义端点与 MediaConvert 配合使用。

// Create MediaConvert service object using custom endpoint var mcClient = new AWS.MediaConvert({endpoint: 'https://abcd1234.mediaconvert.us-west-1.amazonaws.com'}); var getJobParams = {Id: 'job_ID'}; mcClient.getJob(getJobParams, function(err, data)) { if (err) console.log(err, err.stack); // an error occurred else console.log(data); // successful response };

要获取您的账户 API 终端节点,请参阅 API 参考中的MediaConvert.describeEndpoints

确保在代码中指定与自定义终端节点 URI 中的区域相同的区域。区域设置和自定义终端节点 URI 之间的不匹配可能导致 API 调用失败。

有关 MediaConvert 的更多信息,请参阅 API 参考中的 AWS.MediaConvert 类或《AWS Elemental MediaConvert User Guide》。