기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# HealthImaging에서 Amazon EventBridge 사용
Amazon EventBridge는 이벤트를 사용하여 애플리케이션 구성 요소를 서로 연결하는 서버리스 서비스로, 확장 가능한 이벤트 기반 애플리케이션을 더 쉽게 구축할 수 있습니다. EventBridge의 기본은 [이벤트를](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) [대상으로](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html) 라우팅하는 [규칙을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) 생성하는 것입니다. AWS HealthImaging은 상태 변경을 EventBridge에 지속적으로 전달합니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge란?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) 섹션을 참조하세요.
**Topics**
+ [EventBridge로 전송된 HealthImaging 이벤트](#event-notifications-listing)
+ [HealthImaging 이벤트 구조 및 예제](#event-notifications-structure-examples)
## EventBridge로 전송된 HealthImaging 이벤트
다음 표에는 처리를 위해 EventBridge로 전송된 모든 HealthImaging 이벤트가 나열되어 있습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/healthimaging/latest/devguide/event-notifications.html)
## HealthImaging 이벤트 구조 및 예제
HealthImaging 이벤트는 메타데이터 세부 정보도 포함하는 JSON 구조의 객체입니다. 메타데이터를 입력으로 사용하여 이벤트를 다시 생성하거나 자세한 내용을 알아볼 수 있습니다. 연결된 모든 메타데이터 필드는 다음 메뉴의 코드 예제 아래 테이블에 나열됩니다. 자세한 내용은 *Amazon EventBridge 사용 설명서의 이벤트* [구조 참조](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)를 참조하세요.
**참고**
HealthImaging 이벤트 구조의 `source` 속성은 입니다`aws.medical-imaging`.
### 데이터 스토어 이벤트
------
#### [ Data Store Creating ]
**상태 - `CREATING`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Data Store Creating",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"datastoreName": "test",
"datastoreStatus": "CREATING"
}
}
```
------
#### [ Data Store Creation Failed ]
**상태 - `CREATE_FAILED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Data Store Creation Failed",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"datastoreName": "test",
"datastoreStatus": "CREATE_FAILED"
}
}
```
------
#### [ Data Store Created ]
**상태 - `ACTIVE`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Data Store Created",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"datastoreName": "test",
"datastoreStatus": "ACTIVE"
}
}
```
------
#### [ Data Store Deleting ]
**상태 - `DELETING`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Data Store Deleting",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"datastoreName": "test",
"datastoreStatus": "DELETING"
}
}
```
------
#### [ Data Store Deleted ]
**상태 - `DELETED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Data Store Deleted",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"datastoreName": "test",
"datastoreStatus": "DELETED"
}
}
```
------
**데이터 스토어 이벤트 - 메타데이터 설명**
| 이름 | Type | 설명 |
| --- | --- | --- |
| version | 문자열 | EventBridge 이벤트 스키마 버전입니다. |
| id | 문자열 | 모든 이벤트에 대해 생성된 버전 4 UUID입니다. |
| detail-type | 문자열 | 전송 중인 이벤트의 유형입니다. |
| source | 문자열 | 이벤트를 생성한 서비스를 식별합니다. |
| account | 문자열 | 데이터 스토어 소유자의 12자리 AWS 계정 ID입니다. |
| time | 문자열 | 이벤트가 발생한 시간입니다. |
| region | 문자열 | 데이터 스토어의 AWS 리전을 식별합니다. |
| resources | 배열(문자열) | 데이터 스토어의 ARN을 포함하는 JSON 배열입니다. |
| detail | 객체 | 이벤트에 대한 정보를 포함하는 JSON 객체입니다. |
| detail.imagingVersion | 문자열 | HealthImaging의 이벤트 세부 정보 스키마에 대한 변경 사항을 추적하는 버전 ID입니다. |
| detail.datastoreId | 문자열 | 상태 변경 이벤트와 연결된 데이터 스토어 ID입니다. |
| detail.datastoreName | 문자열 | 데이터 스토어 이름입니다. |
| detail.datastoreStatus | 문자열 | 현재 데이터 스토어 상태입니다. |
### 작업 이벤트 가져오기
------
#### [ Import Job Submitted ]
**상태 - `SUBMITTED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Import Job Submitted",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"jobId": "a6a1d220f152e7aab6d8925d995d8b76",
"jobName": "test_only_1",
"jobStatus": "SUBMITTED",
"inputS3Uri": "s3://healthimaging-test-bucket/input/",
"outputS3Uri": "s3://healthimaging-test-bucket/output/"
}
}
```
------
#### [ Import Job In Progress ]
**상태 - `IN_PROGRESS`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Import Job In Progress",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"jobId": "a6a1d220f152e7aab6d8925d995d8b76",
"jobName": "test_only_1",
"jobStatus": "IN_PROGRESS",
"inputS3Uri": "s3://healthimaging-test-bucket/input/",
"outputS3Uri": "s3://healthimaging-test-bucket/output/"
}
}
```
------
#### [ Import Job Completed ]
**상태 - `COMPLETED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Import Job Completed",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"jobId": "a6a1d220f152e7aab6d8925d995d8b76",
"jobName": "test_only_1",
"jobStatus": "COMPLETED",
"inputS3Uri": "s3://healthimaging-test-bucket/input/",
"outputS3Uri": "s3://healthimaging-test-bucket/output/"
}
}
```
------
#### [ Import Job Failed ]
**상태 - `FAILED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Import Job Failed",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:111122223333:datastore/bbc4f3cccbae4095a34170fddc19b13d"],
"detail": {
"imagingVersion": "1.0",
"datastoreId" : "bbc4f3cccbae4095a34170fddc19b13d",
"jobId": "a6a1d220f152e7aab6d8925d995d8b76",
"jobName": "test_only_1",
"jobStatus": "FAILED",
"inputS3Uri": "s3://healthimaging-test-bucket/input/",
"outputS3Uri": "s3://healthimaging-test-bucket/output/"
}
}
```
------
**작업 이벤트 가져오기 - 메타데이터 설명**
| 이름 | Type | 설명 |
| --- | --- | --- |
| version | 문자열 | EventBridge 이벤트 스키마 버전입니다. |
| id | 문자열 | 모든 이벤트에 대해 생성된 버전 4 UUID입니다. |
| detail-type | 문자열 | 전송 중인 이벤트의 유형입니다. |
| source | 문자열 | 이벤트를 생성한 서비스를 식별합니다. |
| account | 문자열 | 데이터 스토어 소유자의 12자리 AWS 계정 ID입니다. |
| time | 문자열 | 이벤트가 발생한 시간입니다. |
| region | 문자열 | 데이터 스토어의 AWS 리전을 식별합니다. |
| resources | 배열(문자열) | 데이터 스토어의 ARN을 포함하는 JSON 배열입니다. |
| detail | 객체 | 이벤트에 대한 정보를 포함하는 JSON 객체입니다. |
| detail.imagingVersion | 문자열 | HealthImaging의 이벤트 세부 정보 스키마에 대한 변경 사항을 추적하는 버전 ID입니다. |
| detail.datastoreId | 문자열 | 상태 변경 이벤트를 생성한 데이터 스토어입니다. |
| detail.jobId | 문자열 | 상태 변경 이벤트와 연결된 가져오기 작업 ID입니다. |
| detail.jobName | 문자열 | 가져오기 작업 이름입니다. |
| detail.jobStatus | 문자열 | 현재 작업 상태입니다. |
| detail.inputS3Uri | 문자열 | 가져올 DICOM 파일이 포함된 S3 버킷의 입력 접두사 경로입니다. |
| detail.outputS3Uri | 문자열 | DICOM 가져오기 작업의 결과가 업로드될 S3 버킷의 출력 접두사입니다. |
### 이미지 세트 이벤트
------
#### [ Image Set Created ]
**상태 - `CREATED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Created",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "ACTIVE",
"imageSetWorkflowStatus": "CREATED"
}
}
```
------
#### [ Image Set Copying ]
**상태 - `COPYING`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Copying",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "COPYING",
"sourceImageSetArn": "arn:aws:medical-imaging:us-west-2:147997158357:datastore/c381ee9b9ef34902a45b476dd7be068b/imageset/0309de3674fd551fa7ddd2880b21f990"
}
}
```
------
#### [ Image Set Copying With Read Only Access ]
**상태 - `COPYING_WITH_READ_ONLY_ACCESS`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Copying With Read Only Access",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "COPYING_WITH_READ_ONLY_ACCESS"
}
}
```
------
#### [ Image Set Copied ]
**상태 - `COPIED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Copied",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "ACTIVE",
"imageSetWorkflowStatus": "COPIED"
}
}
```
------
#### [ Image Set Copy Failed ]
**상태 - `COPY_FAILED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Copy Failed",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "ACTIVE",
"imageSetWorkflowStatus": "COPY_FAILED"
}
}
```
------
#### [ Image Set Updating ]
**상태 - `UPDATING`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Updating",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "UPDATING"
}
}
```
------
#### [ Image Set Updated ]
**상태 - `UPDATED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Updated",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "ACTIVE",
"imageSetWorkflowStatus": "UPDATED"
}
}
```
------
#### [ Image Set Update Failed ]
**상태 - `UPDATE_FAILED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Update Failed",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "ACTIVE",
"imageSetWorkflowStatus": "UPDATE_FAILED"
}
}
```
------
#### [ Image Set Deleting ]
**상태 - `DELETING`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Deleting",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "LOCKED",
"imageSetWorkflowStatus": "DELETING"
}
}
```
------
#### [ Image Set Deleted ]
**상태 - `DELETED`**
```
{
"version": "0",
"id": "7cf0fb1c-8720-4d48-baa3-6eb97b35a10e",
"detail-type": "Image Set Deleted",
"source": "aws.medical-imaging",
"account": "111122223333",
"time": "2024-03-14T00:01:00Z",
"region": "us-west-2",
"resources": ["arn:aws:medical-imaging:us-west-2:846006145877:datastore/bbc4f3cccbae4095a34170fddc19b13d/imageset/207284eef860ac01c4b2a8de27a6fc11"],
"detail": {
"imagingVersion": "1.0",
"isPrimary": true,
"imageSetVersion": "1",
"datastoreId": "bbc4f3cccbae4095a34170fddc19b13d",
"imagesetId": "5b3a711878c34d40e888253319388649",
"imageSetState": "DELETED",
"imageSetWorkflowStatus": "DELETED"
}
}
```
------
**이미지 세트 이벤트 - 메타데이터 설명**
| 이름 | Type | 설명 |
| --- | --- | --- |
| version | 문자열 | EventBridge 이벤트 스키마 버전입니다. |
| id | 문자열 | 모든 이벤트에 대해 생성된 버전 4 UUID입니다. |
| detail-type | 문자열 | 전송 중인 이벤트의 유형입니다. |
| source | 문자열 | 이벤트를 생성한 서비스를 식별합니다. |
| account | 문자열 | 데이터 스토어 소유자의 12자리 AWS 계정 ID입니다. |
| time | 문자열 | 이벤트가 발생한 시간입니다. |
| region | 문자열 | 데이터 스토어의 AWS 리전을 식별합니다. |
| resources | 배열(문자열) | 이미지 세트의 ARN을 포함하는 JSON 배열입니다. |
| detail | 객체 | 이벤트에 대한 정보를 포함하는 JSON 객체입니다. |
| detail.imagingVersion | 문자열 | HealthImaging의 이벤트 세부 정보 스키마에 대한 변경 사항을 추적하는 버전 ID입니다. |
| detail.isPrimary | 부울 | 가져온 데이터가 관리형 계층 구조로 성공적으로 구성되었는지 또는 해결해야 할 메타데이터 충돌이 있는지 나타냅니다. |
| detail.imageSetVersion | 문자열 | 인스턴스를 두 번 이상 가져오면 이미지 세트 버전이 증가합니다. 최신 버전은 기본 이미지 세트에 저장된 이전 버전을 덮어씁니다. |
| detail.datastoreId | 문자열 | 상태 변경 이벤트를 생성한 데이터 스토어 ID입니다. |
| detail.imagesetId | 문자열 | 상태 변경 이벤트와 연결된 이미지 세트 ID입니다. |
| detail.imageSetState | 문자열 | 현재 이미지 세트 상태입니다. |
| detail.imageSetWorkflowStatus | 문자열 | 현재 이미지 세트 워크플로 상태입니다. |