Auf dieser Seite wird erläutert, wie Sie DICOM-Speicher (Digital Imaging and Communications in Medicine) erstellen, bearbeiten, anzeigen, auflisten und löschen.
DICOM-Speicher enthalten DICOM-Instanzen. Sie können DICOM-Instanzen in einem DICOM-Speicher mithilfe der DICOMweb-Implementierung in der Cloud Healthcare API hinzufügen und verwalten oder DICOM-Instanzen mit Google Cloud-Diensten importieren und exportieren.
Weitere Informationen dazu, wie die Cloud Healthcare API dem DICOM-Standard entspricht, finden Sie in der DICOM-Konformitätserklärung.
DICOM-Speicher erstellen
Bevor Sie einen DICOM-Speicher erstellen können, müssen Sie ein Dataset erstellen.
In den folgenden Beispielen wird gezeigt, wie Sie einen DICOM-Speicher erstellen:
Console
So erstellen Sie einen DICOM-Speicher:
- Öffnen Sie in der Google Cloud Console die Seite der Datasets.
- Wählen Sie das Dataset aus, in dem Sie einen DICOM-Speicher erstellen möchten.
- Klicken Sie auf Datenspeicher erstellen.
- Wählen Sie DICOM als Datenspeichertyp aus.
- Geben Sie einen Namen Ihrer Wahl ein, der in Ihrem Dataset eindeutig ist. Wenn der Name nicht eindeutig ist, schlägt die Erstellung des Datenspeichers fehl.
- Klicken Sie auf Next (Weiter).
-
Wenn Sie ein Pub/Sub-Thema für den Datenspeicher konfigurieren möchten, klicken Sie auf Cloud Pub/Sub-Benachrichtigungen empfangen und wählen Sie den Themennamen aus.
Wenn Sie ein Pub/Sub-Thema angeben, geben Sie den qualifizierten URI zum Thema ein, wie im folgenden Beispiel gezeigt:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Klicken Sie auf Next (Weiter).
- Klicken Sie zum Hinzufügen eines oder mehrerer Labels zum Speicher auf Labels hinzufügen, um Ihre Datenspeicher zu organisieren und geben Sie das Schlüssel/Wert-Label ein. Weitere Informationen zu Ressourcenlabels finden Sie unter Ressourcenlabels verwenden.
- Klicken Sie auf Erstellen.
Der neue Datenspeicher wird in der Liste angezeigt.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores create
aus, um einen DICOM-Speicher zu erstellen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
ist eine Kennung für den DICOM-Speicher. Die DICOM-Speicher-ID muss Folgendes enthalten:- Eine im eigenen Dataset eindeutige ID
- Einen Unicode-String mit 1 bis 256 Zeichen, der Folgendes umfasst:
- Nummern
- Buchstaben
- Unterstriche
- Bindestriche
- Punkte
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Antwort
Created dicomStore [DICOM_STORE_ID].
REST
Verwenden Sie zum Erstellen eines DICOM-Speichers die Methode projects.locations.datasets.dicomStores.create
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
ist eine Kennung für den DICOM-Speicher. Die DICOM-Speicher-ID muss Folgendes enthalten:- Eine im eigenen Dataset eindeutige ID
- Einen Unicode-String mit 1 bis 256 Zeichen, der Folgendes umfasst:
- Nummern
- Buchstaben
- Unterstriche
- Bindestriche
- Punkte
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
APIs Explorer
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
DICOM-Speicher bearbeiten
Die folgenden Beispiele zeigen, wie Sie die folgenden Änderungen an einem DICOM-Speicher vornehmen:
- Bearbeiten Sie das Pub/Sub-Thema, an das die Cloud Healthcare API Benachrichtigungen über Änderungen des DICOM-Speichers sendet.
- Bearbeiten Sie die Labels. Labels sind Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Ressourcen organisieren können.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Führen Sie die folgenden Schritte aus, um einen DICOM-Speicher zu bearbeiten:
- Rufen Sie in der Google Cloud Console die Seite Datasets auf.
- Wählen Sie das Dataset mit dem DICOM-Speicher aus, den Sie bearbeiten möchten.
- Klicken Sie in der Liste Datenspeicher auf den Datenspeicher, den Sie bearbeiten möchten.
- Wenn Sie ein Pub/Sub-Thema für den Datenspeicher konfigurieren möchten, wählen Sie den Themennamen unter Cloud Pub/Sub-Thema auswählen aus.
- Um dem Speicher ein oder mehrere Labels hinzuzufügen, klicken Sie auf Ressourcenlabel verwenden. Labels und auf Label hinzufügen. Geben Sie dann das Schlüssel/Wert-Label ein. Weitere Informationen zu Ressourcenlabel finden Sie unter
- Klicken Sie auf Speichern.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores update
aus, um einen DICOM-Speicher zu bearbeiten:
Die gcloud CLI unterstützt das Bearbeiten von Labels nicht.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
: die ID des DICOM-SpeichersPUBSUB_TOPIC
: ein Pub/Sub-Thema, in dem Nachrichten veröffentlicht werden, wenn ein Ereignis in einem Datenspeicher auftritt
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Antwort
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
Zum Bearbeiten eines DICOM-Speichers verwenden Sie die Methode projects.locations.datasets.dicomStores.patch
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
: die ID des DICOM-SpeichersPUBSUB_TOPIC
: ein Pub/Sub-Thema, in dem Nachrichten veröffentlicht werden, wenn ein Ereignis in einem Datenspeicher auftrittKEY_1
ist der erste LabelschlüsselVALUE_1
ist der erste LabelwertKEY_2
ist der zweite LabelschlüsselVALUE_2
ist der zweite Labelwert
JSON-Text der Anfrage:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
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
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
.
Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
$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
APIs Explorer
Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
DICOM-Speicherdetails abrufen
In den folgenden Beispielen wird gezeigt, wie Sie Details zu einem DICOM-Speicher abrufen können.
Console
So rufen Sie die Details eines DICOM-Speichers auf:
- Öffnen Sie in der Google Cloud Console die Seite Datasets.
- Wählen Sie das Dataset mit dem DICOM-Speicher aus, den Sie ansehen möchten.
- Klicken Sie auf den Namen des DICOM-Speichers.
Auf dem Tab Übersicht finden Sie die Details zum ausgewählten DICOM-Speicher. Auf dem Tab Messwerte werden die Messwerte für den DICOM-Speicher, die DICOM-Studie und die DICOM-Serie angezeigt. Weitere Informationen finden Sie unter Messwerte für DICOM-Speicher, DICOM-Studien und DICOM-Serien ansehen.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores describe
aus, um Details zu einem DICOM-Speicher abzurufen.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROJECT_ID
: die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
: die ID des DICOM-Speichers
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Antwort
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
Details zu einem DICOM-Speicher erhalten Sie mit der Methode projects.locations.datasets.dicomStores.get
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
ist die ID des DICOM-Speichers
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
APIs Explorer
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
DICOM-Speicher in einem Dataset auflisten
In den folgenden Beispielen wird gezeigt, wie Sie die DICOM-Speicher in einem Dataset auflisten:
Console
So zeigen Sie die Datenspeicher in einem Dataset an:
- Rufen Sie in der Google Cloud Console die Seite Datasets auf.
- Wählen Sie das Dataset aus, das den Datenspeicher enthält, den Sie anzeigen möchten.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores list
aus, um die DICOM-Speicher in einem Dataset aufzulisten.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROJECT_ID
: die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-Speichers
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Verwenden Sie die Methode projects.locations.datasets.dicomStores.list
, um die DICOM-Speicher in einem Dataset aufzulisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-Speichers
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
APIs Explorer
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
Go
Java
Node.js
Python
DICOM-Speicher löschen
In den folgenden Beispielen wird gezeigt, wie Sie einen DICOM-Speicher löschen:
Console
So löschen Sie einen Datenspeicher:
- Öffnen Sie in der Google Cloud Console die Seite Datasets.
- Wählen Sie das Dataset aus, das den Datenspeicher enthält, den Sie löschen möchten.
- Wählen Sie in der Drop-down-Liste Aktionen für den Datenspeicher, den Sie löschen möchten, Löschen aus.
- Geben Sie zur Bestätigung den Namen des Datenspeichers ein und klicken Sie dann auf Löschen.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores delete
aus, um einen DICOM-Speicher zu löschen:
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
: die ID des DICOM-Speichers
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Verwenden Sie zum Löschen eines DICOM-Speichers die Methode projects.locations.datasets.dicomStores.delete
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist das übergeordnete Dataset des DICOM-SpeichersDICOM_STORE_ID
ist die ID des DICOM-Speichers
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
APIs Explorer
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten: