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 :
Console
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.
gcloud
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 :
LOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du store DICOMDICOM_STORE_ID
: identifiant du store DICOM. L'ID du store DICOM doit comporter les éléments suivants :- 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 create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores create DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores create DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Vous devriez obtenir un résultat semblable à celui-ci :
Réponse
Created dicomStore [DICOM_STORE_ID].
REST
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du store DICOMDICOM_STORE_ID
: identifiant du store DICOM. L'ID du store DICOM doit comporter les éléments suivants :- 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 :
curl
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"
PowerShell
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
API Explorer
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 :
Go
Java
Node.js
Python
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
Console
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.
gcloud
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 :
LOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin DICOMDICOM_STORE_ID
: ID du magasin DICOMPUBSUB_TOPIC
: sujet Pub/Sub dans lequel les messages sont publiés lorsqu'un événement se produit dans un data store
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (PowerShell)
gcloud healthcare dicom-stores update DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (cmd.exe)
gcloud healthcare dicom-stores update DICOM_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
REST
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin DICOMDICOM_STORE_ID
: ID du magasin DICOMPUBSUB_TOPIC
: sujet Pub/Sub dans lequel les messages sont publiés lorsqu'un événement se produit dans un data storeKEY_1
: clé de la première étiquetteVALUE_1
: valeur de la première étiquetteKEY_2
: clé de la deuxième étiquetteVALUE_2
: valeur de la deuxième étiquette
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 :
curl
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"
PowerShell
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
API Explorer
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.
Go
Java
Node.js
Python
Obtenir des détails sur un datastore DICOM
Les exemples suivants montrent comment obtenir des détails sur un datastore DICOM.
Console
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.
gcloud
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin DICOMDICOM_STORE_ID
: ID du magasin DICOM
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores describe DICOM_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
REST
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin DICOMDICOM_STORE_ID
: ID du store DICOM
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
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"
PowerShell
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
API Explorer
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.
Go
Java
Node.js
Python
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.
Console
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.
gcloud
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du store DICOM
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 TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du store DICOM
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
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"
PowerShell
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
API Explorer
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.
Go
Java
Node.js
Python
Supprimer un datastore DICOM
Les exemples suivants montrent comment supprimer un datastore DICOM.
Console
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.
gcloud
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 :
LOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin DICOMDICOM_STORE_ID
: ID du magasin DICOM
Exécutez la commande suivante :
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID].
REST
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 :
PROJECT_ID
: ID de votre projet Google CloudLOCATION
: emplacement de l'ensemble de donnéesDATASET_ID
: ensemble de données parent du magasin DICOMDICOM_STORE_ID
: ID du store DICOM
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
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"
PowerShell
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
API Explorer
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 :