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

# Secrets Manager
<a name="automation-ref-asm"></a>

 AWS Systems Manager 自動化為 提供預先定義的 Runbook AWS Secrets Manager。如需有關執行手冊的詳細資訊，請參閱 [Working with runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)。如需如何檢視 Runbook 內容的詳細資訊，請參閱 [檢視 Runbook 內容](automation-runbook-reference.md#view-automation-json)。

**Topics**
+ [`AWSConfigRemediation-DeleteSecret`](automation-aws-delete-secret.md)
+ [`AWSConfigRemediation-RotateSecret`](automation-aws-rotate-secret.md)

# `AWSConfigRemediation-DeleteSecret`
<a name="automation-aws-delete-secret"></a>

 **Description** 

 `AWSConfigRemediation-DeleteSecret` Runbook 會刪除秘密和所有存放在其中的版本 AWS Secrets Manager。您可以選擇性地指定復原時段，在此期間可以還原秘密。如果您未指定 `RecoveryWindowInDays` 參數的值，則操作預設為 30 天。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-DeleteSecret) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（必要） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。
+ RecoveryWindowInDays

  類型：整數

  有效值：7-30

  預設：30

  描述：（選用） 您可以還原秘密的天數。
+ SecretId

  類型：字串

  描述：（必要） 您要刪除之秘密的 Amazon Resource Name (ARN)。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `secretsmanager:DeleteSecret` 
+  `secretsmanager:DescribeSecret` 

 **文件步驟** 
+  `aws:executeAwsApi` - 刪除您在 `SecretId` 參數中指定的秘密。
+  `aws:executeScript` - 驗證秘密已排定刪除。

# `AWSConfigRemediation-RotateSecret`
<a name="automation-aws-rotate-secret"></a>

 **Description** 

 `AWSConfigRemediation-RotateSecret` Runbook 會輪換存放在其中的秘密 AWS Secrets Manager。

 [執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-RotateSecret) 

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（必要） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。
+ RotationInterval

  類型：間隔

  有效值：1-365

  描述：（必要） 秘密輪換之間的天數。
+ RotationLambdaArn

  類型：字串

  描述：（必要） 可輪換秘密之函數的 AWS Lambda Amazon Resource Name (ARN)。
+ SecretId

  類型：字串

  描述：（必要） 您要輪換之秘密的 Amazon Resource Name (ARN)。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `lambda:InvokeFunction` 
+  `secretsmanager:DescribeSecret` 
+  `secretsmanager:RotateSecret` 

 **文件步驟** 
+  `aws:executeAwsApi` - 輪換您在 `SecretId` 參數中指定的秘密。
+  `aws:executeScript` - 驗證已在秘密上啟用輪換。