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

# `AWS-EnableKinesisStreamEncryption`
<a name="aws-enablekinesisstreamencryption"></a>

 **Description** 

 `AWS-EnableKinesisStreamEncryption` Runbook 會在 Amazon Kinesis Data Streams (Kinesis Data Streams) 上啟用加密。如果寫入加密串流的生產者應用程式無法存取 AWS Key Management Service (AWS KMS) 金鑰，將會發生錯誤。

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

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

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

  類型：字串

  描述：（必要） 您要啟用加密的串流名稱。
+ KeyId

  類型：字串

  預設：alias/aws/kinesis

  描述：（必要） 您要用於加密的客戶受管 AWS KMS 金鑰。此值可以是全域唯一識別符、別名或金鑰的 ARN，或是以 "alias/" 開頭的別名名稱。您也可以使用 參數的預設值來使用 AWS 受管金鑰。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+ `ssm:GetAutomationExecution`
+ `ssm:StartAutomationExecution`
+ `kinesis:DescribeStream`
+ `kinesis:StartStreamEncryption`
+ `kms:DescribeKey`

 **文件步驟** 
+ VerifyKinesisStreamStatus (`aws:waitforAwsResourceProperty`) - 檢查 Kinesis Data Streams 的狀態。
+ EnableKinesisStreamEncryption (`aws:executeAwsApi`) - 啟用 Kinesis Data Streams 的加密。
+ VerifyKinesisStreamUpdateComplete (`aws:waitForAwsResourceProperty`) - 等待 Kinesis Data Streams 狀態傳回 `ACTIVE`。
+ VerifyKinesisStreamEncryption (`aws:assertAwsResourceProperty`) - 驗證 Kinesis Data Streams 已啟用加密。