

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon SQS
<a name="automation-ref-sqs"></a>

 AWS Systems Manager Automation 为亚马逊简单队列服务 (Amazon SQS) Simple SQS 提供了预定义的运行手册。有关运行手册的更多信息，请参阅[使用运行手册](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)。有关如何查看运行手册内容的信息，请参阅 [查看运行手册内容](automation-runbook-reference.md#view-automation-json)。

**Topics**
+ [`AWS-EnableSQSEncryption`](aws-enablesqsencryption.md)

# `AWS-EnableSQSEncryption`
<a name="aws-enablesqsencryption"></a>

 **描述** 

 该`AWS-EnableSQSEncryption`运行手册支持对亚马逊简单队列服务 (Amazon SQS) 队列进行静态加密。可以使用亚马逊 SQS 托管密钥 (SSE-SQS) 或 () 托管密钥 (SSE-KMS) 对亚马逊 SQS 队列 AWS Key Management Service 进行AWS KMS加密。您分配给队列的密钥必须具有密钥策略，其中包括所有有权使用该队列的委托人的权限。启用加密后，匿名`ReceiveMessage`请求`SendMessage`和对加密队列的请求将被拒绝。

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-EnableSQSEncryption) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux，macOS, Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ QueueUrl

  类型：字符串

  描述：（必填）您要启用加密的 Amazon SQS 队列的 URL。
+ KmsKeyId

  类型：字符串

  描述：（可选）用于加密的密 AWS KMS 钥。此值可以是全局唯一标识符、别名或密钥的 ARN，也可以是以 “alias/” 为前缀的别名。您也可以通过指定别名 aws/sqs 来使用 AWS 托管密钥。
+ KmsDataKeyReusePeriodSeconds

  类型：字符串

  有效值：60-86400

  默认：300

  描述：（可选）Amazon SQS 队列在再次调用之前可以重复使用数据密钥对消息进行加密或解密的时间长度（以秒为单位）。 AWS KMS 

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+ `ssm:GetAutomationExecution`
+ `ssm:StartAutomationExecution`
+ `sqs:GetQueueAttributes`
+ `sqs:SetQueueAttributes`

 **文档步骤** 
+ SelectKeyType (`aws:branch`)：基于指定密钥的分支。
+ PutAttributeSseKms (`aws:executeAwsApi`)-更新 Amazon SQS 队列以使用为加密指定的 AWS KMS 密钥。
+ PutAttributeSseSqs (`aws:executeAwsApi`)-更新 Amazon SQS 队列以使用默认密钥进行加密。
+ VerifySqsEncryptionKms (`aws:assertAwsResourceProperty`)-验证是否已在 Amazon SQS 队列上启用加密。
+ VerifySqsEncryptionDefault (`aws:assertAwsResourceProperty`)-验证是否已在 Amazon SQS 队列上启用加密。