本页介绍了如何使用 Cloud Healthcare API 中的 v1beta1 DicomTagConfig 配置在以下级别对 DICOM 实例中的敏感数据进行去标识化：
- 在数据集级层，使用
datasets.deidentify - 在 DICOM 存储区级层，使用
dicomStores.deidentify
本页面还介绍了在 DICOM 存储区级层对数据进行去标识化时如何应用过滤条件。
您可以使用旧版 v1 DicomConfig 对象或 v1beta1 DicomTagConfig 对象配置 DICOM 去标识化操作。我们强烈建议您使用 DicomTagConfig。
如果您已在使用 DicomConfig 进行去标识化操作，我们建议您改用 DicomTagConfig。如需简要了解新功能，请参阅 DicomTagConfig 中的新配置选项。
如需了解如何进行迁移，请参阅迁移请求和响应以使用 DicomTagConfig。
DicomTagConfig 中的新配置选项
使用情境去标识化功能对文本进行去标识化
您可以配置 DicomTagConfig.Options.CleanDescriptorsOption 对象，以启用对非结构化元数据文本的情境去标识化。此选项基于“清理描述符”选项。指定 DicomTagConfig.Options.CleanDescriptorsOption 后，系统会在检查期间使用额外的 infoType，这可能会影响结算费用。
使用 DicomTagConfig.Options.CleanDescriptorsOption 选项可转换与移除的代码匹配的任何非结构化元数据文本，从而提高去标识化的质量。例如，假设您要对 X 光片进行去标识化处理，而 X 光片患者的姓氏也是名词，例如 Wall。如果实例中的任何元数据（例如 StudyDescription 中的文本）包含 Wall 一词，则系统会转换该文本。
CleanDescriptorsOption 选项会隐去与 DICOM 基本配置文件中标记为移除的任何标记匹配的上下文短语，前提是这些标记与以下某个操作代码匹配：
DZXU
匹配的内容相关短语会替换为令牌 [CTX]。
您可以通过指定以下内容来配置要隐去哪些代码：
ProfileType对象中的枚举。无需指定枚举。CleanTextTag过滤到特定代码。
不过，DICOM 基本配置文件中使用的标记无法更改。
使用情境去标识化功能隐去烧屏文字
您可以指定 TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 枚举，以便在上下文中去标识图片中的烧屏文字。此选项基于“清理描述符”选项。指定 TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 枚举后，系统会在检查期间使用额外的 infoType，这可能会影响结算费用。
您可以通过以下方式指定 TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 枚举：
在包含
DicomTagConfig.Options.ImageConfig.TextRedactionMode的Options.ImageConfig对象中。指定此选项后，系统会自动将PixelData (7FE0,0010)标记添加到要隐去的内容的标记列表中。在包含
DicomTagConfig.Action.CleanImageTag.TextRedactionMode的Action.CleanImageTag对象中。指定此选项时，您必须手动将PixelData标记添加到Action.queries[]数组。使用Action.CleanImageTag时，PixelData标记是唯一受支持的标记。
TextRedactionMode.REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 选项会隐去与 DICOM 基本配置文件中标记为移除的任何标记匹配的烧屏文本，前提是这些标记与以下某个操作代码匹配：
DZXU
除了使用 ProfileType 对象中的枚举启用或停用该功能之外，没有其他配置可用于对嵌入式文本进行情境去标识化。无需指定枚举。
图片去标识化中的其他 infoType
您可以使用信息类型 (infoType) 指定在对标记执行去标识化操作时要扫描哪些数据。infoType 是一种敏感数据类型，例如患者姓名、电子邮件地址、电话号码、身份证号码和信用卡号等等。
您可以在 DicomTagConfig.Options.ImageConfig 对象中配置以下字段，以确定在 DICOM 图片去标识化期间要使用哪些 infoType：
只有在 DicomTagConfig.Options.ImageConfig.TextRedactionMode 设置为以下值之一时，这些字段才会生效：
迁移请求和响应以使用 DicomTagConfig
您可以使用 DicomTagConfig 配置 DICOM 去标识化，该方法在 Cloud Healthcare API v1beta1 中提供，是使用旧版 DicomConfig 的替代方案。发送请求时，您不能同时包含 DicomConfig 和 DicomTagConfig。
以下部分介绍了 DicomConfig 中的配置以及如何将其迁移到 DicomTagConfig。
TagFilterProfile 至 ProfileType
将 DicomConfig TagFilterProfile 对象替换为 DicomTagConfig ProfileType 对象。ProfileType 中提供了 TagFilterProfileType 中的四种配置文件。
以下示例展示了如何将请求从使用 TagFilterProfile 迁移到使用 ProfileType：
DicomConfig | DicomTagConfig |
|---|---|
|
|
keepList 和 removeList
DicomTagConfig 中不再提供 DicomConfig keepList 和 removeList 字段。如果您使用 keepList 和 removeList 指定要保留或移除的标记，而不是使用配置文件，则必须迁移到您指定标记行为的新 Action 对象。Action 对象提供了用于转换代码的其他选项。
以下示例展示了如何将请求从使用 keepList 迁移到使用 Action.keepTag。该请求指定在去标识化操作期间保留 PatientID 标记的值。
DicomConfig | DicomTagConfig |
|---|---|
|
|
组合使用保留列表、移除列表和个人资料
在 DicomConfig 对象中，您可以根据保留列表、移除列表和配置文件确定要保留还是移除数据。这些选项是互斥的。
使用 DicomTagConfig 对象时，您可以通过在 Action 对象中指定要保留和移除的标记，同时在 ProfileType 中指定配置文件，来组合使用这些选项。
在 Action 对象中配置的选项会替换在 ProfileType 配置文件中配置的选项。Action 对象中的选项会按请求中提供的顺序应用。
skipIdRedaction 至 Objects.primaryIds
将 DicomConfig 对象中的 skipIdRedaction 字段替换为 DicomTagConfig 对象中的 primaryIds 字段。primaryIds 字段（位于 Options 对象中）包含一个 PrimaryIdsOption 对象，您可以在其中指定以下枚举之一：
PRIMARY_IDS_OPTION_UNSPECIFIED：未向PrimaryIdsOption提供任何值时的默认行为。默认为ProfileType中指定的选项。KEEP：将主 ID 保持不变。REGEN：重新生成主要 ID。
以下示例展示了如何将请求从使用 skipIdRedaction 迁移到使用 Options.primaryIds。该请求指定在去标识化操作期间保留主 ID 的值：
DicomConfig | DicomTagConfig |
|---|---|
|
|
DeidentifyConfig.ImageConfig 至 DicomTagConfig.Options.ImageConfig
将 DeidentifyConfig.ImageConfig 对象替换为 DicomTagConfig.Options.ImageConfig 对象。这两个版本中 ImageConfig 对象中的选项相同。
以下示例展示了如何将请求从在 DeidentifyConfig.image 中使用 ImageConfig 迁移到在 DeidentifyConfig.DicomTagConfig.Options.cleanImage 中使用 ImageConfig。该请求指定在去标识化操作期间要隐去图片中的所有文本：
DeidentifyConfig.image | DeidentifyConfig.DicomTagConfig.Options.cleanImage |
|---|---|
|
|
去标识化概览
数据集级别去标识化
如需在数据集级层对 DICOM 数据进行去标识化，请调用 datasets.deidentify 方法。datasets.deidentify 方法包含以下组件：
- 源数据集：包含 DICOM 存储区的数据集，DICOM 存储区具有一个或多个包含敏感数据的实例。调用
datasets.deidentify方法时，会对数据集中所有 DICOM 存储区中的所有实例进行去标识化。 - 目标数据集：去标识化操作并不会影响原始数据集或其数据。相反，已经去标识化的原始数据副本将会写入到称为目标数据集的新数据集。
- 要进行去标识化的内容：用于指定如何处理数据集中的 DICOM 数据的配置参数。您可以通过在
DeidentifyConfig对象中指定这些参数，配置 DICOM 去标识化，以对 DICOM 实例元数据（使用标记关键字）或 DICOM 图片中的烧屏文字进行去标识化。
本指南中的大多数示例展示了如何在数据集级层对 DICOM 数据进行去标识化。
DICOM 存储区级层去标识化
通过在 DICOM 存储区级层对 DICOM 数据进行去标识化，您可以更好地控制要对哪些数据进行去标识化。例如，如果您有一个包含多个 DICOM 存储区的数据集，则可以根据存储区中存在的数据类型对每个 DICOM 存储区进行去标识化。
要对 DICOM 存储区中的 DICOM 数据进行去标识化，请调用 dicomStores.deidentify 方法。dicomStores.deidentify 方法包含以下组件：
- 来源 DICOM 存储区：包含一个或多个实例（具有敏感数据）的 DICOM 存储区。当您调用
dicomStores.deidentify操作时，DICOM 存储区中的所有实例都会进行去标识化。 - 目标 DICOM 存储区：去标识化并不会影响原始 DICOM 存储区或其数据。相反，已经去标识化的原始数据副本将会写入到目标 DICOM 存储区。目标 DICOM 存储区必须已存在。
- 要进行去标识化的内容：用于指定如何处理 DICOM 存储区的配置参数。您可以通过在
DeidentifyConfig对象中指定这些参数，配置 DICOM 去标识化，以对 DICOM 实例元数据（使用标记关键字）或 DICOM 图片中的烧屏文字进行去标识化。
如需查看示例以了解如何在 DICOM 存储区级层对 DICOM 数据进行去标识化，请参阅在 DICOM 存储区级层对数据进行去标识化。
过滤条件
在 DICOM 存储区级层对 DICOM 数据进行去标识化时，您可以通过配置过滤条件文件并在 dicomStores.deidentify 请求中指定该文件，对 DICOM 存储区中的一部分数据进行去标识化。如需查看示例，请参阅对 DICOM 存储区的一部分数据进行去标识化。
示例概览
本指南中的示例使用单个名为 dicom_deid_instance_sample.dcm 的 DICOM 实例，但您也可以对多个实例进行去标识化。如需使用本页示例中的示例 DICOM 实例，请将该文件下载到本地机器，然后按照存储 DICOM 数据中的说明将其存储在 DICOM 存储区中。
以下部分展示了 DICOM 实例中的图片以及实例中的元数据。
示例图片
本页中的部分示例包含去标识化后的图片输出。每个示例都使用以下原始图片作为其输入。您可以将每个去标识化操作的输出图片与该原始图片进行比较，以查看该操作的效果：
示例元数据
本页中的大多数示例都包含 DICOM 实例中已更改元数据的输出。每个示例都使用以下原始元数据作为其输入。您可以将每个去标识化操作的输出元数据与该原始元数据进行比较，以查看去标识化的效果：
[
{
"00020002": {
"vr": "UI",
"Value": [
"1.2.840.10008.5.1.4.1.1.7"
]
},
"00020003": {
"vr": "UI",
"Value": [
"1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"
]
},
"00020010": {
"vr": "UI",
"Value": [
"1.2.840.10008.1.2.4.50"
]
},
"00020012": {
"vr": "UI",
"Value": [
"1.2.276.0.7230010.3.0.3.6.1"
]
},
"00020013": {
"vr": "SH",
"Value": [
"OFFIS_DCMTK_361"
]
},
"00080005": {
"vr": "CS",
"Value": [
"ISO_IR 100"
]
},
"00080016": {
"vr": "UI",
"Value": [
"1.2.840.10008.5.1.4.1.1.7"
]
},
"00080018": {
"vr": "UI",
"Value": [
"1.2.276.0.7230010.3.1.4.8323329.78.1539083058.523695"
]
},
"00080020": {
"vr": "DA",
"Value": [
"20110909"
]
},
"00080030": {
"vr": "TM",
"Value": [
"110032"
]
},
"00080050": {
"vr": "SH"
},
"00080064": {
"vr": "CS",
"Value": [
"WSD"
]
},
"00080070": {
"vr": "LO",
"Value": [
"Manufacturer"
]
},
"00080090": {
"vr": "PN",
"Value": [
{
"Alphabetic": "John Doe"
}
]
},
"00081090": {
"vr": "LO",
"Value": [
"ABC1"
]
},
"00100010": {
"vr": "PN",
"Value": [
{
"Alphabetic": "Ann Johnson"
}
]
},
"00100020": {
"vr": "LO",
"Value": [
"S1214223-1"
]
},
"00100030": {
"vr": "DA",
"Value": [
"19880812"
]
},
"00100040": {
"vr": "CS",
"Value": [
"F"
]
},
"0020000D": {
"vr": "UI",
"Value": [
"2.25.70541616638819138568043293671559322355"
]
},
"0020000E": {
"vr": "UI",
"Value": [
"1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694"
]
},
"00200010": {
"vr": "SH"
},
"00200011": {
"vr": "IS"
},
"00200013": {
"vr": "IS"
},
"00200020": {
"vr": "CS"
},
"00280002": {
"vr": "US",
"Value": [
3
]
},
"00280004": {
"vr": "CS",
"Value": [
"YBR_FULL_422"
]
},
"00280006": {
"vr": "US",
"Value": [
0
]
},
"00280010": {
"vr": "US",
"Value": [
1024
]
},
"00280011": {
"vr": "US",
"Value": [
1024
]
},
"00280100": {
"vr": "US",
"Value": [
8
]
},
"00280101": {
"vr": "US",
"Value": [
8
]
},
"00280102": {
"vr": "US",
"Value": [
7
]
},
"00280103": {
"vr": "US",
"Value": [
0
]
},
"00282110": {
"vr": "CS",
"Value": [
"01"
]
},
"00282114": {
"vr": "CS",
"Value": [
"ISO_10918_1"
]
}
}
]
隐去图片中的内置文本
您可以使用 Action 对象内的 ImageConfig 对象对 DICOM 图片中的内置文本进行去标识化处理。在 ImageConfig 中，您可以指定要包含或排除哪些 infoType，以及如何使用 TextRedactionMode 对象隐去文本。
遮盖所有文字
以下示例展示了如何通过将 TextRedactionMode 设置为 REDACT_ALL_TEXT 来对 DICOM 实例进行去标识化。此配置会隐去图片中的所有烧屏文字。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_ALL_TEXT" } } } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_ALL_TEXT" } } } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_ALL_TEXT" } } } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
使用 REDACT_ALL_TEXT 对图片进行去标识化处理后，图片如下所示。请注意，图片底部的所有已烧屏文字均已隐去。
REDACT_ALL_TEXT 去标识化后的 DICOM 实例。使用“清除描述符”选项隐去敏感文本
以下示例展示了如何通过将 TextRedactionMode 设置为 REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 来对 DICOM 实例进行去标识化处理。
如需详细了解 CleanDescriptorsOption 选项，请参阅使用情境去标识化功能对文本进行去标识化。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS" } } } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS" } } } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "cleanImage": { "textRedactionMode": "REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS" } } } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
使用 REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 对图片进行去标识化处理后，图片如下所示。请注意，图片底部的部分已烧屏文字并未被隐去。系统仍会显示文本 Female，因为 PatientSex (0010,0040) 不是默认 DICOM infoType 之一。
REDACT_SENSITIVE_TEXT_CLEAN_DESCRIPTORS 去标识化后的 DICOM 实例。对 DICOM 标记进行去标识化
您可以根据 DICOM 元数据中的标记关键字对 DICOM 实例进行去标识化。
以下标记过滤方法可在 DicomTagConfig Action 对象中使用：
您可以将每个 Action 选项指定为 DICOM 标记 ID、名称或值表示法 (VR) 的列表，然后该选项会对列表中的标记执行操作。您不能在代码列表中指定多个 Action 选项。
每个 Action 对象都提供一个 queries[] 列表，您可以在其中指定标记列表。支持以下代码格式：
- 代码 ID，例如
"00100010" - 标记名称，例如
"PatientName" - 值表示法 (VR)，例如
"PN"
queries[] 列表中可提供的标记数量没有限制。不过，每个代码只能执行单个 Action 选项。如需指定要对其执行不同 Action 选项的不同代码，您必须指定多个 Action 对象。
保留代码
您可以在 DicomTagConfig 对象的 KeepTag 对象中指定标记，以防止系统隐去标记的值。
如需在使用 KeepTag 对象时生成有效的 DICOM 对象，请在 ProfileType 对象中指定 MINIMAL_KEEP_LIST_PROFILE 或 DEIDENTIFY_TAG_CONTENTS 值。
指定任一配置文件后，系统会自动保留以下标记，确保去标识化的 DICOM 实例是有效的 DICOM：
StudyInstanceUIDSeriesInstanceUIDSOPInstanceUIDTransferSyntaxUIDMediaStorageSOPInstanceUIDMediaStorageSOPClassUIDPixelDataRowsColumnsSamplesPerPixelBitsAllocatedBitsStoredHighbitPhotometricInterpretationPixelRepresentationNumberOfFramesPlanarConfigurationPixelAspectRatioSmallestImagePixelValueLargestImagePixelValueRedPaletteColorLookupTableDescriptorGreenPaletteColorLookupTableDescriptorBluePaletteColorLookupTableDescriptorRedPaletteColorLookupTableDataGreenPaletteColorLookupTableDataBluePaletteColorLookupTableDataICCProfileColorSpaceWindowCenterWindowWidthVOILUTFunction
上述某些代码段的值会重新生成，也就是说这些值将通过确定性转换替换为其他值。如需了解详情，请参阅 DICOM 标准中的保留 UID 选项。
StudyInstanceUID、SeriesInstanceUID、SOPInstanceUID 和 MediaStorageSOPInstanceUID 的值称为“主要 ID”。如需确定如何转换主 ID，请在 PrimaryIdsOption 中指定一个值。
以下示例展示了如何使用 KeepTag 对象在去标识化过程中保持特定标记的值不变。PatientName 标记会添加到 queries[] 列表中，因此在去标识化过程中，PatientName 值不会被隐去。
由于示例中未指定 PrimaryIdsOption，因此 primaryIds 字段默认为 PRIMARY_IDS_OPTION_UNSPECIFIED，而 PRIMARY_IDS_OPTION_UNSPECIFIED 默认为 ProfileType 中的值。由于未指定 ProfileType，因此 profileType 字段默认为 PROFILE_TYPE_UNSPECIFIED，这会根据 Attribute Confidentiality Basic Profile (DICOM Standard Edition 2018e) 移除标记。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "keepTag": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "keepTag": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "keepTag": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
移除标记
以下示例展示了如何在去标识化过程中使用 RemoveTag 对象移除特定标记的值。移除的标记会替换为空值。
在以下示例中，PatientName 标记添加到 queries[] 列表中，因此其值会在去标识化期间替换为空值。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "removeTag": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "removeTag": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "removeTag": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
删除标记
以下示例展示了如何在去标识化过程中使用 DeleteTag 对象删除特定标记。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "deleteTag": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "deleteTag": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "deleteTag": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
将代码重置为占位符值
以下示例展示了如何在去标识化过程中使用 ResetTag 对象将标记的值设置为字符串 PLACEHOLDER。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "resetTag": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "resetTag": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "resetTag": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
特别要注意的是，
PatientName标记的值设置为PLACEHOLDER：Original metadata运行 ResetTag后的元数据"00100010": { "vr": "PN", "Value": [ { "Alphabetic": "Ann Johnson" } ] }"00100010": { "vr": "PN", "Value": [ { "Alphabetic": "PLACEHOLDER" } ] }
检查和转换标记中的敏感文本
以下示例展示了如何使用 CleanTextTag 对象检查标记，并根据 TextConfig 对象中的配置转换标记的值。
在这些示例中，Actions 对象中设置了以下选项：
CleanTextTag对象。- 包含
PatientNameDICOM 标记的queries[]列表。
在 TextConfig 对象中设置以下选项：
- 用于转换与特定 infoType 匹配的文本的
InfoTypeTransformation对象。 - 一个
ReplaceWithInfoTypeConfig对象，用于将任何匹配的文本替换为 infoType 的名称。 - 包含
PERSON_NAMEinfoType 的infoTypes[]列表。
设置完这些配置后，去标识化操作会检查 PatientName 标记，将该标记与 PERSON_NAME infoType 进行匹配，并将该标记的值替换为 PERSON_NAME infoType。PatientName 标记的值表示法 (VR) 为 PN，这是 CleanTextTag 对象中受支持的 VR 之一。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "cleanTextTag": {} } ] }, "text": { "additionalTransformations": [ { "infoTypes": [ "PERSON_NAME" ], "replaceWithInfoTypeConfig": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "cleanTextTag": {} } ] }, "text": { "additionalTransformations": [ { "infoTypes": [ "PERSON_NAME" ], "replaceWithInfoTypeConfig": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "cleanTextTag": {} } ] }, "text": { "additionalTransformations": [ { "infoTypes": [ "PERSON_NAME" ], "replaceWithInfoTypeConfig": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
特别要注意的是，
PatientName标记的值设置为[PERSON_NAME]：Original metadata运行 CleanTextTag后的元数据"00100010": { "vr": "PN", "Value": [ { "Alphabetic": "Ann Johnson" } ] }"00100010": { "vr": "PN", "Value": [ { "Alphabetic": "[PERSON_NAME]" } ] }
将 UID 替换为生成的 UID
以下示例展示了如何使用 RegenUidTag 对象将 UID 替换为新生成的 UID。RegenUidTag 对象支持的唯一 VR 是 UI。
默认情况下，样本元数据中 VR 为 UI 的每个标记都会在去标识化期间生成 UID。为了演示如何为特定代码生成 UID，示例中设置了以下选项：
ProfileType设置为KEEP_ALL枚举，这会阻止对任何 DICOM 元数据进行去标识化处理。PrimaryIdsOption会设为KEEP枚举，这会使主要 ID（StudyInstanceUID、SeriesInstanceUID、SOPInstanceUID和MediaStorageSOPInstanceUID）保持不变。
设置这些选项后，示例数据中的任何主要 ID UID 都不会替换为新生成的值。不过，通过向 Action.queries[] 数组添加 SOPInstanceUID，您可以为 SOPInstanceUID 代码专门生成新的 UID。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "primaryIds": "KEEP" }, "actions": [ { "queries": [ "00080018" ], "regenUidTag": {} } ], "profileType": "KEEP_ALL_PROFILE" } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "primaryIds": "KEEP" }, "actions": [ { "queries": [ "00080018" ], "regenUidTag": {} } ], "profileType": "KEEP_ALL_PROFILE" } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "options": { "primaryIds": "KEEP" }, "actions": [ { "queries": [ "00080018" ], "regenUidTag": {} } ], "profileType": "KEEP_ALL_PROFILE" } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。由于您在
Action.queries[]数组中指定了SOPInstanceUID标记，因此去标识化后的实例具有新的实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了实例 UID 的变化情况：
原始实例元数据 去标识化的实例元数据 实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/2.25.70541616638819138568043293671559322355/series/1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/2.25.70541616638819138568043293671559322355/series/1.2.276.0.7230010.3.1.3.8323329.78.1531234558.523694/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
请注意，在主要 ID 中，只有
SOPInstanceUID具有新生成的 UID。
递归地对嵌套 Sequence 中的标记进行去标识化
以下示例展示了如何使用 RecurseTag 对象递归地去标识 Sequence 中的嵌套 DICOM 标记。RecurseTag 对象仅支持 SQ VR，即 Sequence 的 VR。
如需了解 SQ VR，请参阅 7.5 数据集的嵌套。
为本页面提供的 DICOM 示例实例不包含任何具有 SQ VR 的 DICOM 标记。您可以完成以下步骤（基于使用 JSON 元数据和 JPEG 文件创建 DICOM 实例中的说明），创建并存储包含 SQ VR 的虚构数据的 DICOM 实例。您在以下步骤中创建的 DICOM 实例使用的是虚构数据，仅用于说明 RecurseTag 的行为。
将以下 DICOM 元数据保存到名为
instance.json的 JSON 文件中。元数据包含PhysiciansReadingStudyIdentificationSequence(00081062) 标记。该标记具有SQVR，并包含两个嵌套的PersonIdentificationCodeSequence(00401101) 标记。嵌套标记也具有SQVR，并且每个嵌套标记都包含以下嵌套标记：CodeValue（00080100）CodingSchemeDesignator（00080102）
[{ "00020010": { "vr": "UI", "Value": [ "1.2.840.10008.1.2.4.50" ] }, "00080005": { "vr": "CS", "Value": [ "ISO_IR 192" ] }, "00080016": { "vr": "UI", "Value": [ "1111111" ] }, "00080018": { "vr": "UI", "Value": [ "2222222" ] }, "0020000D": { "vr": "UI", "Value": [ "3333333" ] }, "0020000E": { "vr": "UI", "Value": [ "4444444" ] }, "00280002": { "vr": "US", "Value": [ 3 ] }, "00280004": { "vr": "CS", "Value": [ "YBR_FULL_422" ] }, "00280006": { "vr": "US", "Value": [ 0 ] }, "00280008": { "vr": "IS", "Value": [ 1 ] }, "00280010": { "vr": "US", "Value": [ 1024 ] }, "00280011": { "vr": "US", "Value": [ 1024 ] }, "00280100": { "vr": "US", "Value": [ 8 ] }, "00280101": { "vr": "US", "Value": [ 8 ] }, "00280102": { "vr": "US", "Value": [ 7 ] }, "00280103": { "vr": "US", "Value": [ 0 ] }, "7FE00010": { "vr": "OB", "BulkDataURI": "jpeg-image" }, "00081062": { "vr": "SQ", "Value": [ { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "CodeValue1" ] }, "00080102": { "vr": "SH", "Value": [ "CodingSchemeDesignator1" ] } } ] } }, { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "CodeValue2" ] }, "00080102": { "vr": "SH", "Value": [ "CodingSchemeDesignator2" ] } } ] } } ] } }]将
google.jpg文件下载到本地机器。Cloud Healthcare API DICOMweb API 接受与 JSON 元数据配对的任何 JPEG 图片，前提是元数据有效。运行以下命令，在图片中创建起始（用于 JSON 元数据）、中间（针对 JPEG）图片和结束边界：
echo -ne "--DICOMwebBoundary\r\nContent-Type: application/dicom+json\r\n\r\n" > opening.file echo -ne "\r\n--DICOMwebBoundary\r\nContent-Location: jpeg-image\r\nContent-Type: image/jpeg; transfer-syntax=1.2.840.10008.1.2.4.50\r\n\r\n" > middle.file echo -ne "\r\n--DICOMwebBoundary--" > closing.file将
google.jpg图片封装在中间和结束边界内。您发送到 Cloud Healthcare API 的输出文件称为multipart-request.file：cat opening.file instance.json middle.file google.jpg closing.file > multipart-request.file存储
multipart-request.file文件：REST
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DICOM_STORE_ID：源数据集中 DICOM 存储区的 ID
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: multipart/related; type=\"application/dicom+json\"; boundary=DICOMwebBoundary" \
--data-binary @multipart-request.file \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID/dicomWeb/studies"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-InFile multipart-request.file `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID/dicomWeb/studies" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
请完成以下步骤，对您存储的 DICOM 实例进行去标识化处理。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
请求 JSON 正文：
{ "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PhysiciansReadingStudyIdentificationSequence" ], "recurseTag": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PhysiciansReadingStudyIdentificationSequence" ], "recurseTag": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationDataset": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PhysiciansReadingStudyIdentificationSequence" ], "recurseTag": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：
原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)33333331.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314系列 UID ( 0020000E)44444441.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347实例 UID ( 00080018)22222221.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与第 1 步中的原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314/series/1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347/instances/1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.222168347996079463826250565085126257314/series/1.3.6.1.4.1.11129.5.1.25205702030237830896398173746777399347/instances/1.3.6.1.4.1.11129.5.1.286710307126045768765142714621897494633/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
请特别注意，嵌套的
CodeValue和CodingSchemaDesignator标记的值已设置为PLACEHOLDER：Original metadata运行 RecurseTag后的元数据{ "00081062": { "vr": "SQ", "Value": [ { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "CodeValue1" ] }, "00080102": { "vr": "SH", "Value": [ "CodingSchemeDesignator1" ] } } ] } }, { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": ["CodeValue2"] }, "00080102": { "vr": "SH", "Value": ["CodingSchemeDesignator2"] } } ] } } ] } }{ "00081062": { "vr": "SQ", "Value": [ { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "PLACEHOLDER" ] }, "00080102": { "vr": "SH", "Value": [ "PLACEHOLDER" ] } } ] } }, { "00401101": { "vr": "SQ", "Value": [ { "00080100": { "vr": "SH", "Value": [ "PLACEHOLDER" ] }, "00080102": { "vr": "SH", "Value": [ "PLACEHOLDER" ] } } ] } } ] } }
在 DICOM 存储区级层对数据进行去标识化
前面的示例展示了如何在数据集级层对 DICOM 数据进行去标识化。本部分介绍如何对 DICOM 存储区级层的数据进行去标识化。
如需将数据集去标识化请求更改为 DICOM 存储区去标识化请求，请进行以下更改：
- 将请求正文中的
destinationDataset替换为destinationStore - 在指定目标位置时，在
destinationStore中的值末尾添加dicomStores/DESTINATION_DICOM_STORE_ID - 在指定源数据所在的位置时添加
dicomStores/SOURCE_DICOM_STORE_ID
以下示例展示了数据集级去标识化请求，以及如何修改该请求以进行 DICOM 存储区级去标识化：
数据集级层去标识化：
"destinationDataset": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID" ... "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID:deidentify"
DICOM 存储区级层去标识化：
"destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID" ... "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"
以下示例展示了如何对 DICOM 存储区中的 DICOM 实例进行去标识化，并将去标识化后的数据写入新的 DICOM 存储区。在运行示例之前，目标 DICOM 存储区 ID 必须已存在。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要写入去标识化数据的目标数据集的 ID。必须已存在，然后才能运行去标识化操作。
- DESTINATION_DICOM_STORE_ID：目标数据集中的 DICOM 存储区。必须已存在，然后才能运行去标识化操作。
请求 JSON 正文：
{ "destinationStore": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "keepTag": {} } ] } } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作 (LRO) 的标识符。当方法调用可能需要额外时间才能完成时，会返回长时间运行的操作。记下curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationStore": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "keepTag": {} } ] } } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationStore": "projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicomTagConfig": { "actions": [ { "queries": [ "PatientName" ], "keepTag": {} } ] } } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID:deidentify" | Select-Object -Expand ContentOPERATION_ID的值。下一步中您需要用到该值。使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
对 DICOM 存储区的一部分进行去标识化
通过指定过滤条件，您可以对 DICOM 存储区中的部分数据进行去标识化。
过滤条件采用过滤条件文件的形式，您可以指定它作为 DicomFilterConfig 对象中 resourcePathsGcsUri 字段的值。Cloud Storage 存储分区中必须已存在过滤条件文件；您不能指定本地计算机或任何其他来源上存在的过滤条件文件。文件的位置必须采用 gs://BUCKET/PATH/TO/FILE 格式。
创建过滤条件文件
过滤条件文件定义要将哪些 DICOM 文件进行去标识化。您可以在以下级别过滤文件：
- 在研究级别
- 在系列级别
- 在实例级别
在过滤条件文件中，您要进行去标识化的每个研究、系列或实例分别对应一行内容。每行都使用 /studies/STUDY_UID[/series/SERIES_UID[/instances/INSTANCE_UID]] 格式。每行末尾有一个换行符：\n 或 \r\n。
如果您在调用去标识化操作时传递的过滤条件文件中未指定研究、系列或实例，则该研究、系列或实例不会进行去标识化，并且不会出现在目标 DICOM 存储区中。
只需要提供路径的 /studies/STUDY_UID 部分。这意味着您可以通过指定 /studies/STUDY_UID 对研究进行去标识化，也可以通过指定 /studies/STUDY_UID/series/SERIES_UID 对系列进行去标识化。
请考虑以下过滤条件文件。过滤条件文件会导致一项研究、两个系列和三个单独的实例进行去标识化：
/studies/1.123.456.789
/studies/1.666.333.111/series/123.456\n
/studies/1.666.333.111/series/567.890\n
/studies/1.888.999.222/series/123.456/instances/111\n
/studies/1.888.999.222/series/123.456/instances/222\n
/studies/1.888.999.222/series/123.456/instances/333\n
使用 BigQuery 创建过滤条件文件
要创建过滤条件文件，您通常需要先将 DICOM 存储区中的元数据导出到 BigQuery。这样，您就可以使用 BigQuery 来查看 DICOM 存储区中 DICOM 数据的研究、系列和实例 UID。然后，您可以执行以下操作：
查询您感兴趣的研究、系列和实例 UID。例如，将元数据导出到 BigQuery 后，您可以运行以下查询，将研究、系列和实例 UID 串接为符合过滤条件文件要求的格式：
SELECT CONCAT ('/studies/', StudyInstanceUID, '/series/', SeriesInstanceUID, '/instances/', SOPInstanceUID) FROM [PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE]
如果查询返回大型结果集，您可以通过将查询结果保存到 BigQuery 中的目标表将新表具体化。
将查询结果保存到目标表后，您可以将目标表的内容保存到文件中，并将文件导出到 Cloud Storage。如需了解如何执行此操作，请参阅导出表数据。导出的文件就是您的过滤条件文件。在导出操作中指定过滤条件时，您将使用 Cloud Storage 中的过滤条件文件所在的位置。
手动创建过滤条件文件
您可以创建包含自定义内容的过滤条件文件，然后将其上传到 Cloud Storage 存储分区。在去标识化操作中指定过滤条件时，您将使用 Cloud Storage 中的过滤条件文件所在的位置。以下示例展示了如何使用 gcloud storage cp 命令将过滤条件文件上传到 Cloud Storage 存储分区：
gcloud storage cp PATH/TO/FILTER_FILE gs://BUCKET/DIRECTORY
例如：
gcloud storage cp /home/user/Desktop/filters.txt gs://my-bucket/my-directory
使用过滤器
配置过滤条件文件后，您可以将其作为值传递到 filterConfig 对象中的 resourcePathsGcsUri 字段。
以下示例对在 DICOM 存储区级层对数据进行去标识化进行了扩展，但提供了 Cloud Storage 中的过滤条件文件，用来确定哪些 DICOM 资源要进行去标识化。
REST
对数据集进行去标识化处理。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- LOCATION：数据集位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DICOM_STORE_ID：包含要去标识化的数据的 DICOM 存储区的 ID
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID
- BUCKET/PATH/TO/FILE：过滤条件文件在 Cloud Storage 存储分区中的位置
请求 JSON 正文：
{ "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }, "filterConfig": { "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE" } }如需发送请求，请选择以下方式之一：
输出如下所示。响应包含长时间运行的操作的标识符。当方法调用可能需要大量时间才能完成时，会返回长时间运行的操作。记下 OPERATION_ID 的值。下一步中您需要用到该值。curl
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：cat > request.json << 'EOF' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }, "filterConfig": { "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE" } } EOF然后，执行以下命令以发送 REST 请求：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify"PowerShell
将请求正文保存在名为
request.json的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：@' { "destinationStore": "projects/PROJECT_ID/locations/LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID", "config": { "dicom": { "filterProfile": "DEIDENTIFY_TAG_CONTENTS" }, "image": { "textRedactionMode": "REDACT_ALL_TEXT" } }, "filterConfig": { "resourcePathGcsUri": "gs://BUCKET/PATH/TO/FILE" } } '@ | Out-File -FilePath request.json -Encoding utf8然后，执行以下命令以发送 REST 请求：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/SOURCE_DATASET_ID/dicomStores/SOURCE_DICOM_STORE_ID:deidentify" | Select-Object -Expand Content使用
projects.locations.datasets.operations.get方法获取长时间运行的操作的状态。在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- SOURCE_DATASET_ID：包含要去标识化的数据的数据集的 ID
- OPERATION_ID：从长时间运行的操作返回的 ID
如需发送请求，请选择以下方式之一：
输出如下所示。如果响应包含curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/SOURCE_DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
"done": true，则表示长时间运行的操作已完成。在去标识化操作成功后，您可以检索去标识化后的实例的元数据以查看其更改情况。去标识化后的实例具有新的研究 UID、系列 UID 和实例 UID，因此您首先需要在新数据集中搜索去标识化后的实例。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/instances" | Select-Object -Expand Content您应该收到类似以下内容的 JSON 响应：
下表显示了研究 UID、系列 UID 和实例 UID 的变化情况：原始实例元数据 去标识化的实例元数据 研究 UID ( 0020000D)2.25.705416166388191385680432936715593223551.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763系列 UID ( 0020000E)1.2.276.0.7230010.3.1.3.8323329.78.1531234558.5236941.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710实例 UID ( 00080018)1.2.276.0.7230010.3.1.4.8323329.78.1539083058.5236951.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029使用新值检索实例的元数据。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的 Google Cloud 项目的 ID
- DESTINATION_DATASET_ID：要将去标识化数据写入到的目标数据集的 ID
- SOURCE_DATASET_LOCATION：来源数据集的位置
- DESTINATION_DICOM_STORE_ID：目标数据集中 DICOM 存储区的 ID。此 ID 与源数据集中的 DICOM 存储区的 ID 相同。
如需发送请求，请选择以下方式之一：
输出包含新的元数据。您可以将新元数据与原始元数据进行比较，以查看转换的效果。curl
执行以下命令：
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata"PowerShell
执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/SOURCE_DATASET_LOCATION/datasets/DESTINATION_DATASET_ID/dicomStores/DESTINATION_DICOM_STORE_ID/dicomWeb/studies/1.3.6.1.4.1.11129.5.1.201854290391432893460946240745559593763/series/1.3.6.1.4.1.11129.5.1.303327499491957026103380014864616068710/instances/1.3.6.1.4.1.11129.5.1.97415866390999888717168863957686758029/metadata" | Select-Object -Expand ContentAPI Explorer
打开方法参考页面。APIs Explorer 面板会在页面右侧打开。您可以与此工具进行交互以发送请求。 填写所有必填字段，然后点击执行。
排查 DICOM 去标识化操作问题
如果在执行 DICOM 去标识化操作期间发生错误，系统会将错误记录到 Cloud Logging。如需了解详情，请参阅在 Cloud Logging 中查看错误日志。
如果整个操作返回错误，请参阅排查长时间运行的操作问题。