

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Integración AWS Support en aplicaciones basadas en eventos mediante Amazon EventBridge
<a name="eventbridge-integration"></a>

Puede AWS Support incorporarlas en aplicaciones basadas en eventos (EDAs) que utilizan los eventos que se producen AWS Support para comunicarse entre los componentes de la aplicación e iniciar procesos posteriores. 

Por ejemplo, puede recibir una notificación cada vez que se produzcan los siguientes AWS Support eventos en su cuenta:
+ Se crea, resuelve o vuelve a abrir un caso de soporte
+ Se agrega una correspondencia a un caso de soporte existente

Para ello, utiliza Amazon EventBridge para enrutar eventos desde AWS Support otros componentes de software. Amazon EventBridge es un servicio sin servidor que utiliza eventos para conectar los componentes de la aplicación entre sí, lo que facilita la integración de AWS servicios, por ejemplo, en arquitecturas basadas AWS Support en eventos sin código ni operaciones adicionales.

## EventBridge ¿ AWS Support Cómo direcciona los eventos
<a name="eventbridge-routes-service-events-aws.support"></a>

Así es como EventBridge funciona con AWS Support los eventos:

Como ocurre con muchos AWS servicios, AWS Support genera y envía eventos al *bus de eventos EventBridge * predeterminado. Un bus de eventos es un enrutador que recibe eventos y los envía a destinos u *objetivos*, que se especifican. Los objetivos pueden incluir otros AWS servicios, aplicaciones personalizadas y aplicaciones de socios de SaaS. 

EventBridge enruta los eventos de acuerdo con *las reglas* que usted crea en el bus de eventos. Para cada regla, se debe especificar un filtro o *patrón de eventos* para seleccionar solo los eventos que desee. Cada vez que se envía un evento al bus de eventos, lo EventBridge compara con cada regla. Si el evento coincide con la regla, lo EventBridge enruta a los objetivos especificados.

![\[AWS los servicios envían los eventos al bus de eventos EventBridge predeterminado. Si el evento coincide con el patrón de eventos de una regla, EventBridge enruta el evento a los destinos especificados para esa regla.\]](http://docs.aws.amazon.com/es_es/awssupport/latest/user/images/eventbridge-integration-how-it-works.png)


## AWS Support eventos
<a name="supported-events"></a>

AWS Support envía automáticamente los siguientes eventos al bus de EventBridge eventos predeterminado.


| Tipo de detalle del evento | Description (Descripción) | 
| --- | --- | 
|  [Actualización de caso de soporte](event-detail-support-case-update.md)  |  Representa un cambio en un caso de soporte.  | 

### Estructura de evento
<a name="eventbridge-event-structure"></a>

Todos los eventos de AWS los servicios contienen dos tipos de datos:
+ Un conjunto común de campos que contiene metadatos sobre el evento, como el AWS servicio que lo origina, la hora en que se generó el evento, la cuenta y la región en las que tuvo lugar el evento, etc. Para ver las definiciones de estos campos generales, consulte [Estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) en la *referencia de Amazon EventBridge Events*. 
+ Un campo `detail` que contiene los datos específicos de ese evento en particular. 

### AWS Support entrega de eventos a través de AWS CloudTrail
<a name="eventbridge-events-via-cloudtrail"></a>

AWS los servicios pueden enviar los eventos directamente al bus de eventos EventBridge predeterminado. Además, también AWS CloudTrail envía eventos que se originan en EventBridge numerosos AWS servicios. Estos eventos pueden incluir llamadas a la API, inicios de sesión y acciones en la consola, eventos de servicio e CloudTrail Insights. Para obtener más información, consulte [los eventos AWS de servicio que se ofrecen AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html) en la *Guía del EventBridge usuario*. 

Para obtener una lista de AWS Support los eventos enviados a EventBridge, consulte el AWS Support tema de la [https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html).

## Crear patrones de eventos que coincidan con AWS Support los eventos
<a name="eventbridge-event-delivery-filter"></a>

Los patrones de eventos son filtros que especifican los datos que deben tener los eventos que desea seleccionar.

Cada patrón de eventos es un objeto JSON que contiene:
+ Un atributo `source` que identifica el servicio que envía el evento. En el AWS Support caso de los eventos, la fuente es`aws.support`.
+ (Opcional): un atributo `detail-type` que contiene una matriz de los nombres de eventos que deben coincidir.
+ (Opcional): un atributo `detail` que contiene cualquier otro dato de evento con el que coincidir.

Por ejemplo, el siguiente patrón de eventos seleccionaría todos los eventos de Actualización de un caso de soporte de AWS Support:

```
{
  "source": ["aws.support"],
  "detail-type": ["Support Case Update"]
}
```

Para ser más específico en la selección de eventos, se pueden incluir valores en el propio evento. Por ejemplo, el siguiente patrón de eventos coincide con los eventos de Actualización de caso de soporte que representan la reapertura de un caso:

```
{
  "source": ["aws.support"],
  "detail-type": ["Support Case Update"],
  "detail": {
      "event-name": "ReopenCase"
    }
}
```

Para obtener más información sobre la escritura de los patrones de eventos, consulte [Patrones de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) en la *Guía del usuario de EventBridge *.

### Véase también
<a name="see-also-eventbridge-support"></a>

Para obtener más información sobre cómo usarlo EventBridge con AWS Support, consulta los siguientes recursos: 
+ [Cómo automatizar la AWS Support API con Amazon EventBridge](https://aws.amazon.com/blogs/mt/how-to-automate-aws-support-api-with-amazon-eventbridge)
+ [AWS Support notificador de actividad de casos](https://github.com/aws-samples/aws-support-case-activity-notifier) en GitHub

# Evento Actualización de caso de soporte
<a name="event-detail-support-case-update"></a>

A continuación, se muestran los campos de detalle del evento `Support Case Update`.

Los `detail-type` campos `source` y se incluyen a continuación porque contienen valores específicos para los AWS Support eventos. Para ver las definiciones de los demás campos de metadatos que se incluyen en todos los eventos, consulte [Estructura de eventos](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) en la *referencia de Amazon EventBridge Events*.

```
{
  . . .,
  "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`  <a name="support-case-update-detail-type"></a>
Identifica el tipo de evento.  
Para este evento, este valor es `Support Case Update`.

`source`  <a name="support-case-update-source"></a>
Identifica el servicio que generó el evento. Para AWS Support los eventos, este valor es`aws.support`.

`detail`  <a name="support-case-update-detail"></a>
Un objeto JSON que contiene información sobre el evento. El servicio que genera el evento determina el contenido de este campo.  
Para este evento, estos datos incluyen lo siguiente:    
`case-id`  <a name="support-case-update-case-id"></a>
El identificador del caso de soporte. El identificador de caso es una cadena alfanumérica con el siguiente formato: case-*12345678910-2013-c4c1d2bf33c5cf47*.  
`display-id`  <a name="support-case-update-display-id"></a>
El identificador del caso en las páginas del AWS Support Centro.  
`communication-id`  <a name="support-case-update-communication-id"></a>
El identificador de la comunicación.  
`event-name`  <a name="support-case-update-event-name"></a>
*Valores válidos*: `CreateCase` \$1 `AddCommunicationToCase` \$1 `ResolveCase` \$1 `ReopenCase`  
Especifica el tipo de evento de caso de soporte.  
`origin`  <a name="support-case-update-origin"></a>
*Valores válidos*: `AWS` \$1 `CUSTOMER`  
Especifica si usted o un AWS Support agente agregaron la correspondencia de un caso a un caso de soporte.  
Actualmente, solo los eventos con un `event-name` de `AddCommunicationToCase` tendrán este valor.

**Example Ejemplo de evento de actualización de caso de soporte: caso de soporte creado**  <a name="event-detail-support-case-update.example-1"></a>

```
{
    "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 Ejemplo de evento Support Case Update: AWS Support respuestas a un caso de soporte**  <a name="event-detail-support-case-update.example-2"></a>

```
{
    "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 Ejemplo de evento de actualización de caso de soporte: caso de soporte resuelto**  <a name="event-detail-support-case-update.example-3"></a>

```
{
    "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 Ejemplo de evento de actualización de caso de soporte: caso de soporte reabierto**  <a name="event-detail-support-case-update.example-4"></a>

```
{
    "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": ""
    }
}
```