翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# DynamoDB
AWS Systems Manager Automation は、Amazon DynamoDB 用に事前定義されたランブックを提供します。詳細については、「[ランブックの使用](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)」を参照してください。ランブックコンテンツを表示する方法については、[ランブックの内容を表示する](automation-runbook-reference.md#view-automation-json) を参照してください。
**Topics**
+ [`AWS-ChangeDDBRWCapacityMode`](change-read-write-capacity.md)
+ [`AWS-CreateDynamoDBBackup`](automation-aws-createdynamodbbackup.md)
+ [`AWS-DeleteDynamoDbBackup`](automation-aws-deletedynamodbbackup.md)
+ [`AWSConfigRemediation-DeleteDynamoDbTable`](automation-aws-deletedynamodbtable.md)
+ [`AWS-DeleteDynamoDbTableBackups`](automation-aws-deletedynamodbtablebackups.md)
+ [`AWSConfigRemediation-EnableEncryptionOnDynamoDbTable`](automation-aws-enable-ddb-encrypt.md)
+ [`AWSConfigRemediation-EnablePITRForDynamoDbTable`](automation-aws-enable-pitr-ddb.md)
+ [`AWS-EnableDynamoDbAutoscaling`](AWS-EnableDynamoDbAutoscaling.md)
+ [`AWS-RestoreDynamoDBTable`](aws-restore-dynamodb-table.md)
# `AWS-ChangeDDBRWCapacityMode`
**説明**
`AWS-ChangeDDBRWCapacityMode` ランブックは、1 つ以上の Amazon DynamoDB (DynamoDB) テーブルの読み取り/書き込みキャパシティモードをオンデマンドモードまたはプロビジョンドモードに変更します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ChangeDDBRWCapacityMode)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ CapacityMode
タイプ: 文字列
有効な値: PROVISIONED \$1 PAY\$1PER\$1REQUEST
説明: (必須) 必要な読み取り/書き込みキャパシティモード。オンデマンド (pay-per-requestからプロビジョンドキャパシティに切り替える場合は、プロビジョンドキャパシティの初期値を設定する必要があります。プロビジョニングされた初期容量値は、過去 30 分間にテーブルとグローバルセカンダリインデックスの消費された読み取りおよび書き込み容量に基づいて推定されます。
+ ReadCapacityUnits
タイプ: 整数
デフォルト: 0
説明: (オプション) DynamoDB がスロットリング例外を返すまでに 1 秒あたりに消費される強力な整合性のある読み込みの最大数。
+ TableNames
タイプ: 文字列
説明: (必須) 読み取り/書き込みキャパシティモードを変更する DynamoDB テーブル名のカンマ区切りリスト。
+ WriteCapacityUnits
タイプ: 整数
デフォルト: 0
説明: (オプション) DynamoDB がスロットリング例外を返すまでに 1 秒あたりに消費される書き込みの最大数。
**必要な IAM アクセス許可**
`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `dynamodb:DescribeTable`
+ `dynamodb:UpdateTable`
**ドキュメントステップ**
+ `aws:executeScript` - `TableNames`パラメータで指定された DynamoDB テーブルの読み取り/書き込みキャパシティモードを変更します。
**出力**
ChangeDDBRWCapacityMode.SuccessesTables - キャパシティモードが正常に変更された DynamoDB テーブル名のリスト
ChangeDDBRWCapacityMode.FailedTables - 容量モードの変更が失敗した DynamoDB テーブル名のマップリストと、失敗の理由。
# `AWS-CreateDynamoDBBackup`
**説明**
Amazon DynamoDB テーブルのバックアップを作成します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-CreateDynamoDBBackup)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ BackupName
タイプ: 文字列
説明: (必須) 作成するバックアップの名前。
+ LambdaAssumeRole
タイプ: 文字列
説明: (オプション) 自動化によって作成された Lambda がユーザーに代わってアクションを実行できるようにするロールの ARN。指定されていない場合、Lambda 関数を実行するために一時的なロールが作成されます。
+ TableName
タイプ: 文字列
説明: (必須) DynamoDB テーブルの名前。
# `AWS-DeleteDynamoDbBackup`
**説明**
Amazon DynamoDB テーブルのバックアップを削除します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteDynamoDbBackup)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ BackupArn
タイプ: 文字列
説明: (必須) 削除する DynamoDB テーブルのバックアップの ARN。
# `AWSConfigRemediation-DeleteDynamoDbTable`
**説明**
`AWSConfigRemediation-DeleteDynamoDbTable` ランブックは、指定した Amazon DynamoDB (DynamoDB) テーブルを削除します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-DeleteDynamoDbTable)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (必須) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。
+ TableName
タイプ: 文字列
説明: (必須) 削除する DynamoDB テーブルの名前。
**必要な IAM アクセス許可**
`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `dynamodb:DeleteTable`
+ `dynamodb:DescribeTable`
**ドキュメントステップ**
+ `aws:executeScript` - `TableName` パラメータで指定された DynamoDB テーブルを削除します。
+ `aws:executeScript` - DynamoDB テーブルが削除されたことを確認します。
# `AWS-DeleteDynamoDbTableBackups`
**説明**
保持日数またはカウントに基づいて DynamoDB テーブルのバックアップを削除します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteDynamoDbTableBackups)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ LambdaAssumeRole
タイプ: 文字列
説明: (オプション) 自動化によって作成された Lambda がユーザーに代わってアクションを実行できるようにするロールの ARN。指定されていない場合、Lambda 関数を実行するために一時的なロールが作成されます。
+ RetentionCount
タイプ: 文字列
デフォルト: 10
説明: (オプション) テーブルに保持するバックアップの数。指定した数を超えるバックアップが存在する場合は、超えた数の分の最も古いバックアップが削除されます。RetentionCount または RetentionDays のいずれかを使用できますが、両方を使用することはできません。
+ RetentionDays
タイプ: 文字列
説明: (オプション) テーブルのバックアップを保持する日数。指定した日数より古いバックアップは削除されます。RetentionCount または RetentionDays のいずれかを使用できますが、両方を使用することはできません。
+ TableName
タイプ: 文字列
説明: (必須) DynamoDB テーブルの名前。
# `AWSConfigRemediation-EnableEncryptionOnDynamoDbTable`
**説明**
`AWSConfigRemediation-EnableEncryptionOnDynamoDbTable` ランブックは、 `KMSKeyId`パラメータに指定した AWS Key Management Service () カスタマーマネージドキーを使用して Amazon DynamoDB (DynamoDB AWS KMS) テーブルを暗号化します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-EnableEncryptionOnDynamoDbTable)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (必須) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。
+ KMSKeyId
タイプ: 文字列
説明:(必須) `TableName` パラメータで指定した DynamoDB テーブルの暗号化に使用する、カスタマーマネージドキーの ARN。
+ TableName
タイプ: 文字列
説明: (必須) 暗号化する DynamoDB テーブルの名前。
**必要な IAM アクセス許可**
`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `dynamodb:DescribeTable`
+ `dynamodb:UpdateTable`
**ドキュメントステップ**
+ `aws:executeAwsApi` - `TableName` パラメータで指定された DynamoDB テーブルを暗号化します。
+ `aws:waitForAwsResourceProperty` - DynamoDB テーブルの `SSESpecification` での `Enabled` プロパティが `true` に設定されていることを確認します。
+ `aws:assertAwsResourceProperty` - DynamoDB テーブルが、`KMSKeyId` パラメータで指定されたカスタマーマネージドキーで暗号化されていることを確認します。
# `AWSConfigRemediation-EnablePITRForDynamoDbTable`
**説明**
`AWSConfigRemediation-EnablePITRForDynamoDbTable` ランブックは、ユーザーにより指定された Amazon DynamoDB テーブルで、ポイントインタイムリカバリ (PITR) を有効にします。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-EnablePITRForDynamoDbTable)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (必須) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。
+ TableName
タイプ: 文字列
説明: (必須) ポイントインタイムリカバリを有効にする DynamoDB テーブルの名前。
**必要な IAM アクセス許可**
`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `dynamodb:DescribeContinuousBackups `
+ `dynamodb:UpdateContinuousBackups`
**ドキュメントステップ**
+ `aws:executeAwsApi` - `TableName` パラメータで指定された DynamoDB テーブルの、ポイントインタイムリカバリを有効にします。
+ `aws:assertAwsResourceProperty` - DynamoDB テーブルでポイントインタイムリカバリが有効になっていることを確認します。
# `AWS-EnableDynamoDbAutoscaling`
**説明**
`AWS-EnableDynamoDbAutoscaling` ランブックは、指定したプロビジョンドキャパシティの Amazon DynamoDB テーブルに対して Application Auto Scaling を有効にします。Application Auto Scaling は、トラフィックパターンに応じてプロビジョニングされたスループットキャパシティを動的に調整します。詳細については、「Amazon [DynamoDB デベロッパーガイド」の「DynamoDB 自動スケーリングによるスループットキャパシティの自動管理](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/AutoScaling.html)」を参照してください。 * 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
タイプ: 整数
説明: (必須) 目的のターゲット読み取りキャパシティ使用率。ターゲット使用率は、ある時点で消費されたプロビジョンドスループットの割合です。自動スケーリングのターゲット使用率の値は 20～90% に設定できます。
+ ReadScaleOutCooldown
タイプ: 整数
説明: (必須) 以前の読み込みキャパシティのスケールアウトアクティビティが有効になるまでの秒単位の待機時間。
+ ReadScaleInCooldown
タイプ: 整数
説明: (必須) 読み込みキャパシティのスケールインアクティビティが完了してから、別のスケールインアクティビティを開始できるまでの秒単位の時間。
+ MinWriteCapacity
タイプ: 整数
説明: (必須) DynamoDB テーブルのプロビジョニングされたスループット書き込みユニットの最小数。
+ MaxWriteCapacity
タイプ: 整数
説明: (必須) DynamoDB テーブルのプロビジョニングされたスループット書き込みユニットの最大数。
+ TargetWriteCapacityUtilization
タイプ: 整数
説明: (必須) 目的のターゲット書き込みキャパシティ使用率。ターゲット使用率は、ある時点で消費されたプロビジョンドスループットの割合です。自動スケーリングのターゲット使用率の値は 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 スロットリングを避けるためにスリープします。
+ PutScalingPolicyWrite (`aws:executeAwsApi`) - DynamoDB テーブルのターゲット書き込み容量使用率を設定します。
+ PutScalingPolicyWriteDelay (`aws:sleep`) - API スロットリングを避けるためにスリープします。
+ RegisterAppAutoscalingTargetRead (`aws:executeAwsApi`) - DynamoDB テーブルの最小読み取りキャパシティーユニットと最大読み取りキャパシティーユニットを設定します。
+ RegisterAppAutoscalingTargetReadDelay (`aws:sleep`) - API スロットリングを避けるためにスリープします。
+ PutScalingPolicyRead (`aws:executeAwsApi`) - DynamoDB テーブルのターゲット読み取りキャパシティ使用率を設定します。
+ VerifyDynamoDbAutoscalingEnabled (`aws:executeScript`) - 指定した値に従って、DynamoDB テーブルで Application Auto Scaling が有効になっていることを確認します。
**出力**
+ RegisterAppAutoscalingTargetWrite.Response
+ PutScalingPolicyWrite.Response
+ RegisterAppAutoscalingTargetRead.Response
+ PutScalingPolicyRead.Response
+ VerifyDynamoDbAutoscalingEnabled.DynamoDbAutoscalingEnabledResponse
# `AWS-RestoreDynamoDBTable`
**説明**
`AWS-RestoreDynamoDBTable` ランブックは、ポイントインタイムリカバリ (PITR) を使用して指定した Amazon DynamoDB テーブルを復元します。
[このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-RestoreDynamoDBTable)
**ドキュメントタイプ**
Automation
**[所有者]**
Amazon
**[Platforms]** (プラットフォーム)
データベース
**パラメータ**
+ AutomationAssumeRole
タイプ: 文字列
説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ EnablePointInTimeRecoverAsNeeded
型: ブール値
デフォルト: true
説明: (オプション) テーブルの復元に必要なポイントインタイムリカバリを自動化でオンにするかどうかを決定します。
+ GlobalSecondaryIndexOverride
タイプ: 文字列
説明: (オプション) 新しいテーブルの既存のセカンダリインデックスを置き換える新しいグローバルセカンダリインデックス。
+ LocalSecondaryIndexOverride
タイプ: 文字列
説明: (オプション) 新しいテーブルの既存のセカンダリインデックスを置き換える新しいローカルセカンダリインデックス。
+ RestoreDateTime
タイプ: 文字列
説明: (必須) 過去 35 日間にテーブルを復元するポイントインタイムリカバリ。日付と時間は `DD/MM/YYYY HH:MM:SS` の形式で指定します。
+ SourceTableArn
タイプ: 文字列
説明: (必須) 復元するテーブルの ARN。
+ SseSpecificationOverride
タイプ: 文字列
説明: (オプション) 新しいテーブルに使用するサーバー側の暗号化設定。
+ TargetTableName
タイプ: 文字列
説明: (必須) 復元するテーブルの名前。
**必要な IAM アクセス許可**
`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+ `dynamodb:BatchWriteItem`
+ `dynamodb:DeleteItem`
+ `dynamodb:DescribeTable`
+ `dynamodb:GetItem`
+ `dynamodb:PutItem`
+ `dynamodb:Query`
+ `dynamodb:RestoreTableToPointInTime`
+ `dynamodb:Scan`
+ `dynamodb:UpdateItem`
**ドキュメントステップ**
+ `aws:executeScript` - ポイントインタイムリカバリを使用して `TargetTableName` パラメータで指定された DynamoDB テーブルを復元します。