As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `AWSConfigRemediation-UpdateXRayKMSKey`
<a name="automation-aws-update-xray-key"></a>

 **Descrição** 

 O `AWSConfigRemediation-UpdateXRayKMSKey` runbook permite a criptografia em seus AWS X-Ray dados usando uma chave AWS Key Management Service (AWS KMS). Esse runbook só deve ser usado como base para garantir que seus AWS X-Ray dados sejam criptografados de acordo com as melhores práticas mínimas de segurança recomendadas. Recomendamos criptografar vários conjuntos de dados com chaves KMS diferentes. 

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-UpdateXRayKMSKey) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux, macOS, Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: string

  Descrição: (obrigatório) O nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome.
+ KeyId

  Tipo: string

  Descrição: (Obrigatório) O nome de recurso da Amazon (ARN), o ID da chave ou o alias da chave KMS que você deseja usar AWS X-Ray para criptografar dados.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `kms:DescribeKey` 
+  `xray:GetEncryptionConfig` 
+  `xray:PutEncryptionConfig` 

 **Etapas do documento** 
+  `aws:executeAwsApi`- Ativa a criptografia em seus X-Ray dados usando a chave KMS especificada no `KeyId` parâmetro. 
+  `aws:waitForAwsResourceProperty`- Aguarda o status da configuração de criptografia do seu X-Ray . `ACTIVE` 
+  `aws:executeAwsApi` :Reúne o ARN da chave especificada no parâmetro `KeyId`. 
+  `aws:assertAwsResourceProperty`- Verifica se a criptografia foi ativada em seu X-Ray.