你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
事件消息结构
在本文中，了解事件消息结构、必需和非要求元素，并查看事件消息有效负载的示例。
重要
事件当前支持以下操作：
FhirResourceCreated - 成功创建 FHIR 资源后发出的事件。
FhirResourceUpdated - 成功更新 FHIR 资源后发出的事件。
FhirResourceDeleted - 成功删除 FHIR 资源后发出的事件。
DicomImageCreated - 成功创建 DICOM 映像后发出的事件。
DicomImageDeleted - 成功删除 DICOM 映像后发出的事件。
DicomImageUpdated - 成功更新 DICOM 映像后发出的事件。
有关 FHIR 服务删除类型的详细信息，请参阅 Azure Health Data Services 中的 FHIR 服务中的 REST API 功能
FHIR 事件消息结构
| 名称 | 类型 | 必需 | 说明 |
|---|---|---|---|
topic |
字符串 | 是 | 本主题是 Azure Health Data Services 工作区的 Azure 资源 ID。 |
subject |
string | 是 | 已更改的 FHIR 资源的统一资源标识符（URI）。 客户可以使用具有 https:// 方案的主题访问资源。 客户应使用 dataVersion 或 data.resourceVersionId 访问有关此事件的特定数据版本。 |
eventType |
string（枚举） | 是 | FHIR 资源的更改类型。 |
eventTime |
string（datetime） | 是 | FHIR 资源更改提交的 UTC 时间。 |
id |
string | 是 | 事件的唯一标识符。 |
data |
object | 是 | FHIR 资源更改事件详细信息。 |
data.resourceType |
string（枚举） | 是 | 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 事件网格定义，并且大部分时间应保持一定。 |
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 事件消息结构
| 名称 | 类型 | 必需 | 说明 |
|---|---|---|---|
topic |
字符串 | 是 | 本主题是 Azure Health Data Services 工作区的 Azure 资源 ID。 |
subject |
string | 是 | 已更改的 DICOM 映像的统一资源标识符（URI）。 客户可以使用主题访问具有 https:// 方案的图像。 客户应使用 dataVersion 或 data.resourceVersionId 访问有关此事件的特定数据版本。 |
eventType |
string（枚举） | 是 | DICOM 映像上的更改类型。 |
eventTime |
string（datetime） | 是 | 提交 DICOM 图像更改的 UTC 时间。 |
id |
string | 是 | 事件的唯一标识符。 |
data |
object | 是 | DICOM 映像更改事件详细信息。 |
data.partitionName |
string | 否 | 数据分区名称。 |
data.imageStudyInstanceUid |
string | 是 | 图像的研究实例 UID。 |
data.imageSeriesInstanceUid |
string | 是 | 图像的系列实例 UID。 |
data.imageSopInstanceUid |
string | 是 | 图像的 SOP 实例 UID。 |
data.serviceHostName |
string | 是 | 发生更改的 DICOM 服务的主机名。 |
data.sequenceNumber |
int | 是 | DICOM 服务中更改的序列号。 创建和删除的每个映像在服务中都有一个唯一的序列。 此数字与 DICOM 服务的更改源的序列号相关联。 使用此序列号查询 DICOM 服务更改源可提供创建此事件的更改。 |
dataVersion |
string | 否 | DICOM 映像的数据版本。 |
metadataVersion |
string | 否 | 事件元数据的架构版本。 这由Azure 事件网格定义，并且大部分时间应保持一定。 |
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 门户部署事件，请参阅
FHIR® 是 Health Level Seven International 的注册商标，在美国商标局注册，经其许可使用。