

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 vinculadas a serviços para a Amazon WorkMail
<a name="using-service-linked-roles"></a>

A Amazon WorkMail usa AWS Identity and Access Management funções [vinculadas a serviços](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Uma função vinculada a serviços é um tipo exclusivo de função do IAM vinculada diretamente à Amazon. WorkMail As funções vinculadas ao serviço são predefinidas pela Amazon WorkMail e incluem todas as permissões que o serviço exige para ligar para outros AWS serviços em seu nome. 

Uma função vinculada ao serviço facilita a configuração da Amazon WorkMail porque você não precisa adicionar manualmente as permissões necessárias. A Amazon WorkMail define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido de outra forma, somente a Amazon WorkMail pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, e essa política de permissões não pode ser anexada a nenhuma outra entidade do IAM.

Você pode excluir um perfil vinculado ao serviço somente depois de excluir os atributos relacionados. Isso protege seus WorkMail recursos da Amazon 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 às funções vinculadas a serviço, consulte [Serviços da AWS compatíveis que funcionam com o IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) e procure os serviços que apresentam **Sim **na coluna **Função vinculada ao serviço**. Escolha um **Sim** com um link para exibir a documentação da função vinculada a serviço desse serviço.

## Permissões de função vinculadas ao serviço para a Amazon WorkMail
<a name="slr-permissions"></a>

A Amazon WorkMail usa a função vinculada ao serviço chamada — A **AmazonWorkMailEvents**Amazon WorkMail usa essa função vinculada ao serviço para permitir o acesso a AWS serviços e recursos usados ou gerenciados por eventos da Amazon, como monitorar WorkMail eventos de e-mail registrados por. CloudWatch Para obter mais informações sobre como habilitar o registro de eventos por e-mail para a Amazon WorkMail, consulte[Habilitar o registro de eventos de e-mail](tracking.md).

A função AmazonWorkMailEvents vinculada ao serviço confia nos seguintes serviços para assumir a função:
+ `events.workmail.amazonaws.com`

A política de permissões de função permite que WorkMail a Amazon conclua as seguintes ações nos recursos especificados:
+ Ação: `logs:CreateLogGroup` em `all AWS resources`
+ Ação: `logs:CreateLogStream` em `all AWS resources`
+ Ação: `logs:PutLogEvents` em `all AWS resources`

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um usuário, grupo ou função) crie, edite ou exclua um perfil vinculado a serviço. Para obter mais informações, consulte [Permissões de perfil vinculado a serviços](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) no *Guia do usuário do IAM*.

## Criação de uma função vinculada a serviços para a Amazon WorkMail
<a name="create-slr"></a>

Não é necessário criar manualmente um perfil vinculado ao serviço. Quando você ativa o registro de WorkMail eventos da Amazon e usa as configurações padrão no WorkMail console da Amazon, a Amazon WorkMail 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ê ativa o registro de WorkMail eventos da Amazon e usa as configurações padrão, a Amazon WorkMail cria a função vinculada ao serviço para você novamente. 

## Editando uma função vinculada ao serviço para a Amazon WorkMail
<a name="edit-slr"></a>

 WorkMail A Amazon não permite que você edite a função AmazonWorkMailEvents vinculada ao serviço. Depois que você criar um perfil vinculado ao serviço, não poderá alterar o nome do perfil, pois várias entidades podem fazer referência ao perfil. No entanto, você poderá editar a descrição do perfil usando o IAM. Para saber mais, consulte [Editar uma função vinculada a 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 uma função vinculada ao serviço para a Amazon WorkMail
<a name="delete-slr"></a>

Se você não precisar mais usar um recurso ou serviço que requer um perfil vinculado ao serviço, é recomendável excluí-lo. 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 de seu perfil vinculado ao serviço antes de excluí-lo manualmente.

**nota**  
Se o WorkMail serviço da Amazon 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 WorkMail recursos da Amazon usados por AmazonWorkMailEvents**

1. Desative o registro de WorkMail eventos da Amazon.

   1. Abra o WorkMail console da Amazon em [https://console.aws.amazon.com/workmail/](https://console.aws.amazon.com/workmail/).

      Se necessário, altere a AWS região. Na barra na parte superior da janela do console, abra a lista **Selecionar uma região** e escolha uma região. Para obter mais informações, consulte [Regiões e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) na *Referência geral da Amazon Web Services*.

   1. No painel de navegação, selecione **Organizações** e, em seguida, escolha o nome da organização.

   1. No painel de navegação, selecione **Configurações da organização** e, em seguida, escolha **Monitoramento**.

   1. Em **Log settings (Configurações de log)**, escolha **Edit (Editar)**.

   1. Mova o controle deslizante **Habilitar eventos de e-mail** para a posição desativado.

   1. Escolha **Salvar**.

1. Exclua o grupo de CloudWatch registros da Amazon.

   1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

   1. Escolha **Logs**.

   1. Em **Log Groups (Grupos de log)**, selecione os grupos para excluir.

   1. Em **Actions (Ações)**, escolha **Delete log group (Excluir grupo de registros)**.

   1. Selecione **Sim, excluir**.

**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 AmazonWorkMailEvents 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*.

## Regiões suportadas para funções vinculadas a WorkMail serviços da Amazon
<a name="slr-regions"></a>

A Amazon WorkMail oferece suporte ao uso de funções vinculadas a serviços em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte [ WorkMail Regiões e endpoints da Amazon](https://docs.aws.amazon.com/general/latest/gr/rande.html#wm_region).