AWS-EnableDynamoDbAutoscaling

説明

AWS-EnableDynamoDbAutoscaling ランブックは、指定したプロビジョニングされた容量の Amazon DynamoDB テーブルに対して Application Auto Scaling を有効にします。Application Auto Scaling は、トラフィックパターンに応じてプロビジョニングされたスループットキャパシティを動的に調整します。詳細については、「Amazon DynamoDB デベロッパーガイド」の「DynamoDB Auto Scaling によるスループットキャパシティの自動管理」を参照してください。 DynamoDB

ドキュメントタイプ

Automation

所有者

Amazon

[Platforms] (プラットフォーム)

Linux、macOS、Windows

パラメータ

• AutomationAssumeRole

  型: 文字列

  説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

• TableName

  型: 文字列

  説明: (必須) Application Auto Scaling を有効にする DynamoDB テーブルの名前。

• MinReadCapacity

  タイプ: 整数

  説明: (必須) DynamoDB テーブルのプロビジョニングされたスループット読み込みキャパシティユニットの最小数。

• MaxReadCapacity

  タイプ: 整数

  説明: (必須) DynamoDB テーブルのプロビジョニングされたスループット読み込みキャパシティユニットの最大数。

• TargetReadCapacityUtilization

  タイプ: 整数

  説明: (必須) 希望するターゲット読み取り容量使用率。ターゲット使用率は、ある時点で消費されたプロビジョンドスループットの割合です。Auto Scaling ターゲット使用率の値は 20～90% の間で設定できます。

• ReadScaleOutCooldown

  タイプ: 整数

  説明: (必須) 以前の読み込みキャパシティのスケールアウトアクティビティが有効になるまでの秒単位の待機時間。

• ReadScaleInCooldown

  タイプ: 整数

  説明: (必須) 読み込みキャパシティのスケールインアクティビティが完了してから別のスケールインアクティビティが開始されるまでの秒単位の時間。

• MinWriteCapacity

  タイプ: 整数

  説明: (必須) DynamoDB テーブルのプロビジョニングされたスループット書き込みユニットの最小数。

• MaxWriteCapacity

  タイプ: 整数

  説明: (必須) DynamoDB テーブルのプロビジョニングされたスループット書き込みユニットの最大数。

• TargetWriteCapacityUtilization

  タイプ: 整数

  説明: (必須) 希望するターゲット書き込み容量使用率。ターゲット使用率は、ある時点で消費されたプロビジョンドスループットの割合です。Auto Scaling ターゲット使用率の値は 20～90% の間で設定できます。

• WriteScaleOutCooldown

  タイプ: 整数

  説明: (必須) 以前の書き込みキャパシティのスケールアウトアクティビティが有効になるまでの秒単位の待機時間。

• WriteScaleInCooldown

  タイプ: 整数

  説明: (必須) 書き込みキャパシティのスケールインアクティビティが完了してから別のスケールインアクティビティが開始されるまでの秒単位の時間。

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

• 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 スロットリングを回避するための TAK。

• PutScalingPolicyWrite (aws:executeAwsApi) - DynamoDB テーブルのターゲット書き込み容量使用率を設定します。

• PutScalingPolicyWriteDelay (aws:sleep) - API スロットリングを回避するための TAK。

• RegisterAppAutoscalingTargetRead (aws:executeAwsApi) - DynamoDB テーブルの最小読み込みキャパシティーユニットと最大読み込みキャパシティーユニットを設定します。

• RegisterAppAutoscalingTargetReadDelay (aws:sleep) - API スロットリングを回避するためのものです。

• PutScalingPolicyRead (aws:executeAwsApi) - DynamoDB テーブルのターゲット読み取り容量使用率を設定します。

• VerifyDynamoDbAutoscalingEnabled (aws:executeScript ) - 指定した値に従って、DynamoDB テーブルで Application Auto Scaling が有効になっていることを確認します。

[Outputs] (出力)

• RegisterAppAutoscalingTargetWrite.Response

• PutScalingPolicyWrite.Response

• RegisterAppAutoscalingTargetRead.Response

• PutScalingPolicyRead.Response

• VerifyDynamoDbAutoscalingEnabled.DynamoDbAutoscalingEnabledResponse