快速入门：使用 curl 或 Windows PowerShell

本页面介绍了如何通过 curl 和 Windows PowerShell 使用 Cloud Healthcare API 创建数据集和 DICOM、FHIR 或 HL7v2 存储区。

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号，请注册新帐号。

  2. 在 Google Cloud Console 的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到项目选择器页面

  3. 确保您的 Cloud 项目已启用结算功能。 了解如何确认您的项目是否已启用结算功能。

  4. 设置身份验证：

    1. 在 Cloud Console 中，转到创建服务帐号密钥页面。

      转到“创建服务帐号密钥”页面
    2. 从服务帐号列表中，选择新的服务帐号。
    3. 在服务帐号名称字段中，输入一个名称。

    4. 从角色列表中，选择 Project > Owner。

    5. 点击创建。包含密钥的 JSON 文件就会下载到计算机。

  5. 将环境变量 GOOGLE_APPLICATION_CREDENTIALS 设置为包含您的服务帐号密钥的 JSON 文件的路径。 此变量仅适用于当前的 shell 会话，因此，如果您打开新的会话，请重新设置该变量。

  6. 启用 Cloud Healthcare API。

    启用 API

  7. 安装并初始化 Cloud SDK。

提示：需要命令提示符？您可以使用 Google Cloud Shell。Google Cloud Shell 命令行环境已经包含 Google Cloud SDK，因此您无需再进行安装。（Google Compute Engine 虚拟机也预装了 Google Cloud SDK。）

创建数据集

数据集是在 Google Cloud 中保存医疗保健数据的基本容器。

curl

要创建数据集，请发出 POST 请求，并提供数据集的名称和访问令牌。以下示例展示了使用 curl 的 POST 请求。

设置 LOCATION 变量时，请使用 us-central1、us-west2、europe-west2、europe-west4、europe-west6、northamerica-northeast1、southamerica-east1、asia-east2、asia-northeast1、asia-southeast1、australia-southeast1 或 us。

curl -X POST \
    --data "" \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID"

如果请求成功，服务器将以 JSON 格式返回响应。响应包含长时间运行的操作的标识符。当方法调用可能需要大量时间才能完成时，会返回长时间运行的操作。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
}

响应包含操作名称。要跟踪操作的状态，您可以使用 Operation get 方法：

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"

如果请求成功，服务器将以 JSON 格式返回包含操作状态的响应。当响应包含 "done": true 时，您可以判断操作已完成。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME",
    "logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset",
    "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
  }
}

PowerShell

要创建数据集，请发出 POST 请求，并提供数据集的名称和访问令牌。以下示例展示了使用 Windows PowerShell 的 POST 请求。

设置 LOCATION 变量时，请使用 us-central1、us-west2、europe-west2、europe-west4、europe-west6、northamerica-northeast1、southamerica-east1、asia-east2、asia-northeast1、asia-southeast1、australia-southeast1 或 us。

$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }

Invoke-WebRequest `
  -Method Post `
  -Headers $headers `
  -ContentType: "application/json; charset=utf-8" `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID" | Select-Object -Expand Content

如果请求成功，服务器将以 JSON 格式返回响应。响应包含长时间运行的操作的标识符。当方法调用可能需要大量时间才能完成时，会返回长时间运行的操作。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
}

响应包含操作名称。要跟踪操作的状态，您可以使用 Operation get 方法：

$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }

Invoke-WebRequest `
  -Method Get `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content

如果请求成功，服务器将以 JSON 格式返回包含操作状态的响应。当响应包含 "done": true 时，您可以判断操作已完成。

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME",
    "logsUrl": "https://console.cloud.google.com/logs/viewer/CLOUD_LOGGING_URL"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset",
    "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
  }
}

获取数据集详情

您可以查看有关该数据集的详细信息，并验证该数据集是否已创建。

curl

要获取有关数据集的详细信息，请发出 GET 请求并提供数据集的名称和访问令牌。以下示例展示了使用 curl 的 GET 请求。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"

如果请求成功，服务器将以 JSON 格式返回响应：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
}

PowerShell

要获取有关数据集的详细信息，请发出 GET 请求并提供数据集的名称和访问令牌。以下示例展示了使用 curl 的 GET 请求。

$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }

Invoke-WebRequest `
  -Method Get `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content

如果请求成功，服务器将以 JSON 格式返回响应：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
}

创建和管理 DICOM、FHIR 和 HL7v2 存储区

要完成本快速入门，请展开相关部分：

清理

为避免系统因本快速入门中使用的资源向您的 Google Cloud 帐号收取费用，您可以清理在 Google Cloud 上创建的资源。 如果您为此教程创建了新项目，请按照删除项目中的步骤操作。否则，请按照删除数据集中的步骤操作。

删除项目

  1. 在 Cloud Console 中，转到管理资源页面。

    转到“管理资源”

  2. 在项目列表中，选择要删除的项目，然后点击删除。
  3. 在对话框中输入项目 ID，然后点击关闭以删除项目。

删除数据集

如果您不再需要在本快速入门中创建的数据集，可以将其删除。删除数据集会永久删除该数据集以及其中包含的任何 FHIR、HL7v2 或 DICOM 存储区。

curl

要删除数据集，请发出 DELETE 请求，并提供数据集的名称和访问令牌。以下示例展示了使用 curl 的 DELETE 请求。

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"

如果请求成功，服务器将以 JSON 格式返回响应：

{}

PowerShell

要删除数据集，请发出 DELETE 请求，并提供数据集的名称和访问令牌。以下示例展示了使用 Windows PowerShell 的 DELETE 请求。

$cred = gcloud auth application-default print-access-token
$headers = @{ Authorization = "Bearer $cred" }

Invoke-WebRequest `
  -Method Delete `
  -Headers $headers `
  -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content

如果请求成功，服务器将以 JSON 格式返回响应：

{}

后续步骤