이벤트 메시지 구조
이 문서에서는 이벤트 메시지 구조, 필수 요소 및 필수 요소가 아닌 요소에 대해 알아보고 이벤트 메시지 페이로드의 샘플을 참조하세요.
Important
이벤트는 현재 다음 작업을 지원합니다.
FhirResourceCreated - FHIR 리소스를 만든 후 내보낸 이벤트입니다.
FhirResourceUpdated - FHIR 리소스를 업데이트한 후 내보낸 이벤트입니다.
FhirResourceDeleted - FHIR 리소스를 일시 삭제한 후 내보낸 이벤트입니다.
DicomImageCreated - DICOM 이미지를 만든 후 내보낸 이벤트입니다.
DicomImageDeleted - DICOM 이미지를 삭제한 후 내보낸 이벤트입니다.
DicomImageUpdated - DICOM 이미지를 업데이트한 후 내보낸 이벤트입니다.
FHIR 서비스 삭제 유형에 대한 자세한 내용은 Azure Health Data Services의 FHIR 서비스에서 REST API 기능을 참조 하세요.
FHIR 이벤트 메시지 구조
속성 | Type | 필수 | 설명 |
---|---|---|---|
topic |
string | 예 | 항목은 Azure Health Data Services 작업 영역의 Azure 리소스 ID입니다. |
subject |
string | 예 | 변경된 FHIR 리소스의 URI(Uniform Resource Identifier)입니다. 고객은 https:// 체계를 사용하여 주체를 사용하여 리소스에 액세스할 수 있습니다. 고객은 dataVersion 또는 data.resourceVersionId를 사용하여 이 이벤트와 관련된 특정 데이터 버전을 방문해야 합니다. |
eventType |
string(enum) | 예 | FHIR 리소스의 변경 유형입니다. |
eventTime |
string(datetime) | 예 | FHIR 리소스 변경이 커밋된 UTC 시간입니다. |
id |
string | 예 | 이벤트에 대한 고유 식별자입니다. |
data |
개체 | 예 | FHIR 리소스 변경 이벤트 세부 정보입니다. |
data.resourceType |
string(enum) | 예 | FHIR 리소스 종류입니다. |
data.resourceFhirAccount |
string | 예 | Azure Health Data Services 작업 영역에 있는 FHIR 계정의 서비스 이름입니다. |
data.resourceFhirId |
string | 예 | FHIR 계정의 리소스 ID입니다. FHIR 서비스는 고객이 리소스를 만들 때 ID를 임의로 생성합니다. 고객은 FHIR 리소스 생성 시 사용자 지정 ID를 사용할 수도 있습니다. 그러나 ID는 PHI/PII 정보를 포함하거나 유추해서는 안 됩니다. 개인 데이터 콘텐츠와 관련이 없는 시스템 메타데이터여야 합니다. |
data.resourceVersionId |
string(number) | 예 | FHIR 리소스의 데이터 버전입니다. |
dataVersion |
string | 아니요 | data.resourceVersionId 와 동일합니다. |
metadataVersion |
string | 아니요 | 이벤트 메타데이터의 스키마 버전입니다. 이는 Azure Event Grid에 의해 정의되며 대부분의 경우 일정해야 합니다. |
FHIR 이벤트 메시지 샘플
FhirResourceCreated 이벤트
{
"id": "e4c7f556-d72c-e7f7-1069-1e82ac76ab41",
"topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
"subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
"data": {
"resourceType": "Patient",
"resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
"resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
"resourceVersionId": 1
},
"eventType": "Microsoft.HealthcareApis.FhirResourceCreated",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2021-09-08T01:14:04.5613214Z"
}
FhirResourceUpdated 이벤트
{
"id": "634bd421-8467-f23c-b8cb-f6a31e41c32a",
"topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
"subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
"data": {
"resourceType": "Patient",
"resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
"resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
"resourceVersionId": 2
},
"eventType": "Microsoft.HealthcareApis.FhirResourceUpdated",
"dataVersion": "2",
"metadataVersion": "1",
"eventTime": "2021-09-08T01:29:12.0618739Z"
}
FhirResourceDeleted 이벤트
{
"id": "ef289b93-3159-b833-3a44-dc6b86ed1a8a",
"topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
"subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
"data": {
"resourceType": "Patient",
"resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
"resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
"resourceVersionId": 3
},
"eventType": "Microsoft.HealthcareApis.FhirResourceDeleted",
"dataVersion": "3",
"metadataVersion": "1",
"eventTime": "2021-09-08T01:31:58.5175837Z"
}
DICOM 이벤트 메시지 구조
속성 | Type | 필수 | 설명 |
---|---|---|---|
topic |
string | 예 | 항목은 Azure Health Data Services 작업 영역의 Azure 리소스 ID입니다. |
subject |
string | 예 | 변경된 DICOM 이미지의 URI(Uniform Resource Identifier)입니다. 고객은 https:// 체계를 사용하여 제목을 사용하여 이미지에 액세스할 수 있습니다. 고객은 dataVersion 또는 data.resourceVersionId를 사용하여 이 이벤트와 관련된 특정 데이터 버전을 방문해야 합니다. |
eventType |
string(enum) | 예 | DICOM 이미지의 변경 유형입니다. |
eventTime |
string(datetime) | 예 | DICOM 이미지 변경이 커밋된 UTC 시간입니다. |
id |
string | 예 | 이벤트에 대한 고유 식별자입니다. |
data |
개체 | 예 | DICOM 이미지 변경 이벤트 세부 정보입니다. |
data.partitionName |
string | 아니요 | 데이터 파티션 이름입니다. |
data.imageStudyInstanceUid |
string | 예 | 이미지의 연구 인스턴스 UID입니다. |
data.imageSeriesInstanceUid |
string | 예 | 이미지의 Series Instance UID입니다. |
data.imageSopInstanceUid |
string | 예 | 이미지의 SOP 인스턴스 UID입니다. |
data.serviceHostName |
string | 예 | 변경이 발생한 DICOM 서비스의 호스트 이름입니다. |
data.sequenceNumber |
int | 예 | DICOM 서비스의 변경 시퀀스 번호입니다. 모든 이미지 만들기 및 삭제에는 서비스 내에서 고유한 시퀀스가 있습니다. 이 숫자는 DICOM 서비스의 변경 피드 시퀀스 번호와 관련이 있습니다. 이 시퀀스 번호로 DICOM 서비스 변경 피드를 쿼리하면 이 이벤트를 만든 변경 내용이 표시됩니다. |
dataVersion |
string | 아니요 | DICOM 이미지의 데이터 버전입니다. |
metadataVersion |
string | 아니요 | 이벤트 메타데이터의 스키마 버전입니다. 이는 Azure Event Grid에 의해 정의되며 대부분의 경우 일정해야 합니다. |
DICOM 이벤트 메시지 샘플
DicomImageCreated
{
"id": "d621839d-958b-4142-a638-bb966b4f7dfd",
"topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
"subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
"data": {
"partitionName": "Microsoft.Default",
"imageStudyInstanceUid": "1.2.3.4.3",
"imageSeriesInstanceUid": "1.2.3.4.3.9423673",
"imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
"serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
"sequenceNumber": 1
},
"eventType": "Microsoft.HealthcareApis.DicomImageCreated",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2022-09-15T01:14:04.5613214Z"
}
DicomImageDeleted
{
"id": "eac1c1a0-ffa8-4b28-97cc-1d8b9a0a6021",
"topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
"subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
"data": {
"partitionName": "Microsoft.Default",
"imageStudyInstanceUid": "1.2.3.4.3",
"imageSeriesInstanceUid": "1.2.3.4.3.9423673",
"imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
"serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
"sequenceNumber": 2
},
"eventType": "Microsoft.HealthcareApis.DicomImageDeleted",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2022-09-15T01:16:07.5692209Z"
}
DicomImageUpdated
{
"id": "83cb0f51-af41-e58c-3c6c-46344b349bc5",
"topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
"subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
"data": {
"partitionName": "Microsoft.Default",
"imageStudyInstanceUid": "1.2.3.4.3",
"imageSeriesInstanceUid": "1.2.3.4.3.9423673",
"imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
"serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
"sequenceNumber": 2
},
"eventType": "Microsoft.HealthcareApis.DicomImageUpdated",
"dataVersion": "1",
"metadataVersion": "1",
"eventTime": "2023-06-09T16:55:44.7197137Z"
}
다음 단계
이 문서에서는 이벤트 메시지 구조에 대해 알아보았습니다.
Azure Portal을 사용하여 이벤트를 배포하는 방법을 알아보려면
FHIR®은 미국 특허청에 등록된 Health Level Seven International의 등록 상표이며 해당 사용 허가하에 사용됩니다.