適用於 JavaScript 的 AWS SDK v2 已end-of-support。我們建議您遷移至 [適用於 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'});
```

您可以透過在 `AWS.Config` 中指定 ` apiVersions` 參數，來全域設定一組服務 API 版本。例如，若要設定特定版本的 DynamoDB 和 Amazon EC2 APIs 以及目前的 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 版本，請參閱服務參考頁面上的*鎖定 API 版本*一節，例如 [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html) for Amazon S3。