Démarrage rapide avec l'outil de ligne de commande gcloud

Le guide de démarrage rapide suivant fonctionne avec la version v1beta1 de l'API Cloud Healthcare.

Cette page explique comment utiliser l'outil gcloud pour créer, mettre à jour et afficher les détails d'un ensemble de données, et créer des datastores FHIR, HL7v2 ou DICOM. Elle décrit également la procédure à suivre pour nettoyer les ressources que vous avez créées.

Avant de commencer

  1. Connectez-vous à votre compte Google.

    Si vous n'en possédez pas déjà un, vous devez en créer un.

  2. Dans Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Cloud.

    Accéder à la page de sélection du projet

  3. Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez Cloud Healthcare API.

    Activer l'API

  5. Selon votre utilisation de l'outil de ligne de commande gcloud, effectuez l'une des opérations suivantes :
    • Si vous utilisez Google Cloud Shell, accédez à Google Cloud Console, puis cliquez sur le bouton Activer Cloud Shell en haut de la fenêtre de la console.

      Accéder à Google Cloud Console

      Une session Google Cloud Shell s'ouvre dans un nouveau cadre en bas de la console et affiche une invite de ligne de commande. L'initialisation de la session Shell peut prendre quelques secondes.

    • Si vous utilisez une machine virtuelle Compute Engine, ouvrez la fenêtre de terminal de la machine virtuelle.
    • Si vous utilisez l'outil gcloud sur votre ordinateur, installez et initialisez le SDK Cloud.

Créer un ensemble de données

Les ensembles de données sont les conteneurs de base dans lesquels sont stockées les données médicales dans Google Cloud. Pour utiliser l'API Cloud Healthcare, vous devez créer au moins un ensemble de données.

Conseil : Vous pouvez modifier sur cette page les valeurs des espaces réservés dans les requêtes, indiquées par la syntaxe VARIABLES, puis copier l'intégralité de la commande.

Pour créer un ensemble de données, exécutez la commande gcloud beta healthcare datasets create.

  • L'élément DATASET_ID doit être unique dans la région. Il peut s'agir de n'importe quelle chaîne Unicode de 1 à 256 caractères composée de chiffres, de lettres, de traits de soulignement, de tirets et de points.
  • La région peut être us-central1, us-west2, europe-west2, europe-west4, northamerica-northeast1, southamerica-east1, asia-east2, asia-northeast1, asia-southeast1,australia-southeast1 ou us. Pour utiliser la région par défaut du projet, omettez l'option --location.

L'exemple suivant montre comment créer un ensemble de données.

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

Si la requête aboutit, l'invite de commande affiche :

Created dataset [DATASET_ID].

Obtenir les détails d'un ensemble de données

Vous pouvez afficher les détails de l'ensemble de données pour vérifier qu'il a bien été créé.

Pour afficher les détails d'un ensemble de données, exécutez la commande gcloud beta healthcare datasets describe :

L'exemple suivant montre comment obtenir des détails sur un ensemble de données.

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

Si la requête aboutit, l'invite de commande affiche les détails de l'ensemble de données :

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

Modifier un ensemble de données

Pour modifier un ensemble de données, exécutez la commande gcloud beta healthcare datasets update.

L'exemple suivant montre comment modifier le fuseau horaire d'un ensemble de données. Par exemple, vous pouvez définir le fuseau horaire sur "Canada/Est".

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

Si la requête aboutit, l'invite de commande affiche les détails de l'opération et de l'ensemble de données :

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

Créer et gérer des datastores DICOM, HL7v2 et FHIR

Pour suivre ce guide de démarrage rapide, développez la section correspondante :

Nettoyer

Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, vous pouvez nettoyer les ressources créées sur Google Cloud.

Si vous avez créé un projet pour ce tutoriel, suivez les étapes décrites dans la section Supprimer le projet. Sinon, suivez la procédure décrite dans la section Supprimer l'ensemble de données.

Supprimer le projet

  1. Dans Cloud Console, accédez à la page Gérer les ressources.

    Accéder à la page Gérer les ressources

  2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer .
  3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Supprimer l'ensemble de données

Si vous n'avez plus besoin de l'ensemble de données créé dans ce guide de démarrage rapide, vous pouvez le supprimer. La suppression d'un ensemble de données entraîne la suppression définitive de l'ensemble de données et des datastores FHIR, HL7v2 ou DICOM qu'il contient.

Pour supprimer un ensemble de données, exécutez la commande gcloud beta healthcare datasets delete :

  1. Exécutez la commande gcloud beta healthcare datasets delete.

    gcloud beta healthcare datasets delete DATASET_ID \
      --location=LOCATION \
    --project=PROJECT_ID
    
  2. Pour confirmer, saisissez Y.

Si la requête aboutit, l'invite de commande affiche :

Deleted dataset [DATASET_ID].

Étape suivante