适用于 JavaScript 的 AWS SDK v2 已终止支持。建议您迁移到 [适用于 JavaScript 的 AWS SDK v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/)。有关更多详情和如何迁移的信息，请参阅本[公告](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/)。

# 锁定 API 版本
<a name="locking-api-versions"></a>

AWS 服务具有 API 版本号，可用于跟踪 API 兼容性。AWS 服务中的 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 版本
<a name="getting-api-versions"></a>

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