快速入门:使用 gcloud 命令行工具

以下快速入门适用于 Cloud Healthcare API 的 v1beta1 版本。

本页面介绍了如何使用 gcloud 工具创建、更新和查看有关数据集的详细信息,以及如何创建 FHIR、HL7v2 或 DICOM 存储区。它还提供了清理您所创建资源的步骤。

准备工作

  1. 登录您的 Google 帐号。

    如果您还没有 Google 帐号,请注册一个新帐号

  2. 在 Cloud Console 的项目选择器页面上,选择或创建 Cloud 项目。

    转到项目选择器页面

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

  4. 启用 Cloud Healthcare API。

    启用 API

  5. 根据您使用 gcloud 命令行工具的方式,完成以下任一步骤:
    • 如果您使用的是 Google Cloud Shell,请转到 Google Cloud Console,然后点击控制台窗口顶部的激活 Cloud Shell按钮。

      转到 Google Cloud Console

      一个 Cloud Shell 会话随即会在控制台底部的新框内打开,并显示命令行提示符。该 Shell 会话可能需要几秒钟来完成初始化。

    • 如果您使用的是 Compute Engine 虚拟机,请打开虚拟机的终端窗口。
    • 如果您在机器上使用 gcloud 工具,请安装并初始化 Cloud SDK

创建数据集

数据集是在 Google Cloud 中保存医疗保健数据的基本容器。要使用 Cloud Healthcare API,您必须至少创建一个数据集。

提示:您可以在此页面的请求中修改占位符值(以VARIABLES 语法表示),然后复制整个命令。

要创建数据集,请运行 gcloud beta healthcare datasets create 命令。

  • DATASET_ID 在该区域内必须是唯一的。它可以是 1 到 256 个字符的任意 Unicode 字符串,由数字、字母、下划线、短划线和句点组成。
  • 区域可以是 us-central1us-west2europe-west2europe-west4northamerica-northeast1southamerica-east1asia-east2asia-northeast1asia-southeast1australia-southeast1us。 要使用项目的默认区域,请省略 --location 选项。

以下示例显示了如何创建数据集。

gcloud beta healthcare datasets create DATASET_ID \
    --location=LOCATION \
    --project=PROJECT_ID

如果请求成功,命令提示符将显示:

Created dataset [DATASET_ID].

获取数据集详情

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

要获取有关数据集的详细信息,请运行 gcloud beta healthcare datasets describe 命令。

以下示例展示了如何获取有关数据集的详细信息。

gcloud beta healthcare datasets describe DATASET_ID \
    --location=LOCATION \
    --project=PROJECT_ID

如果请求成功,命令提示符将显示数据集详情。

name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID

编辑数据集

要更新数据集,请运行 gcloud beta healthcare datasets update 命令。

以下示例展示了如何更新数据集的时区。例如,您可以将时区设置为“加拿大/东部地区”。

gcloud beta healthcare datasets update DATASET_ID \
    --location=LOCATION \
    --time-zone=TIME_ZONE \
    --project=PROJECT_ID

如果请求成功,命令提示符将显示操作和数据集详情:

Updated dataset [DATASET_ID].
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID
timeZone: TIME_ZONE

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

要完成本快速入门,请展开相关部分:

清理

为避免系统因本快速入门中使用的资源向您的 Google Cloud 帐号收取费用,您可以清理在 Google Cloud 上创建的资源。

如果您为此教程创建了新项目,请按照删除项目中的步骤操作。否则,请按照删除数据集中的步骤操作。

删除项目

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

    转到“管理资源”页面

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

删除数据集

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

要删除数据集,请运行 gcloud beta healthcare datasets delete 命令:

  1. 运行 gcloud beta healthcare datasets delete 命令。

    gcloud beta healthcare datasets delete DATASET_ID \
      --location=LOCATION \
    --project=PROJECT_ID
    
  2. 要确认,请键入 Y

如果请求成功,命令提示符将显示:

Deleted dataset [DATASET_ID].

后续步骤