Guia de início rápido: como usar a ferramenta de linha de comando gcloud

O guia de início rápido a seguir funciona com a versão v1beta1 da API Cloud Healthcare.

Esta página mostra como usar a ferramenta gcloud para criar, atualizar e visualizar detalhes sobre um conjunto de dados e criar armazenamentos FHIR, HL7v2 ou DICOM. Ele também apresenta as etapas para limpar os recursos que você criou.

Antes de começar

  1. Faça login na sua conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

    Acessar a página do seletor de projetos

  3. Verifique se o faturamento está ativado para seu projeto na nuvem. Saiba como confirmar se o faturamento está ativado para o projeto.

  4. Ative a Cloud Healthcare API.

    Ative a API

  5. Com base em como você está usando a ferramenta de linha de comando gcloud, conclua uma das seguintes etapas:
    • Se você estiver usando o Google Cloud Shell, acesse o Console do Google Cloud e clique no botão Ativar o Cloud Shell na parte superior da janela do console.

      Ir para o Google Cloud Console

      Uma sessão do Google Cloud Shell é aberta em um novo frame na parte inferior do console e exibe um prompt de linha de comando. Pode levar alguns segundos para que a sessão do shell seja inicializada.

    • Se você estiver usando uma máquina virtual do Compute Engine, abra a janela de terminal da máquina virtual.
    • Se você estiver usando a ferramenta gcloud na sua máquina, instale e inicialize o SDK do Cloud.

Crie um conjunto de dados

Os conjuntos de dados são contêineres básicos que armazenam dados de saúde no Google Cloud. Para usar a API Cloud Healthcare, você precisa criar pelo menos um conjunto de dados.

Dica: você pode editar valores de marcador em solicitações, indicados pela sintaxe VARIABLES, nesta página e copiar o comando inteiro.

Para criar um conjunto de dados, execute o comando gcloud beta healthcare datasets create.

  • O DATASET_ID precisa ser exclusivo na região. Pode ser qualquer string Unicode de 1 a 256 caracteres que consiste em números, letras, sublinhados, traços e pontos.
  • A região pode ser us-central1, us-west2, europe-west2, europe-west4, europe-west6, northamerica-northeast1, southamerica-east1, asia-east2, asia-northeast1, asia-southeast1, australia-southeast1 ou us. Para usar a região padrão do projeto, omita a opção --location.

Veja na amostra a seguir como criar um conjunto de dados.

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

Se a solicitação for bem-sucedida, o prompt de comando exibirá:

Created dataset [DATASET_ID].

Receber detalhes do conjunto de dados

Você pode ver detalhes sobre o conjunto de dados e verificar se ele foi criado.

Para ver detalhes sobre um conjunto de dados, execute o comando gcloud beta healthcare datasets describe.

O exemplo a seguir mostra como receber detalhes sobre um conjunto de dados.

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

Se a solicitação for bem-sucedida, o prompt de comando exibirá os detalhes do conjunto de dados:

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

Editar um conjunto de dados

Para atualizar um conjunto de dados, execute o comando gcloud beta healthcare datasets update.

O exemplo a seguir mostra como atualizar o fuso horário de um conjunto de dados. Por exemplo, você pode definir o fuso horário como "Canadá/Leste".

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

Se a solicitação for bem-sucedida, o prompt de comando exibirá os detalhes da operação e do conjunto de dados:

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

Como criar e gerenciar armazenamentos DICOM, HL7v2 e FHIR

Para concluir este guia de início rápido, expanda a seção relevante:

Limpar

É possível limpar os recursos que foram criados no Google Cloud para evitar cobranças na conta do Google Cloud pelos recursos usados neste tutorial.

Se você criou um novo projeto para este tutorial, siga as etapas em Excluir o projeto. Caso contrário, siga as etapas em Excluir o conjunto de dados.

Exclua o projeto

  1. No Console do Cloud, acesse a página Gerenciar recursos:

    Acessar a página "Gerenciar recursos"

  2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
  3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

Excluir o conjunto de dados

Se você não precisar mais do conjunto de dados criado neste guia de início rápido, poderá excluí-lo. Excluir um conjunto de dados exclui permanentemente o conjunto de dados e todos os armazenamentos FHIR, HL7v2 ou DICOM que ele contém.

Para excluir um conjunto de dados, execute o comando gcloud beta healthcare datasets delete:

  1. Execute o comando gcloud beta healthcare datasets delete.

    gcloud beta healthcare datasets delete DATASET_ID \
      --location=LOCATION \
    --project=PROJECT_ID
    
  2. Para confirmar, digite Y.

Se a solicitação for bem-sucedida, o prompt de comando exibirá:

Deleted dataset [DATASET_ID].

A seguir