

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 descoberta de esquemas na Amazon EventBridge
<a name="using-service-linked-roles-service-action-2"></a>

O tópico a seguir detalha o uso da função ****AWSServiceRoleForSchemas****vinculada ao serviço.

## Permissões de função vinculadas ao serviço para EventBridge
<a name="service-linked-role-permissions-service-action-2"></a>

EventBridge usa a função vinculada ao serviço chamada ****AWSServiceRoleForSchemas****— Concede permissões às regras gerenciadas criadas por Amazon EventBridge esquemas.

O perfil vinculado ao serviço **AWSServiceRoleForSchemas** confia nos seguintes serviços para aceitar o perfil:
+ `schemas.amazonaws.com`

A política de permissões de função nomeada ****AmazonEventBridgeSchemasServiceRolePolicy**** EventBridge permite concluir as seguintes ações nos recursos especificados:
+ Ação: `put, enable, disable, and delete rules; put and remove targets; list targets per rule` em `all managed rules created by EventBridge`

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

## Criação de uma função vinculada ao serviço para EventBridge
<a name="create-service-linked-role-service-action-2"></a>

Não é necessário criar manualmente um perfil vinculado ao serviço. Quando você conduz uma descoberta de esquema na Console de gerenciamento da AWS, na ou na AWS API AWS CLI, EventBridge cria a função vinculada ao serviço para você. 

**Importante**  
 Esse perfil vinculado ao serviço pode aparecer em sua conta se você concluiu uma ação em outro serviço que usa os atributos compatíveis com esse perfil. Se você estava usando o EventBridge serviço antes de 27 de novembro de 2019, quando ele começou a oferecer suporte a funções vinculadas ao serviço, EventBridge criou a **AWSServiceRoleForSchemas**função em sua conta. Para saber mais, consulte [Uma nova função apareceu no meu Conta da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared).

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ê conduz uma descoberta de esquema, EventBridge cria a função vinculada ao serviço para você novamente. 

## Editando uma função vinculada ao serviço para EventBridge
<a name="edit-service-linked-role-service-action-2"></a>

EventBridge não permite que você edite a função **AWSServiceRoleForSchemas**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 uma função vinculada ao serviço para EventBridge
<a name="delete-service-linked-role-service-action-2"></a>

Se você não precisar mais usar um atributo ou serviço que requer uma função vinculada a serviço, é recomendável excluí-la. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar suo perfil vinculado ao serviço para excluí-la manualmente.

### Limpar um perfil vinculado ao serviço
<a name="service-linked-role-review-before-delete-service-action-2"></a>

Antes de usar o IAM para excluir um perfil vinculado ao serviço, você deverá excluir qualquer recurso usado pelo perfil.

**nota**  
Se o EventBridge 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 EventBridge recursos usados pelo **AWSServiceRoleForSchemas**(console)**

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

1. Em **Barramentos**, selecione **Barramentos de eventos** e escolha um barramento de eventos.

1. Selecione **Interromper descoberta**.

**Para excluir EventBridge recursos usados pela **AWSServiceRoleForSchemas**(AWS CLI)**
+ Use o seguinte comando: `[delete-discoverer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/events/delete-discoverer.html)`.

**Para excluir EventBridge recursos usados pela **AWSServiceRoleForSchemas**(API)**
+ Use o seguinte comando: `[DeleteDiscoverer](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers-id-discovererid.html#DeleteDiscoverer)`.

### Excluir manualmente o perfil vinculado ao serviço
<a name="slr-manual-delete-service-action-2"></a>

Use o console do IAM AWS CLI, o ou a AWS API para excluir a função **AWSServiceRoleForSchemas**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 EventBridge serviços
<a name="slr-regions-service-action-2"></a>

EventBridge suporta o uso de funções vinculadas ao serviço em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).