AWSSupport-ShareRDSSnapshot - AWS Systems Manager 自動化 Runbook 參考

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

AWSSupport-ShareRDSSnapshot

Description

AWSSupport-ShareRDSSnapshot Runbook 為 知識中心文章中概述的程序提供自動化解決方案 如何與其他帳戶共用加密的 Amazon RDS 資料庫快照？ 如果您的 Amazon Relational Database Service (Amazon RDS) 快照是使用預設值加密 AWS 受管金鑰，則無法共用快照。在這種情況下，您必須使用客戶受管金鑰複製快照，然後與目標帳戶共用快照。此自動化會使用您在 SnapshotName 參數中指定的值，或所選 Amazon RDS 資料庫執行個體或叢集的最新快照來執行這些步驟。

注意

如果您未指定 KMSKey 參數的值，自動化會在您的帳戶中建立新的 AWS KMS 客戶受管金鑰，用來加密快照。

執行此自動化 （主控台）

文件類型

 自動化

擁有者

Amazon

平台

資料庫

參數

  • AccountIds

    類型：StringList

    描述：（必要） 共用快照的帳戶 IDs 逗號分隔清單。

  • AutomationAssumeRole

    類型：字串

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

  • 資料庫

    類型：字串

    描述：（必要） 您要共用其快照的 Amazon RDS 資料庫執行個體或叢集名稱。如果您指定 參數的值，則此SnapshotName參數為選用。

  • KMSKey

    類型：字串

    描述：（選用） 用於加密快照的客戶受管金鑰的完整 Amazon Resource Name (ARN) AWS KMS 。

  • SnapshotName

    類型：字串

    描述：（選用） 您要使用的資料庫叢集或執行個體快照 ID。

必要的 IAM 許可

AutomationAssumeRole 參數需要下列動作才能成功使用 Runbook。

  • ssm:StartAutomationExecution

  • rds:DescribeDBInstances

  • rds:DescribeDBSnapshots

  • rds:CopyDBSnapshot

  • rds:ModifyDBSnapshotAttribute

AutomationAssumeRole 需要下列動作，才能成功啟動資料庫叢集的 Runbook。

  • ssm:StartAutomationExecution

  • rds:DescribeDBClusters

  • rds:DescribeDBClusterSnapshots

  • rds:CopyDBClusterSnapshot

  • rds:ModifyDBClusterSnapshotAttribute

用來執行自動化的 IAM 角色必須新增為金鑰使用者，才能使用 ARNKmsKey 參數中指定的 KMS 金鑰。如需有關將金鑰使用者新增至 KMS 金鑰的資訊，請參閱《 AWS Key Management Service 開發人員指南》中的變更金鑰政策。

如果您未指定 KMSKey 參數的值， AutomationAssumeRole需要下列其他動作才能成功啟動 Runbook。

  • kms:CreateKey

  • kms:ScheduleKeyDeletion

  • kms:CreateGrant

  • kms:DescribeKey

文件步驟

  1. aws:executeScript - 檢查是否為 KMSKey 參數提供值，如果找不到值，則建立 AWS KMS 客戶受管金鑰。

  2. aws:branch - 檢查是否已相應地為 SnapshotName 參數和分支提供值。

  3. aws:executeAwsApi - 檢查提供的快照是否來自資料庫執行個體。

  4. aws:executeScript - 格式化SnapshotName參數，以連字號取代冒號。

  5. aws:executeAwsApi - 使用指定的 KMSKey 複製快照。

  6. aws:waitForAwsResourceProperty - 等待複製快照操作完成。

  7. aws:executeAwsApi - 與AccountIds指定的 共用新的快照。

  8. aws:executeAwsApi - 檢查提供的快照是否來自資料庫叢集。

  9. aws:executeScript - 格式化SnapshotName參數，以連字號取代冒號。

  10. aws:executeAwsApi - 使用指定的 KMSKey 複製快照。

  11. aws:waitForAwsResourceProperty - 等待複製快照操作完成。

  12. aws:executeAwsApi - 與AccountIds指定的 共用新的快照。

  13. aws:executeAwsApi - 檢查為 Database 參數提供的值是否為資料庫執行個體。

  14. aws:executeAwsApi - 檢查為 Database 參數提供的值是否為資料庫叢集。

  15. aws:executeAwsApi - 擷取指定 的快照清單Database。

  16. aws:executeScript - 從上一個步驟中組合的清單中確定可用的最新快照。

  17. aws:executeAwsApi - 使用指定的 複製資料庫執行個體快照KMSKey。

  18. aws:waitForAwsResourceProperty - 等待複製快照操作完成。

  19. aws:executeAwsApi - 與AccountIds指定的 共用新的快照。

  20. aws:executeAwsApi - 擷取指定 的快照清單Database。

  21. aws:executeScript - 從上一個步驟中組合的清單中確定可用的最新快照。

  22. aws:executeAwsApi - 使用指定的 複製資料庫執行個體快照KMSKey。

  23. aws:waitForAwsResourceProperty - 等待複製快照操作完成。

  24. aws:executeAwsApi - 與AccountIds指定的 共用新的快照。

  25. aws:executeScript - 如果您未指定 KMSKey 參數的值且自動化失敗，則刪除自動化建立 AWS KMS 的客戶受管金鑰。