In questa pagina viene spiegato come creare, modificare, visualizzare, elencare ed eliminare IMMAGINE digitale e Comunicazioni in Medicina (DICOM) negozi.
Gli archivi DICOM contengono istanze DICOM. Puoi aggiungere e gestire delle istanze DICOM in un archivio DICOM utilizzando Implementazione di DICOMweb nell'API Cloud Healthcare oppure puoi importare ed esportare le istanze DICOM utilizzando i servizi Google Cloud.
Per ulteriori informazioni sulla conformità dell'API Cloud Healthcare allo standard DICOM, consulta la dichiarazione di conformità DICOM.
Creazione di un archivio DICOM
Prima di poter creare un archivio DICOM, devi creare un set di dati.
Gli esempi riportati di seguito mostrano come creare un archivio DICOM:
Console
Per creare un archivio DICOM:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati in cui vuoi creare un archivio DICOM.
- Fai clic su Crea datastore.
- Seleziona DICOM come tipo di datastore.
- Inserisci un nome a tua scelta che sia univoco nel tuo set di dati. Se non è univoco, la creazione del datastore non va a buon fine.
- Fai clic su Avanti.
-
Se vuoi configurare un argomento Pub/Sub per il datastore, fai clic su Ricevi
Notifiche Cloud Pub/Sub e seleziona il nome dell'argomento.
Quando specifichi un argomento Pub/Sub, inserisci l'URI qualificato dell'argomento, come mostrato in
nell'esempio seguente:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Fai clic su Avanti.
- Per aggiungere una o più etichette al negozio, fai clic su Aggiungi etichette per organizzare i tuoi datastore e inserisci l'etichetta chiave/valore. Per ulteriori informazioni sulle etichette delle risorse, consulta Utilizzo delle etichette delle risorse.
- Fai clic su Crea.
Il nuovo datastore viene visualizzato nell'elenco.
gcloud
Per creare un archivio DICOM, esegui il comando gcloud healthcare dicom-stores create
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: un identificatore per l'archivio DICOM. L'ID datastore DICOM deve avere quanto segue:- Un ID univoco nel suo set di dati
- Una stringa Unicode di 1-256 caratteri composta da quanto segue:
- Numeri
- Lettere
- Trattini bassi
- Trattini
- Punti
Esegui la persone che seguo :
Linux, macOS o 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
Dovresti ricevere una risposta simile alla seguente:
Risposta
Created dicomStore [DICOM_STORE_ID].
REST
Per creare un archivio DICOM, utilizza il metodo projects.locations.datasets.dicomStores.create
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: un identificatore per l'archivio DICOM. L'ID datastore DICOM deve avere quanto segue:- Un ID univoco nel suo set di dati
- Una stringa Unicode di 1-256 caratteri composta da quanto segue:
- Numeri
- Lettere
- Trattini bassi
- Trattini
- Punti
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
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
Esegui questo comando:
$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
Explorer API
Apri l'app pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente:
Go
Java
Node.js
Python
Modifica di un archivio DICOM
Gli esempi riportati di seguito mostrano come apportare le seguenti modifiche a un archivio DICOM:
- Modifica l'argomento Pub/Sub in cui è presente L'API Cloud Healthcare invia notifiche delle modifiche all'archivio DICOM.
- Modifica le etichette. Le etichette sono coppie chiave-valore che aiutano a organizzare le risorse Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Per modificare un archivio DICOM, completa i seguenti passaggi:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente l'archivio DICOM che vuoi modificare.
- Nell'elenco Datastore, fai clic sul datastore da modificare.
- Se vuoi configurare un argomento Pub/Sub per il datastore, seleziona il nome dell'argomento da Seleziona un argomento Cloud Pub/Sub.
- Per aggiungere una o più etichette al negozio, fai clic su Utilizzo delle etichette delle risorse. Etichette, poi su Aggiungi etichetta e inserisci l'etichetta chiave-valore. Per saperne di più sulle etichette delle risorse, consulta
- Fai clic su Salva.
gcloud
Per modificare un archivio DICOM, esegui il comando gcloud healthcare dicom-stores update
.
La CLI gcloud non supporta la modifica delle etichette.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: l'ID datastore DICOMPUBSUB_TOPIC
: un argomento Pub/Sub a cui vengono pubblicati i messaggi quando si verifica un evento in un data store
Esegui la persone che seguo :
Linux, macOS o 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
Dovresti ricevere una risposta simile alla seguente:
Risposta
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
Per modificare un archivio DICOM, utilizza il metodo projects.locations.datasets.dicomStores.patch
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: l'ID datastore DICOMPUBSUB_TOPIC
: un argomento Pub/Sub in cui vengono pubblicati i messaggi quando si verifica un evento in un datastoreKEY_1
: la prima chiave di etichettaVALUE_1
: il valore del primo etichettaKEY_2
: la seconda chiave di etichettaVALUE_2
: il secondo valore dell'etichetta
Corpo JSON della richiesta:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere
questo file nella directory corrente:
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
Quindi, esegui questo comando per inviare la richiesta 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
Salva il corpo della richiesta in un file denominato request.json
.
Esegui questo comando nel terminale per creare o sovrascrivere
questo file nella directory corrente:
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Quindi, esegui questo comando per inviare la richiesta 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
Explorer API
Copia il corpo della richiesta e apri pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Incolla il corpo della richiesta in questo strumento, compila tutti gli altri campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa DicomStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Go
Java
Node.js
Python
Recupero dei dettagli di un archivio DICOM
Gli esempi riportati di seguito mostrano come recuperare i dettagli di un archivio DICOM.
Console
Per visualizzare i dettagli di un archivio DICOM:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente l'archivio DICOM che vuoi visualizzare.
- Fai clic sul nome dell'archivio DICOM.
La scheda Panoramica mostra i dettagli dell'archivio DICOM selezionato. La scheda Metriche mostra le metriche dell'archivio, dello studio e della serie DICOM. Per ulteriori informazioni, vedi Visualizza l'archivio DICOM, lo studio DICOM e metriche delle serie.
gcloud
Per recuperare i dettagli di un archivio DICOM, esegui il comando gcloud healthcare dicom-stores describe
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: l'ID datastore DICOM
Esegui la persone che seguo :
Linux, macOS o 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
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa DicomStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Risposta
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
Per ottenere dettagli su un archivio DICOM, utilizza il metodo projects.locations.datasets.dicomStores.get
.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: l'ID datastore DICOM
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
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
Esegui questo comando:
$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
Explorer API
Apri l'app pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa DicomStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Go
Java
Node.js
Python
Elenco degli archivi DICOM in un set di dati
Gli esempi riportati di seguito mostrano come elencare gli archivi DICOM in un set di dati:
Console
Per visualizzare i datastore in un set di dati:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore da visualizzare.
gcloud
Per elencare gli archivi DICOM in un set di dati, esegui il comando gcloud healthcare dicom-stores list
.
Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOM
Esegui la persone che seguo :
Linux, macOS o 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
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa DicomStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Per elencare gli archivi DICOM in un set di dati, utilizza il metodo projects.locations.datasets.dicomStores.list
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOM
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
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
Esegui questo comando:
$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
Explorer API
Apri l'app pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta simile alla seguente.
Se nella risorsa DicomStore
hai configurato dei campi, questi vengono visualizzati anche nella risposta.
Go
Java
Node.js
Python
Eliminazione di un archivio DICOM
Gli esempi riportati di seguito mostrano come eliminare un archivio DICOM:
Console
Per eliminare un datastore:
- Nella console Google Cloud, vai alla pagina Set di dati.
- Seleziona il set di dati contenente il datastore da eliminare.
- Scegli Elimina dall'elenco a discesa Azioni per il datastore da eliminare.
- Per confermare, digita il nome del datastore e fai clic su Elimina.
gcloud
Per eliminare un archivio DICOM, esegui il comando gcloud healthcare dicom-stores delete
.
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
LOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: l'ID datastore DICOM
Esegui la persone che seguo :
Linux, macOS o 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
Per eliminare un archivio DICOM, utilizza il metodo projects.locations.datasets.dicomStores.delete
.
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
PROJECT_ID
: l'ID del tuo progetto Google CloudLOCATION
: la posizione del set di datiDATASET_ID
: set di dati padre dell'archivio DICOMDICOM_STORE_ID
: l'ID datastore DICOM
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
Esegui questo comando:
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
Esegui questo comando:
$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
Explorer API
Apri la pagina di riferimento del metodo. Sul lato destro della pagina si apre il riquadro Explorer API. Puoi interagire con questo strumento per inviare richieste. Compila tutti i campi obbligatori e fai clic su Esegui.
Dovresti ricevere una risposta JSON simile alla seguente: