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á.
# Integração com aplicativos AWS Support orientados a eventos usando a Amazon EventBridge
Você pode AWS Support incorporar aplicativos orientados a eventos (EDAs) que usam eventos que ocorrem AWS Support para se comunicar entre os componentes do aplicativo e iniciar processos posteriores.
Por exemplo, você pode ser notificado sempre que os seguintes AWS Support eventos ocorrerem em sua conta:
+ Um caso de suporte é criado, resolvido ou reaberto
+ Uma correspondência é adicionada a um caso de suporte existente
Você faz isso usando EventBridge a Amazon para rotear eventos de AWS Support outros componentes de software. EventBridge A Amazon é um serviço sem servidor que usa eventos para conectar componentes do aplicativo, facilitando a integração de AWS serviços, como AWS Support em arquiteturas orientadas por eventos, sem código e operações adicionais.
## Como EventBridge roteia AWS Support eventos
Veja como EventBridge funciona com AWS Support eventos:
Como acontece com muitos AWS serviços, AWS Support gera e envia eventos para o *barramento de eventos EventBridge * padrão. Um barramento de eventos é um roteador que recebe eventos e os roteia para *destinos* que você especifica. Os destinos podem incluir outros AWS serviços, aplicativos personalizados e aplicativos SaaS de parceiros.
EventBridge roteia os eventos de acordo com *as regras* que você cria no ônibus do evento. Para cada regra, você especifica um filtro, ou um *padrão de evento*, para selecionar apenas os eventos desejados. Sempre que um evento é enviado para o barramento de eventos, EventBridge compare-o com cada regra. Se o evento corresponder à regra, EventBridge roteará o evento para o (s) destino (s) especificado (s).
![\[AWS os serviços enviam eventos para o barramento de eventos EventBridge padrão. Se o evento corresponder ao padrão de eventos de uma regra, EventBridge roteia o evento para os destinos especificados para essa regra.\]](http://docs.aws.amazon.com/pt_br/awssupport/latest/user/images/eventbridge-integration-how-it-works.png)
## AWS Support eventos
AWS Support envia automaticamente os seguintes eventos para o barramento de EventBridge eventos padrão.
| Tipo de detalhe de evento | Description |
| --- | --- |
| [Atualização de caso de suporte](event-detail-support-case-update.md) | Representa uma mudança em um caso de suporte. |
### Estrutura de eventos
Todos os eventos dos AWS serviços contêm dois tipos de dados:
+ Um conjunto comum de campos contendo metadados sobre o evento, como o AWS serviço que é a origem do evento, a hora em que o evento foi gerado, a conta e a região em que o evento ocorreu e outros. Para obter definições desses campos gerais, consulte [Estrutura de eventos na Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *Reference*.
+ Um campo `detail` que contém dados específicos para esse evento de serviço específico.
### AWS Support entrega de eventos via AWS CloudTrail
AWS os serviços podem enviar eventos diretamente para o barramento de eventos EventBridge padrão. Além disso, também AWS CloudTrail envia eventos provenientes de vários AWS serviços. EventBridge Esses eventos podem incluir chamadas de API, logins e ações do console, eventos de serviço e CloudTrail Insights. Para obter mais informações, consulte [os eventos de AWS serviço fornecidos AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html) no *Guia EventBridge do usuário*.
Para obter uma lista de AWS Support eventos enviados para EventBridge, consulte o AWS Support tópico na [https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html).
## Criação de padrões de eventos que correspondam aos AWS Support eventos
Padrões de eventos são filtros que especificam os dados que os eventos que você deseja selecionar devem conter.
Cada padrão de evento é um objeto JSON que contém:
+ Um atributo `source` que identifica o serviço que envia o evento. Para AWS Support eventos, a fonte é`aws.support`.
+ (Opcional): um atributo `detail-type` que contém uma matriz dos nomes de eventos a serem correlacionados.
+ (Opcional): um atributo `detail` que contém quaisquer outros dados relacionados aos eventos a serem correlacionados.
Por exemplo, o padrão de evento a seguir seleciona todos os eventos de atualização de casos de suporte do AWS Support:
```
{
"source": ["aws.support"],
"detail-type": ["Support Case Update"]
}
```
Você pode ser mais específico na sua seleção de eventos incluindo valores no próprio evento. Por exemplo, o padrão de evento a seguir corresponde a eventos de atualização de casos de suporte que representam um caso que está sendo reaberto:
```
{
"source": ["aws.support"],
"detail-type": ["Support Case Update"],
"detail": {
"event-name": "ReopenCase"
}
}
```
Para obter mais informações sobre como escrever padrões de eventos, consulte [Padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) no *Guia do usuário do EventBridge *.
### Consulte também
Para obter mais informações sobre como usar EventBridge com AWS Support, consulte os seguintes recursos:
+ [Como automatizar a AWS Support API com a Amazon EventBridge](https://aws.amazon.com/blogs/mt/how-to-automate-aws-support-api-with-amazon-eventbridge)
+ [AWS Support notificador de atividade de caso](https://github.com/aws-samples/aws-support-case-activity-notifier) em GitHub
# Evento de atualização de caso de suporte
Abaixo estão os campos de detalhes do evento `Support Case Update`.
Os `detail-type` campos `source` e estão incluídos abaixo porque contêm valores específicos para AWS Support eventos. Para obter definições dos outros campos de metadados que estão incluídos em todos os eventos, consulte [Estrutura de eventos na Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *Reference*.
```
{
. . .,
"detail-type": "Support Case Update",
"source": "aws.support",
. . .,
"detail": {
"case-id" : "string",
"display-id" : "string",
"communication-id" : "string",
"event-name" : "string",
"origin" : "string"
}
}
```
`detail-type`
Identifica o tipo de evento.
Para esse evento, esse valor é `Support Case Update`.
`source`
Identifica o serviço que gerou o evento. Para AWS Support eventos, esse valor é`aws.support`.
`detail`
Um objeto JSON contém informações sobre o evento. O serviço que gera o evento determina o conteúdo desse campo.
Para esse evento, esses dados incluem:
`case-id`
O ID do caso de suporte. O ID do caso é uma string alfanumérica neste formato: case-*12345678910-2013-c4c1d2bf33c5cf47*.
`display-id`
O identificador da caixa nas páginas do AWS Support Centro.
`communication-id`
O ID da comunicação.
`event-name`
*Valores válidos*: `CreateCase` \$1 `AddCommunicationToCase` \$1 `ResolveCase` \$1 `ReopenCase`
Especifica o tipo de evento de caso de suporte.
`origin`
*Valores válidos*: `AWS` \$1 `CUSTOMER`
Especifica se você ou um AWS Support agente adicionaram uma correspondência de caso a um caso de suporte.
Atualmente, somente eventos com `event-name` de `AddCommunicationToCase` terão esse valor.
**Example Exemplo de evento de Atualização de caso de suporte: caso de suporte criado**
```
{
"version": "0",
"id": "3433df007-9285-55a3-f6d1-536944be45d7",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:51:19Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2022-7118885805350839",
"display-id": "1234563851",
"communication-id": "",
"event-name": "CreateCase",
"origin": ""
}
}
```
**Example Exemplo de evento de atualização de caso de suporte: AWS Support respostas a um caso de suporte**
```
{
"version": "0",
"id": "f90cb8cb-32be-1c91-c0ba-d50b4ca5e51b",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:51:31Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2022-7118885805350839",
"display-id": "1234563851",
"communication-id": "ekko:us-east-1:12345678-268a-424b-be08-54613cab84d2",
"event-name": "AddCommunicationToCase",
"origin": "AWS"
}
}
```
**Example Exemplo de evento de Atualização de caso de suporte: caso de suporte resolvido**
```
{
"version": "0",
"id": "1aa4458d-556f-732e-ddc1-4a5b2fbd14a5",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:51:31Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2022-7118885805350839",
"display-id": "1234563851",
"communication-id": "",
"event-name": "ResolveCase",
"origin": ""
}
}
```
**Example Exemplo de evento de Atualização de caso de suporte: caso de suporte reaberto**
```
{
"version": "0",
"id": "3bb9d8fe-6089-ad27-9508-804209b233ad",
"detail-type": "Support Case Update",
"source": "aws.support",
"account": "111122223333",
"time": "2022-02-21T15:47:19Z",
"region": "us-east-1",
"resources": [],
"detail": {
"case-id": "case-111122223333-muen-2021-27f40618fe0303ea",
"display-id": "1234563851",
"communication-id": "",
"event-name": "ReopenCase",
"origin": ""
}
}
```