# Como trabalhar com esquemas do Amazon EventBridge
<a name="eventbridge-schemas"></a>

Você pode usar o AWS Toolkit for JetBrains para trabalhar com esquemas do Amazon EventBridge, conforme descrito a seguir.

**nota**  
Atualmente, há suporte para trabalhar com esquemas do EventBridge apenas pelo AWS Toolkit para IntelliJ e pelo AWS Toolkit para PyCharm.

As informações a seguir supõem que você já [configurou o AWS Toolkit for JetBrains](getting-started.md).

**Contents**
+ [Visualizar um esquema](#eventbridge-schemas-view)
+ [Localizar um esquema](#eventbridge-schemas-find)
+ [Gerar código para um esquema](#eventbridge-schemas-generate-code)
+ [Criar uma aplicação do AWS SAM que use um esquema](#eventbridge-schemas-serverless-app)

## Visualizar um esquema disponível
<a name="eventbridge-schemas-view"></a>

1. Com a janela de ferramentas do [**AWS Explorer**](aws-explorer.md) exibida, expanda **Schemas (Esquemas)**.

1. Expanda o nome do registro que contém o esquema que deseja visualizar. Por exemplo, muitos dos esquemas que a AWS oferece estão no registro **aws.events**.

1. Para exibir o esquema no editor, clique com o botão direito do mouse no título do esquema e, no menu de contexto, escolha o **View Schema (Exibir esquema)**. 

## Localizar um esquema disponível
<a name="eventbridge-schemas-find"></a>

Com a janela de ferramentas [**AWS Explorer**](aws-explorer.md)exibida, execute um dos seguintes procedimentos:
+ Comece a digitar o título do esquema que deseja encontrar. O **AWS Explorer** destaca os títulos de esquemas que contêm uma correspondência.
+ Clique com o botão direito do mouse em **Schemas (Esquemas)**, e, no menu de contexto, escolha **Search Schemas (Pesquisar esquemas)**. Na caixa de diálogo **Pesquisar esquemas do EventBridge**, comece a digitar o título do esquema que deseja encontrar. A caixa de diálogo exibe os títulos do esquema que contêm uma correspondência.
+ Expanda **Schemas (Esquemas)**. Clique com o botão direito do mouse no nome do registro que contém o esquema que deseja encontrar e escolha **Search Schemas in Registry (Pesquisar esquemas no registro)**. Na caixa de diálogo **Pesquisar esquemas do EventBridge**, comece a digitar o título do esquema que deseja encontrar. A caixa de diálogo exibe os títulos do esquema que contêm uma correspondência.

Para exibir um esquema na lista de correspondências, execute um dos procedimentos a seguir:
+ Para exibir o esquema no editor, no **AWS Explorer**, clique com o botão direito do mouse no título do esquema e escolha **View Schema (Exibir esquema)**. 
+ Na caixa de diálogo **Pesquisar esquemas do EventBridge**, escolha o título do esquema para exibi-lo. 

## Gerar código para um esquema disponível
<a name="eventbridge-schemas-generate-code"></a>

1. Com a janela de ferramentas do [**AWS Explorer**](aws-explorer.md) exibida, expanda **Schemas (Esquemas)**.

1. Expanda o nome do registro que contém o esquema para o qual deseja gerar o código.

1. Clique com o botão direito no título do esquema e escolha **Download code bindings (Fazer download de vinculações de códigos)**.

1. Na caixa de diálogo **Download code bindings (Transferir associações de código)**, escolha o seguinte:
   + A **Version (Versão)** do esquema para o qual o código será gerado.
   + A **Language (Linguagem)** de programação e a versão de idioma compatíveis para a qual o código será gerado.
   + O **File location (Local do arquivo)** onde o código gerado na máquina de desenvolvimento local deverá ser armazenado.

1. Escolha **Download**.

## Criar uma aplicação do AWS Serverless Application Model que use um esquema disponível
<a name="eventbridge-schemas-serverless-app"></a>

1. No menu **File (Arquivo)**, escolha **New (Novo) **, **Project (Projeto)**. 

1. Na caixa de diálogo **New Project (Novo projeto)**, escolha**AWS**.

1. Selecione **AWS Serverless Application** e, a seguir, escolha **Next (Próximo)**.

1. Especifique o seguinte:
   + Um **Project name (Nome de projeto)** para o projeto.
   + Um **Project location (Local do projeto)** em sua máquina de desenvolvimento local para o projeto.
   + Um **Runtime** do AWS Lambda compatível para o projeto.
   + Um **Modelo do SAM** AWS Serverless Application Model (AWS SAM) para o projeto. Atualmente, as opções incluem o seguinte:
     + **AWS SAM EventBridge Hello World (EC2 Instance State Change) **: quando implantado, cria uma função do AWS Lambda e um endpoint do Amazon API Gateway associado em sua conta da AWS. Por padrão, essa função e o endpoint respondem somente a uma alteração de status da instância do Amazon EC2.
     + **AWS SAM EventBridge App from Scratch (para qualquer trigger de evento de um registro de esquema)**: quando implantado, cria uma função do AWS Lambda e um endpoint do Amazon API Gateway associado em sua conta da AWS. Essa função e endpoint podem responder a eventos que estão disponíveis no esquema que for especificado.

       Se escolher esse modelo, você também deverá especificar o seguinte:
       + O perfil com nome, **Credentials (Credenciais)**, a ser usado.
       + A **região** da AWS a ser usada.
       + O **Esquema de evento** do EventBridge a ser usado.
   + A versão do SDK a ser usada para o projeto (**Project SDK (SDK do projeto)**).

Depois de criar um projeto de aplicativo sem servidor da AWS, você pode fazer o seguinte:
+ [Implantar o aplicativo](sam-sync.md)
+ [Alterar (atualizar) as configurações do aplicativo](sam-update.md)
+ [Excluir o aplicativo implantado](sam-delete.md)

Você também pode fazer o seguinte com funções do Lambda que fazem parte da aplicação:
+ [Executar (chamar) ou depurar a versão local de uma função](invoke-lambda.md)
+ [Executar (chamar) a versão remota de uma função](lambda-remote.md)
+ [Alterar as configurações de uma função](lambda-update.md)
+ [Excluir uma função](lambda-delete.md)