다음을 통해 공유

이벤트 메시지 구조

  • 아티클

이 문서에서는 이벤트 메시지 구조, 필수 요소 및 필수 요소가 아닌 요소에 대해 알아보고 이벤트 메시지 페이로드의 샘플을 참조하세요.

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을 사용하여 이벤트를 배포하는 방법을 알아보려면

Azure Portal을 사용하여 이벤트 배포

FHIR®은 미국 특허청에 등록된 Health Level Seven International의 등록 상표이며 해당 사용 허가하에 사용됩니다.