Cette page explique comment créer, modifier, afficher, répertorier et supprimer des magasins DICOM (Digital Imaging and Communications in Medicine).
Les stores sDICOM contiennent des instances DICOM. Vous pouvez ajouter et gérer des instances DICOM dans un store DICOM à l'aide de la mise en œuvre DICOMweb dans l'API Cloud Healthcare, ou vous pouvez importer et exporter des instances DICOM à l'aide des services Google Cloud .
Pour en savoir plus sur la conformité de l'API Cloud Healthcare à la norme DICOM, consultez la déclaration de conformité DICOM.
Créer un magasin DICOM
Pour pouvoir créer un datastore DICOM, vous devez d'abord créer un ensemble de données.
Les exemples suivants montrent comment créer un datastore DICOM :
Pour créer un magasin DICOM, procédez comme suit :
- Dans la console Google Cloud, accédez à la page "Ensembles de données".
- Sélectionnez l'ensemble de données dans lequel vous souhaitez créer un magasin DICOM.
- Cliquez sur Créer un datastore.
- Sélectionnez DICOM comme type de magasin.
- Saisissez un nom unique dans votre ensemble de données. Si le nom n'est pas unique, la création du magasin de données échoue.
- Cliquez sur Next (Suivant).
-
Si vous souhaitez configurer un sujet Pub/Sub pour le datastore, cliquez sur Recevoir des notifications Cloud Pub/Sub et sélectionnez le nom du sujet.
Lorsque vous spécifiez un thème Pub/Sub, saisissez l'URI qualifié du thème, comme indiqué dans l'exemple suivant :
projects/
PROJECT_ID /topics/PUBSUB_TOPIC - Cliquez sur Next (Suivant).
- Pour ajouter un ou plusieurs libellés au magasin, cliquez sur Ajouter des libellés pour organiser vos datastores, puis saisissez le libellé de clé-valeur. Pour en savoir plus sur les libellés de ressources, consultez la page Utiliser des libellés de ressources.
- Cliquez sur Create (Créer).
Le nouveau datastore apparaît dans la liste.
Pour créer un store DICOM, exécutez la commande gcloud healthcare dicom-stores create
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du store DICOMDATASET_ID
: identifiant du store DICOM. L'ID du store DICOM doit comporter les éléments suivants :DICOM_STORE_ID - Un ID unique dans son ensemble de données
- Une chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
- Numéros
- Lettres
- Traits de soulignement
- Tirets
- Points
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores createDICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores createDICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores createDICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable à celui-ci :
Réponse
Created dicomStore [DICOM_STORE_ID ].
Pour créer un magasin DICOM, utilisez la méthode projects.locations.datasets.dicomStores.create
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du store DICOMDATASET_ID
: identifiant du store DICOM. L'ID du store DICOM doit comporter les éléments suivants :DICOM_STORE_ID - Un ID unique dans son ensemble de données
- Une chaîne Unicode de 1 à 256 caractères composée des éléments suivants :
- Numéros
- Lettres
- Traits de soulignement
- Tirets
- Points
Pour envoyer votre requête, choisissez l'une des options suivantes :
Exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores?dicomStoreId=DICOM_STORE_ID "
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores?dicomStoreId=DICOM_STORE_ID " | Select-Object -Expand Content
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID " }
Modifier un magasin DICOM
Les exemples suivants montrent comment apporter les modifications suivantes à un magasin DICOM :
- Modifiez le sujet Pub/Sub auquel l'API Cloud Healthcare envoie des notifications de modification du magasin DICOM.
- Modifiez les libellés. Les libellés sont des paires clé/valeur qui vous aident à organiser vos ressources Google Cloud .
projects/PROJECT_ID /topics/PUBSUB_TOPIC
Pour modifier un magasin DICOM, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Sélectionnez l'ensemble de données contenant le magasin DICOM que vous souhaitez modifier.
- Dans la liste Datastores, cliquez sur le magasin que vous souhaitez modifier.
- Si vous souhaitez configurer un sujet Pub/Sub pour le data store, sélectionnez le nom du sujet dans Sélectionner un sujet Cloud Pub/Sub.
- Pour ajouter une ou plusieurs étiquettes au store, cliquez sur Utiliser des libellés de ressources. Étiquettes et Ajouter une étiquette, puis saisissez l'étiquette de clé-valeur. Pour en savoir plus sur les libellés de ressources, consultez la page
- Cliquez sur Enregistrer.
Pour modifier un store DICOM, exécutez la commande gcloud healthcare dicom-stores update
.
gcloud CLI ne permet pas de modifier les étiquettes.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du magasin DICOMDATASET_ID
: ID du magasin DICOMDICOM_STORE_ID
: sujet Pub/Sub dans lequel les messages sont publiés lorsqu'un événement se produit dans un entrepôt de donnéesPUBSUB_TOPIC
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores updateDICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID /topics/PUBSUB_TOPIC
Windows (PowerShell)
gcloud healthcare dicom-stores updateDICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID /topics/PUBSUB_TOPIC
Windows (cmd.exe)
gcloud healthcare dicom-stores updateDICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID /topics/PUBSUB_TOPIC
Vous devriez obtenir un résultat semblable à celui-ci :
Réponse
Updated dicomStore [DICOM_STORE_ID ]. ... name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID /topics/PUBSUB_TOPIC
Pour modifier un magasin DICOM, utilisez la méthode projects.locations.datasets.dicomStores.patch
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du magasin DICOMDATASET_ID
: ID du magasin DICOMDICOM_STORE_ID
: sujet Pub/Sub dans lequel les messages sont publiés lorsqu'un événement se produit dans un entrepôt de donnéesPUBSUB_TOPIC
: clé de la première étiquetteKEY_1
: valeur de la première étiquetteVALUE_1
: clé de la deuxième étiquetteKEY_2
: valeur de la deuxième étiquetteVALUE_2
Corps JSON de la requête :
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC " }, "labels": { "KEY_1 ": "VALUE_1 ", "KEY_2 ": "VALUE_2 " } }
Pour envoyer votre requête, choisissez l'une des options suivantes :
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC " }, "labels": { "KEY_1 ": "VALUE_1 ", "KEY_2 ": "VALUE_2 " } } EOF
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
curl -X PATCH \
-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/DATASET_ID /dicomStores/DICOM_STORE_ID ?updateMask=notificationConfig,labels"
Enregistrez le corps de la requête dans un fichier nommé request.json
.
Exécutez la commande suivante dans le terminal pour créer ou écraser ce fichier dans le répertoire actuel :
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC " }, "labels": { "KEY_1 ": "VALUE_1 ", "KEY_2 ": "VALUE_2 " } } '@ | Out-File -FilePath request.json -Encoding utf8
Exécutez ensuite la commande suivante pour envoyer votre requête REST :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID ?updateMask=notificationConfig,labels" | Select-Object -Expand Content
Copiez le corps de la requête et ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Collez le corps de la requête dans cet outil, renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource DicomStore
, ils apparaissent également dans la réponse.
Réponse
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID ", "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC " }, "labels": { "KEY_1 ": "VALUE_1 ", "KEY_2 ": "VALUE_2 " } }
Obtenir des détails sur un datastore DICOM
Les exemples suivants montrent comment obtenir des détails sur un datastore DICOM.
Pour afficher les détails d'un magasin DICOM, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Sélectionnez l'ensemble de données contenant le store DICOM que vous souhaitez afficher.
- Cliquez sur le nom du magasin DICOM.
L'onglet Vue d'ensemble affiche les détails du datastore DICOM sélectionné. L'onglet Métriques affiche les métriques du magasin DICOM, de l'étude DICOM et de la série DICOM. Pour en savoir plus, consultez la section Afficher les métriques du magasin DICOM, de l'étude DICOM et de la série DICOM.
Pour obtenir les détails d'un store DICOM, exécutez la commande gcloud healthcare dicom-stores describe
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du magasin DICOMDATASET_ID
: ID du magasin DICOMDICOM_STORE_ID
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores describeDICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores describeDICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores describeDICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource DicomStore
, ils apparaissent également dans la réponse.
Réponse
name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID
Pour obtenir des détails sur un magasin DICOM, utilisez la méthode projects.locations.datasets.dicomStores.get
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du magasin DICOMDATASET_ID
: ID du store DICOMDICOM_STORE_ID
Pour envoyer votre requête, choisissez l'une des options suivantes :
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID "
Exécutez la commande suivante :
$cred = gcloud auth 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 /dicomStores/DICOM_STORE_ID " | Select-Object -Expand Content
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource DicomStore
, ils apparaissent également dans la réponse.
Réponse
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID " }
Répertorier les magasins DICOM d'un ensemble de données
Les exemples suivants montrent comment répertorier les datastores DICOM d'un ensemble de données.
Pour afficher les datastores d'un ensemble de données, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Sélectionnez l'ensemble de données contenant le data store que vous souhaitez afficher.
Pour répertorier les stores DICOM d'un ensemble de données, exécutez la commande gcloud healthcare dicom-stores list
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du store DICOMDATASET_ID
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores list \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores list ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores list ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource DicomStore
, ils apparaissent également dans la réponse.
ID LOCATION TOPICDICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
Pour répertorier les magasins DICOM d'un ensemble de données, utilisez la méthode projects.locations.datasets.dicomStores.list
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du store DICOMDATASET_ID
Pour envoyer votre requête, choisissez l'une des options suivantes :
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores"
Exécutez la commande suivante :
$cred = gcloud auth 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 /dicomStores" | Select-Object -Expand Content
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Execute (Exécuter).
Vous devriez obtenir un résultat semblable au suivant.
Si vous avez configuré des champs dans la ressource DicomStore
, ils apparaissent également dans la réponse.
Réponse
{ "dicomStores": [ { "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID " }, { ... } ] }
Supprimer un datastore DICOM
Les exemples suivants montrent comment supprimer un datastore DICOM.
Pour supprimer un datastore, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Ensembles de données.
- Sélectionnez l'ensemble de données contenant le datastore que vous souhaitez supprimer.
- Choisissez Supprimer dans la liste déroulante Actions du datastore que vous souhaitez supprimer.
- Pour confirmer, saisissez le nom du datastore, puis cliquez sur Supprimer.
Pour supprimer un store DICOM, exécutez la commande gcloud healthcare dicom-stores delete
.
Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du magasin DICOMDATASET_ID
: ID du magasin DICOMDICOM_STORE_ID
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores deleteDICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores deleteDICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores deleteDICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID ].
Pour supprimer un magasin DICOM, utilisez la méthode projects.locations.datasets.dicomStores.delete
.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
: ID de votre Google Cloud projetPROJECT_ID
: emplacement de l'ensemble de donnéesLOCATION
: ensemble de données parent du magasin DICOMDATASET_ID
: ID du store DICOMDICOM_STORE_ID
Pour envoyer votre requête, choisissez l'une des options suivantes :
Exécutez la commande suivante :
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID "
Exécutez la commande suivante :
$cred = gcloud auth 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 /dicomStores/DICOM_STORE_ID " | Select-Object -Expand Content
Ouvrez la page de référence de la méthode. Le panneau APIs Explorer s'ouvre dans la partie droite de la page. Vous pouvez interagir avec cet outil pour envoyer des requêtes. Renseignez tous les champs obligatoires, puis cliquez sur Exécuter.
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{}