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á.
# Usando funções para criar e gerenciar o contexto CloudTrail do evento no CloudTrail
AWS CloudTrail usa funções [vinculadas ao serviço AWS Identity and Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Uma função vinculada ao serviço é um tipo exclusivo de função do IAM vinculada diretamente a. CloudTrail As funções vinculadas ao serviço são predefinidas CloudTrail e incluem todas as permissões que o serviço exige para chamar outros AWS serviços em seu nome.
Uma função vinculada ao serviço facilita a configuração CloudTrail porque você não precisa adicionar manualmente as permissões necessárias. CloudTrail define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido de outra forma, só CloudTrail pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, que não pode ser anexada a nenhuma outra entidade do IAM.
Um perfil vinculado ao serviço poderá ser excluído somente após excluir seus atributos relacionados. Isso protege seus CloudTrail recursos porque você não pode remover inadvertidamente a permissão para acessar os recursos.
Para obter informações sobre outros serviços que oferecem suporte a funções vinculadas a serviços, consulte [AWS Serviços que funcionam com IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e procure os serviços que têm **Sim** na coluna Funções **vinculadas ao serviço**. Escolha um **Sim** com um link para visualizar a documentação do perfil vinculado a esse serviço.
## Permissões de função vinculadas ao serviço para CloudTrail
CloudTrail usa a função vinculada ao serviço chamada **AWSServiceRoleForCloudTrailEventContext**— Essa função vinculada ao serviço é usada para gerenciar o contexto e EventBridge as CloudTrail regras do evento.
A função AWSService RoleForCloudTrailEventContext vinculada ao serviço confia nos seguintes serviços para assumir a função:
+ `context.cloudtrail.amazonaws.com`
A política de permissões de função nomeada CloudTrailEventContext CloudTrail permite concluir as seguintes ações nos recursos especificados:
+ Ações em tags de recurso:
+ `tag:GetResources`
+ Ações em todos os EventBridge recursos da Amazon para que o responsável pelo CloudTrail serviço crie regras:
+ `events:PutRule`
+ Ações em todos os EventBridge recursos da Amazon para que o responsável pelo CloudTrail serviço gerencie as regras que ele cria:
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`
+ `events:RemoveTargets`
+ Ações em todos os EventBridge recursos da Amazon para que o responsável pelo CloudTrail serviço descreva as regras que ele cria:
+ `events:DescribeRule`
+ `events:DeRegisterResource`
+ Ações em todos os EventBridge recursos da Amazon:
+ `events:ListRules`
Você deve configurar permissões para permitir que seus usuários, grupos ou perfis criem, editem ou excluam um perfil vinculado ao serviço. Para obter mais informações, consulte [Permissões do perfil vinculado a serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do usuário do IAM*.
Para obter mais informações sobre a política gerenciada associada à AWSServiceRoleForCloudTrailEventContext, consulte[AWS políticas gerenciadas para AWS CloudTrail](security-iam-awsmanpol.md).
## Criação de uma função vinculada ao serviço para CloudTrail
Não é necessário criar manualmente um perfil vinculado ao serviço. Quando você começa a usar o recurso de evento de contexto na Console de gerenciamento da AWS AWS CLI, na ou na AWS API, CloudTrail cria a função vinculada ao serviço para você.
Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, será possível usar esse mesmo processo para recriar o perfil em sua conta. Quando você começa a usar o recurso de evento de contexto, CloudTrail cria a função vinculada ao serviço para você novamente.
## Editando uma função vinculada ao serviço para CloudTrail
CloudTrail não permite que você edite a função AWSService RoleForCloudTrailEventContext vinculada ao serviço. Depois que criar um perfil vinculado ao serviço, você não poderá alterar o nome do perfil, pois várias entidades podem fazer referência a ele. No entanto, será possível editar a descrição do perfil usando o IAM. Para saber mais, consulte [Editar um perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) no *Guia do usuário do IAM*.
## Excluindo a função vinculada ao AWSService RoleForCloudTrailEventContext serviço para CloudTrail
Se você não precisar mais usar um recurso ou serviço que exija a função AWSService RoleForCloudTrailEventContext vinculada ao serviço, recomendamos que você exclua essa função. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos da sua função vinculada ao serviço antes de excluí-la manualmente removendo a TagContext chave dos armazenamentos de dados de eventos.
**nota**
Se o CloudTrail serviço estiver usando a função quando você tentar excluir os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.
**Para excluir CloudTrail recursos usados pela função vinculada ao AWSService RoleForCloudTrailEventContext serviço**
1. No terminal ou na linha de comando, execute o comando **put-event-configuration** para o armazenamento de eventos do qual você deseja remover a chave `TagContext`. Por exemplo, para remover a `TagContext` chave de um armazenamento de eventos na {{111122223333}} conta na região Leste dos EUA (Ohio) com um ARN de {{arn:aws:cloudtrail:us-east-2:111122223333:eventdatastore/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}} where `TagContext` é o único seletor de chave de contexto, você usaria o **put-event-configuration** comando sem valor especificado para: `--context-key-selectors`
```
aws cloudtrail put-event-configuration --event-data-store arn:aws:cloudtrail:{{us-east-2}}:{{111122223333}}:eventdatastore/{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}} --max-event-size Large --context-key-selectors
```
1. Repita esse comando para todo datastore em toda região na partição. Para obter mais informações, consulte [Identificar AWS recursos com os nomes de recursos da Amazon (ARNs)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html).
**Como excluir manualmente o perfil vinculado ao serviço usando o IAM**
Use o console do IAM AWS CLI, o ou a AWS API para excluir a função AWSService RoleForCloudTrailEventContext vinculada ao serviço. Para saber mais, consulte [Excluir um perfil vinculado ao serviço](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) no *Guia do usuário do IAM*.