

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

# 를 사용하여 Deadline Cloud 이벤트 관리 Amazon EventBridge
<a name="eventbridge-integration"></a>

Amazon EventBridge 는 이벤트를 사용하여 애플리케이션 구성 요소를 함께 연결하는 서버리스 서비스이므로 확장 가능한 이벤트 기반 애플리케이션을 더 쉽게 구축할 수 있습니다. 이벤트 기반 아키텍처는 이벤트를 내보내고 이에 응답하여 함께 작동하는 느슨하게 결합된 소프트웨어 시스템을 구축하는 스타일입니다. 이벤트는 리소스나 환경의 변화를 나타냅니다.

작동 방식은 다음과 같습니다.

많은 AWS 서비스와 마찬가지로 Deadline Cloud는 이벤트를 생성하고 EventBridge 기본 이벤트 버스로 전송합니다. (기본 이벤트 버스는 모든 AWS 계정에 자동으로 프로비저닝됩니다.) 이벤트 버스는 이벤트를 수신하여 0개 이상의 목적지 또는 **대상에 전달하는 라우터입니다. 이벤트 버스에 대해 지정한 규칙은 이벤트가 도착할 때 이벤트를 평가합니다. 각 규칙은 이벤트가 규칙의 **이벤트 패턴과 일치하는지 여부를 확인합니다. 이벤트가 일치하면 이벤트 버스는 이벤트를 지정된 대상에게 전송합니다.

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


**Topics**
+ [Deadline Cloud 이벤트](#supported-events)
+ [EventBridge 규칙을 사용하여 Deadline Cloud 이벤트 전달](#eventbridge-using-events-rules)
+ [Deadline Cloud 이벤트 세부 정보 참조](events-detail-reference.md)

## Deadline Cloud 이벤트
<a name="supported-events"></a>

Deadline Cloud는 다음 이벤트를 기본 EventBridge 이벤트 버스로 자동으로 전송합니다. 규칙의 이벤트 패턴과 일치하는 이벤트는 [ 최대한](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-delivery-level) 지정된 대상으로 전달됩니다. 이벤트는 비순차적으로 전달될 수 있습니다.

자세한 내용을 알아보려면 *Amazon EventBridge 사용 설명서*의 [EventBridge 이벤트](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)를 참조하세요.


| 이벤트 세부 정보 유형 | 설명 | 
| --- | --- | 
|  [예산 임계값 도달](events-detail-reference.md#event-detail-budget-threshold-reached)  |  대기열이 할당된 예산의 백분율에 도달하면 전송됩니다. | 
|  [작업 수명 주기 상태 변경](events-detail-reference.md#event-detail-job-lifecycle-status-change)  |   작업의 수명 주기 상태가 변경될 때 전송됩니다. | 
|  [작업 실행 상태 변경](events-detail-reference.md#event-detail-job-run-status-change)  |  작업 내 작업의 전체 상태가 변경될 때 전송됩니다. | 
|  [단계 수명 주기 상태 변경](events-detail-reference.md#event-detail-step-lifecycle-status-change)  |  작업에서 단계의 수명 주기 상태가 변경될 때 전송됩니다. | 
|  [단계 실행 상태 변경](events-detail-reference.md#event-detail-step-run-status-change)  |  단계에서 작업의 전체 상태가 변경될 때 전송됩니다. | 
|  [작업 실행 상태 변경](events-detail-reference.md#event-detail-task-run-status-change)  |  작업 상태가 변경될 때 전송됩니다. | 

## EventBridge 규칙을 사용하여 Deadline Cloud 이벤트 전달
<a name="eventbridge-using-events-rules"></a>

 EventBridge 기본 이벤트 버스가 Deadline Cloud 이벤트를 대상으로 보내도록 하려면 규칙을 생성해야 합니다. 각 규칙에는 이벤트 버스에서 수신된 각 이벤트와 EventBridge 일치하는 이벤트 패턴이 포함되어 있습니다. 이벤트 데이터가 지정된 이벤트 패턴과 일치하는 경우는 해당 이벤트를 규칙의 대상(들)에 EventBridge 전달합니다.

이벤트 버스 규칙 생성에 대해 자세히 알아보려면 **EventBridge 사용 설명서의 [이벤트에 대응하는 규칙 생성](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)을 참조하세요.

### Deadline Cloud 이벤트와 일치하는 이벤트 패턴 생성
<a name="eventbridge-using-events-rules-patterns"></a>

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

예를 들어 다음 이벤트 패턴은 Deadline Cloud`farmId`에 지정된에 대한 모든 플릿 크기 권장 변경 이벤트와 일치합니다.

```
{
  "source": ["aws.deadline"],
  "detail-type": ["Fleet Size Recommendation Change"],
  "detail": {
     "farmId": "farm-12345678900000000000000000000000"
  }
}
```

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

# Deadline Cloud 이벤트 세부 정보 참조
<a name="events-detail-reference"></a>

 AWS 서비스의 모든 이벤트에는 이벤트의 소스인 AWS 서비스, 이벤트가 생성된 시간, 이벤트가 발생한 계정 및 리전 등 이벤트에 대한 메타데이터가 포함된 공통 필드 세트가 있습니다. 이러한 일반 필드에 대한 정의는 **Amazon EventBridge 사용 설명서의 [이벤트 구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.

또한 각 이벤트에는 해당 특정 이벤트와 관련된 데이터를 포함하는 `detail` 필드가 있습니다. 아래 참조는 다양한 Deadline Cloud 이벤트에 대한 세부 정보 필드를 정의합니다.

 EventBridge 를 사용하여 Deadline Cloud 이벤트를 선택하고 관리할 때는 다음 사항에 유의하는 것이 좋습니다.
+ Deadline Cloud의 모든 이벤트에 대한 `source` 필드는 로 설정됩니다`aws.deadline`.
+ `detail-type` 필드는 이벤트 유형을 지정합니다.

  예를 들어 `Fleet Size Recommendation Change`입니다.
+ `detail` 필드는 해당 특정 이벤트와 관련된 데이터를 포함합니다.

Deadline Cloud 이벤트와 일치하도록 규칙을 활성화하는 이벤트 패턴을 구성하는 방법에 대한 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [이벤트 패턴을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) 참조하세요.

이벤트 및가 이벤트를 EventBridge 처리하는 방법에 대한 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge 이벤트를](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) 참조하세요.

**Topics**
+ [예산 임계값 도달 이벤트](#event-detail-budget-threshold-reached)
+ [플릿 크기 권장 사항 변경 이벤트](#event-detail-fleet-size-recommendation-change)
+ [작업 수명 주기 상태 변경 이벤트](#event-detail-job-lifecycle-status-change)
+ [작업 실행 상태 변경 이벤트](#event-detail-job-run-status-change)
+ [단계 수명 주기 상태 변경 이벤트](#event-detail-step-lifecycle-status-change)
+ [단계 실행 상태 변경 이벤트](#event-detail-step-run-status-change)
+ [작업 실행 상태 변경 이벤트](#event-detail-task-run-status-change)

## 예산 임계값 도달 이벤트
<a name="event-detail-budget-threshold-reached"></a>

Budget Threshold Reached 이벤트를 사용하여 사용된 예산의 비율을 모니터링할 수 있습니다. Deadline Cloud는 사용된 백분율이 다음 임계값을 초과할 때 이벤트를 전송합니다.
+ 10, 20, 30, 40, 50, 60, 70, 75, 80, 85, 90, 95, 96, 97, 98, 99, 100

Deadline Cloud가 예산 임계값 도달 이벤트를 전송하는 빈도는 예산이 한도에 가까워지면 증가합니다. 이 빈도를 사용하면 예산이 한도에 가까워지면 예산을 면밀히 모니터링하고 초과 지출을 방지하기 위한 조치를 취할 수 있습니다. 자체 예산 임계값을 설정할 수도 있습니다. Deadline Cloud는 사용량이 사용자 지정 임계값을 통과하면 이벤트를 전송합니다.

예산 금액을 변경하면 Deadline Cloud가 다음에 Budget Threshold Reached 이벤트를 보낼 때 사용된 예산의 현재 비율을 기반으로 합니다. 예를 들어 한도에 도달한 100 USD 예산에 50 USD를 추가하는 경우 다음 Budget Threshold Reached 이벤트는 예산이 75%임을 나타냅니다.

다음은 `Budget Threshold Reached` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Budget Threshold Reached",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "budgetId": "budget-12345678900000000000000000000000",
        "thresholdInPercent": 0
    }
}
```

`detail-type`  <a name="job-lifecycle-status-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Budget Threshold Reached`입니다.

`source`  <a name="job-lifecycle-status-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="job-lifecycle-status-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="budget-threshold-reached-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`budgetId`  <a name="budget-threshold-reached-field-2"></a>
임계값에 도달한 예산의 식별자입니다.  
`thresholdInPercent`  <a name="budget-threshold-reached-field-3"></a>
사용된 예산의 백분율입니다.

## 플릿 크기 권장 사항 변경 이벤트
<a name="event-detail-fleet-size-recommendation-change"></a>

이벤트 기반 Auto Scaling을 사용하도록 플릿을 구성하면 Deadline Cloud는 플릿을 관리하는 데 사용할 수 있는 이벤트를 전송합니다. 이러한 각 이벤트에는 플릿의 현재 크기와 요청된 크기에 대한 정보가 포함되어 있습니다. EventBridge 이벤트와 예제 Lambda 함수를 사용하여 이벤트를 처리하는 예제는 [Deadline Cloud 규모 조정 권장 기능을 사용하여 Amazon EC2 플릿 자동 규모 조정을 참조하세요](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-auto-scaling.html#autoscale-ec2-fleet).

다음과 같은 경우 플릿 크기 권장 사항 변경 이벤트가 전송됩니다.
+ 권장 플릿 크기가 변경되고 oldFleetSize가 newFleetSize와 다른 경우.
+ 서비스가 실제 플릿 크기가 권장 플릿 크기와 일치하지 않음을 감지하는 경우. GetFleet 작업 응답에서 workerCount에서 실제 플릿 크기를 가져올 수 있습니다. 이는 활성 Amazon EC2 인스턴스가 Deadline Cloud 워커로 등록되지 않을 때 발생할 수 있습니다.

다음은 `Fleet Size Recommendation Change` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Fleet Size Recommendation Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "fleetId": "fleet-12345678900000000000000000000000",
        "oldFleetSize": 1,
        "newFleetSize": 5,
    }
}
```

`detail-type`  <a name="fleet-size-recommendation-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Fleet Size Recommendation Change`입니다.

`source`  <a name="fleet-size-recommendation-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="fleet-size-recommendation-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="fleet-size-recommendation-change-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`fleetId`  <a name="fleet-size-recommendation-change-field-2"></a>
크기 변경이 필요한 플릿의 식별자입니다.  
`oldFleetSize`  <a name="fleet-size-recommendation-change-field-3"></a>
플릿의 현재 크기입니다.  
`newFleetSize`  <a name="fleet-size-recommendation-change-field-4"></a>
플릿에 권장되는 새 크기입니다.

## 작업 수명 주기 상태 변경 이벤트
<a name="event-detail-job-lifecycle-status-change"></a>

작업을 생성하거나 업데이트할 때 Deadline Cloud는 수명 주기 상태를 설정하여 가장 최근 사용자가 시작한 작업의 상태를 표시합니다.

작업이 생성되는 시점을 포함하여 수명 주기 상태 변경에 대해 작업 수명 주기 상태 변경 이벤트가 전송됩니다.

다음은 `Job Lifecycle Status Change` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Job Lifecycle Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "previousLifecycleStatus": "UPDATE_IN_PROGRESS",
        "lifecycleStatus": "UPDATE_SUCCEEDED"
    }
}
```

`detail-type`  <a name="job-lifecycle-status-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Job Lifecycle Status Change`입니다.

`source`  <a name="job-lifecycle-status-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="job-lifecycle-status-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="job-lifecycle-status-change-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`queueId`  <a name="job-lifecycle-status-change-field-2"></a>
작업이 포함된 대기열의 식별자입니다.  
`jobId`  <a name="job-lifecycle-status-change-field-3"></a>
작업의 식별자입니다.  
`previousLifecycleStatus`  <a name="job-lifecycle-status-change-field-4"></a>
작업이 떠나는 수명 주기 상태입니다. 이 필드는 작업을 처음 제출할 때 포함되지 않습니다.  
`lifecycleStatus`  <a name="job-lifecycle-status-change-field-5"></a>
작업이 입력하는 수명 주기 상태입니다.

## 작업 실행 상태 변경 이벤트
<a name="event-detail-job-run-status-change"></a>

작업은 여러 작업으로 구성됩니다. 각 작업에는 상태가 있습니다. 모든 작업의 상태가 결합되어 작업의 전체 상태를 제공합니다. 자세한 내용은 [Deadline Cloud 사용 설명서의 Deadline Cloud의 작업 상태를](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/jobs-states.html) 참조하세요. *AWS * 

작업 실행 상태 변경 이벤트는 다음과 같은 경우에 전송됩니다.
+ 결합된 [taskRunStatus](#job-run-status-change-field-5) 필드가 변경됩니다.
+ 작업이 준비 상태에 있지 않으면 작업이 다시 대기열에 추가됩니다.

다음과 같은 경우 작업 실행 상태 변경 이벤트가 전송되지 않습니다.
+ 작업이 먼저 생성됩니다. 작업 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.
+ 작업의 [taskRunStatusCounts](#job-run-status-change-field-6) 필드는 변경되지만 결합된 작업 실행 상태는 변경되지 않습니다.

다음은 `Job Run Status Change` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Job Run Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "previousTaskRunStatus": "RUNNING",
        "taskRunStatus": "SUCCEEDED",
        "taskRunStatusCounts": {
            "PENDING": 0,
            "READY": 0,
            "RUNNING": 0,
            "ASSIGNED": 0,
            "STARTING": 0,
            "SCHEDULED": 0,
            "INTERRUPTING": 0,
            "SUSPENDED": 0,
            "CANCELED": 0,
            "FAILED": 0,
            "SUCCEEDED": 20,
            "NOT_COMPATIBLE": 0
       }
    }
}
```

`detail-type`  <a name="job-run-status-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Job Run Status Change`입니다.

`source`  <a name="job-run-status-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="job-run-status-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="job-run-status-change-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`queueId`  <a name="job-run-status-change-field-2"></a>
작업이 포함된 대기열의 식별자입니다.  
`jobId`  <a name="job-run-status-change-field-3"></a>
작업의 식별자입니다.  
`previousTaskRunStatus`  <a name="job-run-status-change-field-4"></a>
작업이 나가고 있는 작업 실행 상태입니다.  
`taskRunStatus`  <a name="job-run-status-change-field-5"></a>
작업이 입력하는 작업 실행 상태입니다.  
`taskRunStatusCounts`  <a name="job-run-status-change-field-6"></a>
각 상태의 작업 수입니다.

## 단계 수명 주기 상태 변경 이벤트
<a name="event-detail-step-lifecycle-status-change"></a>

이벤트를 생성하거나 업데이트할 때 Deadline Cloud는 작업의 수명 주기 상태를 설정하여 가장 최근 사용자가 시작한 작업의 상태를 설명합니다.

다음과 같은 경우 단계 수명 주기 상태 변경 이벤트가 전송됩니다.
+ 단계 업데이트가 시작됩니다(UPDATE\$1IN\$1PROGRESS).
+ 단계 업데이트가 성공적으로 완료되었습니다(UPDATE\$1SUCCEEDED).
+ 단계 업데이트 실패(UPDATE\$1FAILED).

단계가 처음 생성되면 이벤트가 전송되지 않습니다. 단계 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.

다음은 `Step Lifecycle Status Change` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Step Lifecycle Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "stepId": "step-12345678900000000000000000000000",
        "previousLifecycleStatus": "UPDATE_IN_PROGRESS",
        "lifecycleStatus": "UPDATE_SUCCEEDED"
    }
}
```

`detail-type`  <a name="step-lifecycle-status-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Step Lifecycle Status Change`입니다.

`source`  <a name="step-lifecycle-status-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="step-lifecycle-status-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="step-lifecycle-status-change-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`queueId`  <a name="step-lifecycle-status-change-field-2"></a>
작업이 포함된 대기열의 식별자입니다.  
`jobId`  <a name="step-lifecycle-status-change-field-3"></a>
작업의 식별자입니다.  
`stepId`  <a name="step-lifecycle-status-change-field-4"></a>
현재 작업 단계의 식별자입니다.  
`previousLifecycleStatus`  <a name="step-lifecycle-status-change-field-5"></a>
단계가 나가고 있는 수명 주기 상태입니다.  
`lifecycleStatus`  <a name="step-lifecycle-status-change-field-6"></a>
단계가 입력하는 수명 주기 상태입니다.

## 단계 실행 상태 변경 이벤트
<a name="event-detail-step-run-status-change"></a>

작업의 각 단계는 여러 작업으로 구성됩니다. 각 작업에는 상태가 있습니다. 작업 상태가 결합되어 단계 및 작업의 전체 상태를 제공합니다.

단계 실행 상태 변경 이벤트는 다음과 같은 경우에 전송됩니다.
+ 결합된가 [taskRunStatus](#step-run-status-change-field-6) 변경됩니다.
+ 단계가 준비 상태에 있지 않으면 단계가 다시 대기열에 추가됩니다.

다음과 같은 경우에는 이벤트가 전송되지 않습니다.
+ 단계가 먼저 생성됩니다. 단계 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.
+ 단계의는 [taskRunStatusCounts](#step-run-status-change-field-7) 변경되지만 결합된 단계 작업 실행 상태는 변경되지 않습니다.

다음은 `Step Run Status Change` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Step Run Status Change",
    "source": "aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "stepId": "step-12345678900000000000000000000000",
        "previousTaskRunStatus": "RUNNING",
        "taskRunStatus": "SUCCEEDED",
        "taskRunStatusCounts": {
            "PENDING": 0,
            "READY": 0,
            "RUNNING": 0,
            "ASSIGNED": 0,
            "STARTING": 0,
            "SCHEDULED": 0,
            "INTERRUPTING": 0,
            "SUSPENDED": 0,
            "CANCELED": 0,
            "FAILED": 0,
            "SUCCEEDED": 20,
            "NOT_COMPATIBLE": 0
       }
    }
}
```

`detail-type`  <a name="step-run-status-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Step Run Status Change`입니다.

`source`  <a name="step-run-status-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="step-run-status-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="step-run-status-change-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`queueId`  <a name="step-run-status-change-field-2"></a>
작업이 포함된 대기열의 식별자입니다.  
`jobId`  <a name="step-run-status-change-field-3"></a>
작업의 식별자입니다.  
`stepId`  <a name="step-run-status-change-field-4"></a>
현재 작업 단계의 식별자입니다.  
`previousTaskRunStatus`  <a name="step-run-status-change-field-5"></a>
단계가 나가고 있는 실행 상태입니다.  
`taskRunStatus`  <a name="step-run-status-change-field-6"></a>
단계가 입력하는 실행 상태입니다.  
`taskRunStatusCounts`  <a name="step-run-status-change-field-7"></a>
각 상태의 단계 작업 수입니다.

## 작업 실행 상태 변경 이벤트
<a name="event-detail-task-run-status-change"></a>

[runStatus](#task-run-status-change-field-7) 필드는 작업이 실행될 때 업데이트됩니다. 이벤트는 다음과 같은 경우에 전송됩니다.
+ 작업의 실행 상태가 변경됩니다.
+ 작업이 준비 상태에 있지 않으면 작업이 다시 대기열에 추가됩니다.

다음과 같은 경우에는 이벤트가 전송되지 않습니다.
+ 작업이 먼저 생성됩니다. 작업 생성을 모니터링하려면 작업 수명 주기 상태 변경 이벤트에서 변경 사항을 모니터링합니다.

다음은 `Task Run Status Change` 이벤트의 세부 정보 필드입니다.

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

```
{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "Task Run Status Change",
    "source": "aws.aws.deadline",
    "account": "111122223333",
    "time": "2017-12-22T18:43:48Z",
    "region": "aa-example-1",
    "resources": [],
    "detail": {
        "farmId": "farm-12345678900000000000000000000000",
        "queueId": "queue-12345678900000000000000000000000",
        "jobId": "job-12345678900000000000000000000000",
        "stepId": "step-12345678900000000000000000000000",
        "taskId": "task-12345678900000000000000000000000-0",
        "previousRunStatus": "RUNNING",
        "runStatus": "SUCCEEDED"
    }
}
```

`detail-type`  <a name="task-run-status-change-detail-type"></a>
이벤트의 유형을 식별합니다.  
이 이벤트의 경우 이 값은 `Fleet Size Recommendation Change`입니다.

`source`  <a name="task-run-status-change-source"></a>
이벤트를 생성한 서비스를 식별합니다. Deadline Cloud 이벤트의 경우이 값은 입니다`aws.deadline`.

`detail`  <a name="task-run-status-change-detail"></a>
이벤트에 대한 정보를 포함하는 JSON 객체입니다. 이벤트를 생성하는 서비스에 따라 이 필드의 내용이 결정됩니다.  
이 이벤트의 경우 이 데이터에는 다음이 포함됩니다.    
`farmId`  <a name="task-run-status-change-field-1"></a>
작업이 포함된 팜의 식별자입니다.  
`queueId`  <a name="task-run-status-change-field-2"></a>
작업이 포함된 대기열의 식별자입니다.  
`jobId`  <a name="task-run-status-change-field-3"></a>
작업의 식별자입니다.  
stepId  <a name="task-run-status-change-field-4"></a>
현재 작업 단계의 식별자입니다.  
`taskId`  <a name="task-run-status-change-field-5"></a>
실행 중인 작업의 식별자입니다.  
`previousRunStatus`  <a name="task-run-status-change-field-6"></a>
작업이 나가고 있는 실행 상태입니다.  
`runStatus`  <a name="task-run-status-change-field-7"></a>
작업이 입력하는 실행 상태입니다.