Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon SDK for JavaScript v2 已终止支持。建议您迁移到 Amazon SDK for JavaScript v3。有关更多详情和如何迁移的信息，请参阅本公告。

锁定 API 版本

Amazon 服务具有 API 版本号，可用于跟踪 API 兼容性。Amazon 服务中的 API 版本由 YYYY-mm-dd 格式的日期字符串标识。例如，Amazon S3 的当前 API 版本为 2006-03-01。

如果您在生产代码中依赖某项服务的 API 版本，我们建议您锁定该版本。这可以使您的应用程序与开发工具包更新导致的服务更改隔离开来。如果在创建服务对象时未指定 API 版本，则开发工具包默认使用最新的 API 版本。这可能会导致您的应用程序使用对自身产生负面影响的更改来引用更新的 API。

要锁定用于某项服务的 API 版本，请在构造服务对象时传递 apiVersion 参数。在以下示例中，新创建的 AWS.DynamoDB 服务对象锁定到 2011-12-05 API 版本：

var dynamodb = new AWS.DynamoDB({apiVersion: '2011-12-05'});

您可以通过在 apiVersions 中指定 AWS.Config 参数来全局配置一组服务 API 版本。例如，要设置特定版本的 DynamoDB 和 Amazon EC2 API 以及当前 Amazon Redshift API，请按如下所示设置 apiVersions：

AWS.config.apiVersions = {
  dynamodb: '2011-12-05',
  ec2: '2013-02-01',
  redshift: 'latest'
};

获取 API 版本

要获取某项服务的 API 版本，请参阅该服务参考页面上的“Locking the API Version”部分（例如 Amazon S3 的 https://docs.amazonaws.cn/AWSJavaScriptSDK/latest/AWS/S3.html）。