Auf dieser Seite wird erläutert, wie Sie DICOM-Speicher (Digital Imaging and Communications in Medicine) erstellen, bearbeiten, anzeigen und löschen. 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:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Öffnen Sie das Dataset, in dem Sie einen DICOM-Speicher erstellen möchten.
- Klicken Sie auf Datenspeicher erstellen.
- 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.
- Wählen Sie DICOM als Datenspeichertyp aus.
-
Wenn Sie ein Pub/Sub-Thema für den Datenspeicher konfigurieren möchten, geben Sie den Namen des Themas ein.
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 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 im Dataset zu erstellen.
- Die DICOM-Speicher-ID muss im Dataset eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Wenn Sie ein Pub/Sub-Thema über Änderungen im DICOM-Speicher benachrichtigen möchten, geben Sie mit dem Argument
--pubsub-topic
einen vorhandenen Pub/Sub-Themennamen an. 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
Das folgende Beispiel zeigt, wie Sie einen DICOM-Speicher erstellen.
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ [--pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC]
Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung die folgende Meldung angezeigt:
Created dicomStore [DICOM_STORE_ID].
API
Verwenden Sie zum Erstellen eines DICOM-Speichers die Methode projects.locations.datasets.dicomStores.create
.
curl
Stellen Sie zum Erstellen eines DICOM-Speichers eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Ein Name für den DICOM-Speicher. Die DICOM-Speicher-ID muss im übergeordneten Dataset eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Ein Zugriffstoken
- Optional ein vorhandenes Pub/Sub-Thema, an das die Cloud Healthcare API Benachrichtigungen über DICOM-Speicheränderungen sendet. Informationen zum Konfigurieren des Pub/Sub-Themas finden Sie unter DICOM-Speicher bearbeiten.
Das folgende Beispiel zeigt eine POST
-Anfrage mit curl
.
curl -X POST \ --data "" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server die folgende Antwort im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
PowerShell
Stellen Sie zum Erstellen eines DICOM-Speichers eine POST
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Ein Name für den DICOM-Speicher. Die DICOM-Speicher-ID muss im übergeordneten Dataset eindeutig sein. Es kann sich um einen beliebigen Unicode-String mit 1 bis 256 Zeichen handeln, der aus Zahlen, Buchstaben, Unterstrichen, Bindestrichen und Punkten besteht.
- Ein Zugriffstoken
- Optional ein vorhandenes Pub/Sub-Thema, an das die Cloud Healthcare API Benachrichtigungen über DICOM-Speicheränderungen sendet. Informationen zum Konfigurieren des Pub/Sub-Themas finden Sie unter DICOM-Speicher bearbeiten.
Das folgende Beispiel zeigt eine POST
-Anfrage mit Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
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_TOPICDamit Benachrichtigungen gesendet werden, müssen Sie dem Dienstkonto Cloud Healthcare Service Agent zusätzliche Berechtigungen erteilen. Weitere Informationen finden Sie unter Pub/Sub-Berechtigungen für DICOM-, FHIR- und HL7v2-Speicher.
Console
Die Cloud Console unterstützt das Bearbeiten des Pub/Sub-Themas oder der Labels nicht. Verwenden Sie stattdessen curl
, Windows PowerShell oder Ihre bevorzugte Sprache.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores update
aus, um den DICOM-Speicher zu aktualisieren.
Das folgende Beispiel zeigt, wie Sie das Pub/Sub-Thema für den DICOM-Speicher aktualisieren. Das gcloud
-Tool unterstützt das Bearbeiten von Labels nicht.
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Wenn die Anfrage erfolgreich ist, zeigt die Eingabeaufforderung die DICOM-Speicherdetails einschließlich des neuen Themennamens an:
Updated dicomStore [DICOM_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicom-stores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
API
Zum Bearbeiten eines DICOM-Speichers verwenden Sie die Methode projects.locations.datasets.dicomStores.patch
.
curl
Wenn Sie einen DICOM-Speicher bearbeiten möchten, senden Sie eine PATCH
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des DICOM-Speichers
- Die zu aktualisierenden Metadaten In diesem Beispiel die qualifizierte URI zum Pub/Sub-Thema und die zu aktualisierenden Labels als eine durch Komma getrennte Liste von Schlüssel/Wert-Paaren.
- Eine Aktualisierungsmaske
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine PATCH
-Anfrage mit curl
.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'notificationConfig': { 'pubsubTopic':'projects/PROJECT_ID/topics/PUBSUB_TOPIC' }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels"
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID", "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }
PowerShell
Wenn Sie einen DICOM-Speicher bearbeiten möchten, senden Sie eine PATCH
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des DICOM-Speichers
- Die zu aktualisierenden Metadaten In diesem Beispiel die qualifizierte URI zum Pub/Sub-Thema und die zu aktualisierenden Labels als eine durch Komma getrennte Liste von Schlüssel/Wert-Paaren.
- Eine Aktualisierungsmaske
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine PATCH
-Anfrage mit Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Patch ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'notificationConfig': { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC' }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }" ` -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
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID", "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }
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:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Klicken Sie auf die ID des Datasets, das den DICOM-Speicher enthält.
- Klicken Sie auf den Namen des DICOM-Speichers.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores describe
aus, um Details zu einem DICOM-Speicher anzuzeigen.
Das folgende Beispiel zeigt, wie Sie Details zu einem DICOM-Speicher abrufen:
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Wenn die Anfrage erfolgreich ist, zeigt die Eingabeaufforderung die DICOM-Speicherdetails an:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicom-stores/DICOM_STORE_ID
API
Details zu einem DICOM-Speicher erhalten Sie mit der Methode projects.locations.datasets.dicomStores.get
.
curl
Wenn Sie Details zu einem DICOM-Speicher abrufen möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des DICOM-Speichers
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
PowerShell
Wenn Sie Details zu einem DICOM-Speicher abrufen möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des DICOM-Speichers
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit Windows PowerShell.
$cred = gcloud auth application-default 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
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
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 Cloud Console die Seite „Datasets“ auf.
- Klicken Sie auf die ID des Datasets, dessen Datenspeicher Sie anzeigen möchten.
gcloud
Führen Sie den Befehl gcloud healthcare dicom-stores list
aus, um die DICOM-Speicher in einem Dataset aufzulisten.
gcloud healthcare dicom-stores list --dataset=DATASET_ID
Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die DICOM-Speicher aufgelistet:
ID LOCATION TOPIC DICOM_STORE_ID LOCATION projects/PROJECT_ID/topics/PUBSUB_TOPIC
API
Verwenden Sie die Methode projects.locations.datasets.dicomStores.list
, um die DICOM-Speicher in einem Dataset aufzulisten.
curl
Wenn Sie die DICOM-Speicher in einem Dataset auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit curl
.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores"
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "dicomStores": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }, { ... } ] }
Wenn Sie in der Ressource DicomStore
Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.
PowerShell
Wenn Sie die DICOM-Speicher in einem Dataset auflisten möchten, senden Sie eine GET
-Anfrage und geben Sie die folgenden Informationen an:
- Der Name des übergeordneten Datasets
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine GET
-Anfrage mit Windows PowerShell.
$cred = gcloud auth application-default 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
Wenn die Anfrage erfolgreich ist, gibt der Server eine Antwort wie die folgende im JSON-Format zurück:
{ "dicomStores": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }, { ... } ] }
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:
- Rufen Sie in der Cloud Console die Seite „Datasets“ auf.
- Öffnen Sie das Dataset, indem Sie auf die Dataset-ID klicken.
- Wählen Sie den zu löschenden Datenspeicher aus und klicken Sie auf Löschen.
- 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:
- Führen Sie den Befehl
delete
aus:
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
- Geben Sie zur Bestätigung Y ein.
Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung die folgende Antwort angezeigt:
Deleted dicomStore [DICOM_STORE_ID].
API
Verwenden Sie zum Löschen eines DICOM-Speichers die Methode projects.locations.datasets.dicomStores.delete
.
curl
Wenn Sie einen DICOM-Speicher löschen möchten, senden Sie eine DELETE
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des zu löschenden DICOM-Speichers
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit curl
.
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
Wenn die Anfrage erfolgreich ist, gibt der Server den leeren Antworttext im JSON-Format zurück:
{}
PowerShell
Wenn Sie einen DICOM-Speicher löschen möchten, senden Sie eine DELETE
-Anfrage und geben Sie die folgenden Informationen an:
- Name und Speicherort des übergeordneten Datasets
- Der Name des zu löschenden DICOM-Speichers
- Ein Zugriffstoken
Das folgende Beispiel zeigt eine DELETE
-Anfrage mit Windows PowerShell.
$cred = gcloud auth application-default 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
Wenn die Anfrage erfolgreich ist, gibt der Server den leeren Antworttext im JSON-Format zurück:
{}