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á.

# X-Ray
<a name="automation-ref-xray"></a>

AWS Systems Manager A automação fornece runbooks predefinidos para. AWS X-Ray Para obter informações sobre como usar runbooks, consulte [Trabalhado com runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Para obter informações sobre como visualizar o conteúdo do runbook, consulte [Exibir conteúdo do runbook](automation-runbook-reference.md#view-automation-json). 

**Topics**
+ [`AWSConfigRemediation-UpdateXRayKMSKey`](automation-aws-update-xray-key.md)

# `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` :Habilita a criptografia em seus dados do X-Ray usando a chave do KMS especificada no parâmetro `KeyId`. 
+  `aws:waitForAwsResourceProperty` :Espera que o status da configuração da criptografia do X-Ray seja `ACTIVE`. 
+  `aws:executeAwsApi` :Reúne o ARN da chave especificada no parâmetro `KeyId`. 
+  `aws:assertAwsResourceProperty` :Verifica se a criptografia foi habilitada no seu X-Ray.