

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon EventBridge AWS Support 를 사용하여 이벤트 기반 애플리케이션에 통합
<a name="eventbridge-integration"></a>

 AWS Support 에서 발생하는 이벤트를 사용하여 애플리케이션 구성 요소 간에 통신하고 다운스트림 프로세스를 시작하는 이벤트 기반 애플리케이션(EDAs)에 AWS Support 를 통합할 수 있습니다.

예를 들어 계정에서 다음 AWS Support 이벤트가 발생할 때마다 알림을 받을 수 있습니다.
+ 지원 사례가 생성되거나, 해결되거나, 다시 열림
+ 기존 지원 사례에 서신 추가

이렇게 하려면 Amazon EventBridge를 사용하여에서 다른 소프트웨어 구성 요소로 이벤트를 라우팅 AWS Support 합니다. Amazon EventBridge는 이벤트를 사용하여 애플리케이션 구성 요소를 함께 연결하는 서버리스 서비스이므로 추가 코드 및 작업 없이와 같은 AWS 서비스를 이벤트 기반 아키텍처 AWS Support 에 더 쉽게 통합할 수 있습니다.

## EventBridge가 AWS Support 이벤트를 라우팅하는 방법
<a name="eventbridge-routes-service-events-aws.support"></a>

EventBridge가 AWS Support 이벤트와 작동하는 방식은 다음과 같습니다.

많은 AWS 서비스와 마찬가지로는 이벤트를 AWS Support 생성하고 EventBridge 기본 *이벤트 버스*로 전송합니다. 이벤트 버스는 이벤트를 수신하여 지정한 목적지 또는 *대상*으로 라우팅하는 라우터입니다. 대상에는 다른 AWS 서비스, 사용자 지정 애플리케이션 및 SaaS 파트너 애플리케이션이 포함될 수 있습니다.

EventBridge는 사용자가 이벤트 버스에서 생성한 *규칙*에 따라 이벤트를 라우팅합니다. 각 규칙마다 필터 또는 *이벤트 패턴*을 지정하여 원하는 이벤트만 선택할 수 있습니다. 이벤트가 이벤트 버스로 전송될 때마다 EventBridge는 이벤트를 각 규칙과 비교합니다. 이벤트가 규칙과 일치하면 EventBridge는 이벤트를 지정된 대상으로 라우팅합니다.

![\[AWS 서비스는 EventBridge 기본 이벤트 버스로 이벤트를 전송합니다. 이벤트가 규칙의 이벤트 패턴과 일치하면 EventBridge는 해당 규칙에 지정된 대상으로 이벤트를 라우팅합니다.\]](http://docs.aws.amazon.com/ko_kr/awssupport/latest/user/images/eventbridge-integration-how-it-works.png)


## AWS Support 이벤트
<a name="supported-events"></a>

AWS Support 는 다음 이벤트를 기본 EventBridge 이벤트 버스로 자동으로 전송합니다.


| 이벤트 세부 정보 유형 | 설명 | 
| --- | --- | 
|  [지원 사례 업데이트](event-detail-support-case-update.md)  |  지원 사례의 변경 사항을 나타냅니다.  | 

### 이벤트 구조
<a name="eventbridge-event-structure"></a>

 AWS 서비스의 모든 이벤트에는 두 가지 유형의 데이터가 포함됩니다.
+ 이벤트의 소스인 AWS 서비스, 이벤트가 생성된 시간, 이벤트가 발생한 계정 및 리전 등 이벤트에 대한 메타데이터가 포함된 공통 필드 세트입니다. 이러한 일반 필드의 정의는 *Amazon EventBridge 이벤트 참조*의 [이벤트 구조](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)를 참조하세요.
+ 해당 특정 서비스 이벤트와 관련된 데이터를 포함한 `detail` 필드.

### AWS Support 를 통한 이벤트 전송 AWS CloudTrail
<a name="eventbridge-events-via-cloudtrail"></a>

AWS 서비스는 이벤트를 EventBridge 기본 이벤트 버스로 직접 전송할 수 있습니다. 또한는 수많은 AWS 서비스에서 시작된 이벤트도 EventBridge로 AWS CloudTrail 전송합니다. 이러한 이벤트에는 API 직접 호출, 콘솔 로그인 및 작업, 서비스 이벤트, CloudTrail Insights가 포함될 수 있습니다. 자세한 내용은 *EventBridge 사용 설명서*의 [AWS CloudTrail을 통해 전달되는AWS 서비스 이벤트](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html)를 참조하세요.

EventBridge로 전송된 AWS Support 이벤트 목록은 [https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html) 참조의 AWS Support 주제를 참조하세요.

## 이벤트와 일치하는 AWS Support 이벤트 패턴 생성
<a name="eventbridge-event-delivery-filter"></a>

이벤트 패턴은 선택하려는 이벤트에 있어야 하는 데이터를 지정하는 필터입니다.

각 이벤트 패턴은 다음을 포함하는 JSON 객체입니다.
+ 이벤트를 전송하는 서비스를 식별하는 `source` 속성입니다. AWS Support 이벤트의 경우 소스는 입니다`aws.support`.
+ (선택 사항): 일치해야 하는 이벤트 이름의 배열을 포함하는 `detail-type` 속성.
+ (선택 사항): 일치시킬 다른 이벤트 데이터를 포함하는 `detail` 속성입니다.

예를 들어 다음 이벤트 패턴은 AWS Support의 모든 지원 사례 업데이트 이벤트를 선택합니다.

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

이벤트 자체에 값을 포함하면 이벤트를 더 구체적으로 선택할 수 있습니다. 예를 들어 다음 이벤트 패턴은 다시 열리는 사례를 나타내는 지원 사례 업데이트 이벤트와 일치합니다.

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

이벤트 작성에 대한 자세한 내용은 *EventBridge 사용 설명서*의 [이벤트 패턴](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)을 참조하세요.

### 다음 사항도 참조하세요.
<a name="see-also-eventbridge-support"></a>

에서 EventBridge를 사용하는 방법에 대한 자세한 내용은 다음 리소스를 AWS Support참조하세요.
+ [Amazon EventBridge를 사용하여 AWS Support API를 자동화하는 방법](https://aws.amazon.com/blogs/mt/how-to-automate-aws-support-api-with-amazon-eventbridge)
+ GitHub의 [AWS Support 사례 활동 알림](https://github.com/aws-samples/aws-support-case-activity-notifier) 

# 지원 사례 업데이트 이벤트
<a name="event-detail-support-case-update"></a>

다음은 `Support Case Update` 이벤트의 세부 정보 필드입니다.

`source` 및 `detail-type` 필드는 AWS Support 이벤트에 대한 특정 값을 포함하므로 아래에 포함되어 있습니다. 모든 이벤트에 포함된 다른 메타데이터 필드의 정의는 *Amazon EventBridge 이벤트 참조*의 [이벤트 구조](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)를 참조하세요.

```
{
  . . .,
  "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>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Support Case Update`입니다.

`source`  <a name="support-case-update-source"></a>
이벤트를 생성한 서비스를 식별합니다. AWS Support 이벤트의 경우이 값은 입니다`aws.support`.

`detail`  <a name="support-case-update-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`case-id`  <a name="support-case-update-case-id"></a>
지원 사례 ID. 사례 ID는 case-*12345678910-2013-c4c1d2bf33c5cf47* 형식의 영숫자 문자열입니다.  
`display-id`  <a name="support-case-update-display-id"></a>
 AWS Support 센터의 페이지에 있는 사례의 식별자입니다.  
`communication-id`  <a name="support-case-update-communication-id"></a>
통신 ID.  
`event-name`  <a name="support-case-update-event-name"></a>
*유효한 값*: `CreateCase` \$1 `AddCommunicationToCase` \$1 `ResolveCase` \$1 `ReopenCase`  
지원 사례 이벤트의 유형을 지정합니다.  
`origin`  <a name="support-case-update-origin"></a>
유효한 값**: `AWS` \$1 `CUSTOMER`  
사용자 또는 AWS Support 에이전트가 지원 사례에 사례 대응 서신을 추가했는지 여부를 지정합니다.  
현재는 `event-name`이 `AddCommunicationToCase`인 이벤트만 이 값을 갖습니다.

**Example 지원 사례 업데이트 이벤트 예제: 지원 사례 생성됨**  <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 지원 사례 업데이트 이벤트 예제:지원 사례에 대한 AWS Support 회신**  <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 지원 사례 업데이트 이벤트 예제: 지원 사례 해결됨**  <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 지원 사례 업데이트 이벤트 예제: 지원 사례 다시 열림**  <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": ""
    }
}
```