本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `AWS-EnableDynamoDbAutoscaling`
<a name="AWS-EnableDynamoDbAutoscaling"></a>

 **Description** 

 `AWS-EnableDynamoDbAutoscaling` Runbook 會為您指定的佈建容量 Amazon DynamoDB 資料表啟用 Application Auto Scaling。Application Auto Scaling 可動態調整佈建的輸送量容量，以回應流量模式。如需詳細資訊，請參閱《Amazon [ DynamoDB 開發人員指南》中的使用 DynamoDB 自動擴展自動管理輸送量容量](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/AutoScaling.html)。 * DynamoDB * 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
+ TableName

  類型：字串

  描述：（必要） 您要啟用 Application Auto Scaling 的 DynamoDB 資料表名稱。
+ MinReadCapacity

  類型：整數

  描述：（必要） DynamoDB 資料表的佈建輸送量讀取容量單位數目下限。
+ MaxReadCapacity

  類型：整數

  描述：（必要） DynamoDB 資料表的佈建輸送量讀取容量單位數量上限。
+ TargetReadCapacityUtilization

  類型：整數

  描述：（必要） 所需的目標讀取容量使用率。目標使用率是某個時間點的已耗用佈建輸送量百分比。您可以將自動擴展目標使用率值設定為 20% 到 90%。
+ ReadScaleOutCooldown

  類型：整數

  描述：（必要） 等待先前的讀取容量向外擴展活動生效的秒數。
+ ReadScaleInCooldown

  類型：整數

  描述：（必要） 讀取容量縮減活動完成後，另一個縮減活動開始之前的秒數。
+ MinWriteCapacity

  類型：整數

  描述：（必要） DynamoDB 資料表的佈建輸送量寫入單位數目下限。
+ MaxWriteCapacity

  類型：整數

  描述：（必要） DynamoDB 資料表的佈建輸送量寫入單位數量上限。
+ TargetWriteCapacityUtilization

  類型：整數

  描述：（必要） 所需的目標寫入容量使用率。目標使用率是某個時間點的已耗用佈建輸送量百分比。您可以將自動擴展目標使用率值設定為 20% 到 90%。
+ WriteScaleOutCooldown

  類型：整數

  描述：（必要） 等待先前的寫入容量向外擴展活動生效的秒數。
+ WriteScaleInCooldown

  類型：整數

  描述：（必要） 寫入容量縮減活動完成後，另一個縮減活動開始之前的秒數。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+ `ssm:GetAutomationExecution`
+ `ssm:StartAutomationExecution`
+ `application-autoscaling:DescribeScalableTargets`
+ `application-autoscaling:DescribeScalingPolicies`
+ `application-autoscaling:PutScalingPolicy`
+ `application-autoscaling:RegisterScalableTarget`
+ RegisterAppAutoscalingTargetWrite (`aws:executeAwsApi`) - 在您指定的 DynamoDB 資料表上設定 Application Auto Scaling。
+ RegisterAppAutoscalingTargetWriteDelay (`aws:sleep`) - 休眠以避免 API 調節。
+ PutScalingPolicyWrite (`aws:executeAwsApi`) - 設定 DynamoDB 資料表的目標寫入容量使用率。
+ PutScalingPolicyWriteDelay (`aws:sleep`) - 休眠以避免 API 調節。
+ RegisterAppAutoscalingTargetRead (`aws:executeAwsApi`) - 設定 DynamoDB 資料表的最小和最大讀取容量單位。
+ RegisterAppAutoscalingTargetReadDelay (`aws:sleep`) - 休眠以避免 API 調節。
+ PutScalingPolicyRead (`aws:executeAwsApi`) - 設定 DynamoDB 資料表的目標讀取容量使用率。
+ VerifyDynamoDbAutoscalingEnabled (`aws:executeScript`) - 驗證應用程式Auto Scaling已根據您指定的值為 DynamoDB 資料表啟用。

 **輸出** 
+ RegisterAppAutoscalingTargetWrite.Response
+ PutScalingPolicyWrite.Response
+ RegisterAppAutoscalingTargetRead.Response
+ PutScalingPolicyRead.Response
+ VerifyDynamoDbAutoscalingEnabled.DynamoDbAutoscalingEnabledResponse