AWSSupport-ShareRDSSnapshot - AWS Systems Manager オートメーションランブックリファレンス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWSSupport-ShareRDSSnapshot

説明

AWSSupport-ShareRDSSnapshot ランブックは、ナレッジセンター記事「暗号化された Amazon RDS DB スナップショットを別のアカウントと共有する方法を教えてください。」で説明されている手順についての、自動化されたソリューションを提供します。Amazon Relational Database Service (Amazon RDS) スナップショットがデフォルトの を使用して暗号化されている場合 AWS マネージドキー、スナップショットを共有することはできません。この場合、カスタマーマネージドキーを使用してスナップショットをコピーしてから、スナップショットをターゲットアカウントと共有する必要があります。このオートメーションでは、SnapshotName パラメータで指定した値、または選択した Amazon RDS DB インスタンスまたはクラスターで見つかった最新のスナップショットを使用して、これらのステップが実行されます。

注記

KMSKey パラメータの値を指定しない場合、オートメーションはスナップショットの暗号化に使用される新しい AWS KMS カスタマーマネージドキーをアカウントに作成します。

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

Amazon

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

データベース

パラメータ

  • AccountIds

    タイプ： StringList

    説明: (必須) スナップショットを共有するアカウント ID のカンマ区切りリスト。

  • AutomationAssumeRole

    型: 文字列

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

  • データベース

    型: 文字列

    説明: (必須) スナップショットを共有する Amazon RDS DB インスタンスまたはクラスターの名前。SnapshotName パラメータの値を指定する場合、このパラメータはオプションです。

  • KMSKey

    型: 文字列

    説明: (オプション) スナップショットの暗号化に使用される AWS KMS カスタマーマネージドキーの完全な Amazon リソースネーム (ARN)。

  • SnapshotName

    型: 文字列

    説明: (オプション) 使用する DB クラスターまたはインスタンススナップショットの ID。

必要な IAM アクセス許可

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

  • ssm:StartAutomationExecution

  • rds:DescribeDBInstances

  • rds:DescribeDBSnapshots

  • rds:CopyDBSnapshot

  • rds:ModifyDBSnapshotAttribute

AutomationAssumeRole では、DB クラスターでランブックを正常に起動するために、次のアクションが必要です。

  • ssm:StartAutomationExecution

  • rds:DescribeDBClusters

  • rds:DescribeDBClusterSnapshots

  • rds:CopyDBClusterSnapshot

  • rds:ModifyDBClusterSnapshotAttribute

オートメーションの実行に使用される IAM ロールは、ARNKmsKey パラメータで指定された KMS キーを使用するためにキーユーザーとして追加する必要があります。KMS キーへのキーユーザーの追加については、AWS Key Management Service デベロッパーガイドの「キーポリシーの変更」を参照してください。

KMSKey パラメータで値を指定していない場合、AutomationAssumeRole には、ランブックを正常に実行するために以下のような追加アクションが必要です。

  • kms:CreateKey

  • kms:ScheduleKeyDeletion

  • kms:CreateGrant

  • kms:DescribeKey

ドキュメントステップ

  1. aws:executeScript - KMSKeyパラメータに値が指定されたかどうかを確認し、値が見つからない場合は AWS KMS カスタマーマネージドキーを作成します。

  2. aws:branch - SnapshotName パラメータに値が指定されたかどうかをチェックし、それに応じて分岐します。

  3. aws:executeAwsApi - 提供されたスナップショットが DB インスタンスのものであるかどうかをチェックします。

  4. aws:executeScript - コロンをハイフンに置き換える SnapshotName パラメータをフォーマットします。

  5. aws:executeAwsApi - 指定した KMSKey を使用してスナップショットをコピーします。

  6. aws:waitForAwsResourceProperty - コピースナップショットの操作が完了するまで待機します。

  7. aws:executeAwsApi - 新しいスナップショットを指定した AccountIds と共有します。

  8. aws:executeAwsApi - 提供されたスナップショットが DB クラスターのものであるかどうかをチェックします。

  9. aws:executeScript - コロンをハイフンに置き換える SnapshotName パラメータをフォーマットします。

  10. aws:executeAwsApi - 指定した KMSKey を使用してスナップショットをコピーします。

  11. aws:waitForAwsResourceProperty - コピースナップショットの操作が完了するまで待機します。

  12. aws:executeAwsApi - 新しいスナップショットを指定した AccountIds と共有します。

  13. aws:executeAwsApi - Database パラメータに指定された値が DB インスタンスであるかどうかをチェックします。

  14. aws:executeAwsApi - Database パラメータに指定された値が DB クラスターであるかどうかをチェックします。

  15. aws:executeAwsApi - 指定された Database のスナップショットのリストを取得します。

  16. aws:executeScript - 前のステップでアセンブルされたリストから使用可能な最新のスナップショットを決定します。

  17. aws:executeAwsApi - 指定した KMSKey を使用して DB インスタンスのスナップショットをコピーします。

  18. aws:waitForAwsResourceProperty - コピースナップショットの操作が完了するまで待機します。

  19. aws:executeAwsApi - 新しいスナップショットを指定した AccountIds と共有します。

  20. aws:executeAwsApi - 指定された Database のスナップショットのリストを取得します。

  21. aws:executeScript - 前のステップでアセンブルされたリストから使用可能な最新のスナップショットを決定します。

  22. aws:executeAwsApi - 指定した KMSKey を使用して DB インスタンスのスナップショットをコピーします。

  23. aws:waitForAwsResourceProperty - コピースナップショットの操作が完了するまで待機します。

  24. aws:executeAwsApi - 新しいスナップショットを指定した AccountIds と共有します。

  25. aws:executeScript - KMSKeyパラメータの値を指定せず、オートメーションが失敗した場合、オートメーションによって作成された AWS KMS カスタマーマネージドキーを削除します。