Diese Seite wurde von der Cloud Translation API übersetzt.

DICOM-Pub/Sub-Benachrichtigungen konfigurieren

Auf dieser Seite wird beschrieben, wie Sie mit Pub/Sub Benachrichtigungen zu klinischen Ereignissen in einem DICOM-Speicher erhalten. Sie können Pub/Sub-Benachrichtigungen erhalten, wenn eine neue DICOM-Instanz in einem DICOM-Speicher gespeichert oder aus Cloud Storage importiert wird.

Sie können Pub/Sub-Benachrichtigungen für verschiedene Zwecke verwenden, z. B. um eine nachgeschaltete Verarbeitung auszulösen oder neue Daten zu analysieren. So kann ein Modell für maschinelles Lernen beispielsweise Benachrichtigungen erhalten, wenn neue Daten für das Training verfügbar sind, und Statistiken zur Verbesserung der Patientenversorgung generieren.

In der folgenden Abbildung wird dargestellt, wie Pub/Sub-Benachrichtigungen generiert und veröffentlicht werden.

DICOM-Pub/Sub-Benachrichtigungen

Abbildung 1. Pub/Sub-Benachrichtigungen zu klinischen Ereignissen in einem DICOM-Speicher empfangen

Abbildung 1 zeigt die folgenden Schritte:

Ein Aufrufer sendet eine Anfrage zum Speichern oder Importieren einer DICOM-Instanz.
Der DICOM-Speicher empfängt die Anfrage, erstellt eine Pub/Sub-Nachricht und sendet sie an das Pub/Sub-Thema, das für den DICOM-Speicher konfiguriert wurde.
Pub/Sub leitet die Nachricht an die mit dem Thema verknüpften Abos weiter.
Die Abonnenten erhalten die Nachricht über ihr Abo. Jedes Abo kann einen oder mehrere Abonnenten haben, um die Parallelität zu erhöhen.

Hinweise

Pub/Sub-Publisher-Berechtigungen hinzufügen

Damit Nachrichten von der Cloud Healthcare API in Pub/Sub veröffentlicht werden können, müssen Sie die Rolle pubsub.publisher zum Dienstkonto Ihres Projekts Cloud Healthcare-Dienst-Agent hinzufügen. Weitere Informationen finden Sie unter Pub/Sub-Berechtigungen für DICOM-, FHIR- und HL7v2-Speicher.

Format und Inhalt der Benachrichtigung

Eine Pub/Sub-Benachrichtigung enthält ein Message-Objekt mit Informationen zum klinischen Ereignis. DICOM-Pub/Sub-Benachrichtigungen enthalten kein attributes-Feld. Das Message-Objekt sieht in etwa so aus:

{
  "message": {
    "data": "BASE_64_ENCODED_DATA",
    "messageId": "MESSAGE_ID",
    "publishTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ"
  }
}

Der Wert im Feld data ist die folgende Kennung als Base64-codierter String: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_UID/series/SERIES_UID/instances/INSTANCE_UID

Weitere Informationen zu den in jeder Pub/Sub-Nachricht enthaltenen Feldern finden Sie unter ReceivedMessage und PubsubMessage.

Benachrichtigungen konfigurieren und ansehen

In diesem Abschnitt wird beschrieben, wie Sie Pub/Sub-Benachrichtigungen für einen DICOM-Speicher aktivieren, eine DICOM-Instanz speichern oder importieren, um eine Benachrichtigung zu veröffentlichen, und die Benachrichtigung aufrufen.

DICOM-Speicher konfigurieren

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen oder die folgenden IAM-Rollen (Identity and Access Management):

Berechtigungen

healthcare.dicomStores.update

Rollen

Healthcare DICOM Store-Administrator (roles/healthcare.dicomStoreAdmin)

Sie können Ihren Administrator bitten, Ihnen diese IAM-Rollen (Identity and Access Management) zu gewähren. Eine Anleitung zum Zuweisen von Rollen finden Sie unter Zugriff verwalten oder Zugriff auf Cloud Healthcare API-Ressourcen steuern. Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Hinweis: Wenn Sie für diesen Leitfaden ein Google Cloud-Projekt erstellt haben, wird Ihnen als Projektersteller automatisch die IAM-Rolle „Inhaber“ (roles/owner) mit den erforderlichen Berechtigungen zugewiesen. Sie benötigen keine zusätzlichen IAM-Rollen.

In den folgenden Beispielen wird gezeigt, wie Sie Pub/Sub-Benachrichtigungen für einen DICOM-Speicher aktivieren, wenn eine neue DICOM-Instanz gespeichert oder aus Cloud Storage importiert wird.

REST

Verwenden Sie die Methode projects.locations.datasets.dicomStores.patch.

Der Wert für NotificationConfig.sendForBulkImport ist true. Daher werden beim Importieren von Daten aus Cloud Storage Benachrichtigungen gesendet.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID ist die ID Ihres Google Cloud-Projekts
LOCATION ist der Standort des Datasets
DATASET_ID ist das übergeordnete Dataset des DICOM-Speichers
DICOM_STORE_ID: die ID des DICOM-Speichers
PUBSUB_TOPIC: ein Pub/Sub-Thema, in dem Nachrichten veröffentlicht werden, wenn ein Ereignis in einem Datenspeicher auftritt

JSON-Text der Anfrage:

{
  "notificationConfig": {
    "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC",
    "sendForBulkImport": "true"
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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",
    "sendForBulkImport": "true"
  }
}
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"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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",
    "sendForBulkImport": "true"
  }
}
'@  | 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" | 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.

Antwort

{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID",
  "notificationConfig": {
    "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC",
    "sendForBulkImport": "true"
  },
}

gcloud

Führen Sie den Befehl gcloud healthcare dicom-stores update aus.

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

PROJECT_ID: die ID Ihres Google Cloud-Projekts
LOCATION ist der Standort des Datasets
DATASET_ID ist das übergeordnete Dataset des DICOM-Speichers
DICOM_STORE_ID: die ID des DICOM-Speichers
PUBSUB_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 \
  --send-for-bulk-import

Windows (PowerShell)

gcloud healthcare dicom-stores update DICOM_STORE_ID `
  --dataset=DATASET_ID `
  --location=LOCATION `
  --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC `
  --send-for-bulk-import

Windows (cmd.exe)

gcloud healthcare dicom-stores update DICOM_STORE_ID ^
  --dataset=DATASET_ID ^
  --location=LOCATION ^
  --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC ^
  --send-for-bulk-import

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
  sendForBulkImport: true

DICOM-Instanz speichern oder importieren und Pub/Sub-Benachrichtigung ansehen

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe benötigen Sie die folgenden Berechtigungen oder die folgenden IAM-Rollen (Identity and Access Management):

Berechtigungen

healthcare.dicomStores.dicomWebWrite, um DICOM-Instanzen im angeforderten DICOM-Speicher zu speichern.
healthcare.dicomStores.import, um DICOM-Instanzen in den angeforderten DICOM-Speicher zu importieren.

Rollen

Healthcare DICOM-Mitbearbeiter (roles/healthcare.dicomEditor)

So speichern oder importieren Sie eine DICOM-Instanz und rufen die generierte Pub/Sub-Nachricht ab:

Speichern oder import Sie eine DICOM-Instanz. Die Anfrage veranlasst die Cloud Healthcare API, eine Nachricht im konfigurierten Pub/Sub-Thema zu veröffentlichen.
Rufen Sie die Nachricht ab. Wenn Sie mehrere DICOM-Instanzen in einer einzigen Anfrage importieren, wird für jede DICOM-Instanz eine Nachricht generiert.

Informationen zu den Identity and Access Management-Berechtigungen, die zum Abrufen von Pub/Sub-Nachrichten erforderlich sind, finden Sie unter Zugriffssteuerung für Pub/Sub.
REST

Verwenden Sie die Methode projects.subscriptions.pull. Im folgenden Beispiel wird der Abfrageparameter ?maxMessages=10 verwendet, um die maximale Anzahl von Nachrichten anzugeben, die in der Anfrage zurückgegeben werden sollen. Passen Sie diesen Wert an Ihren Anwendungsfall an.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- PUBSUB_SUBSCRIPTION_ID: die ID des Abos, das mit dem Pub/Sub-Thema verknüpft ist, das im DICOM-Speicher konfiguriert ist
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud CLI anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

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://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/PUBSUB_SUBSCRIPTION_ID:pull?maxMessages=10"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud CLI angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/PUBSUB_SUBSCRIPTION_ID:pull?maxMessages=10" | 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:
Antwort

{ "receivedMessages": [ { "ackId": "RFAGFixdRkhRNxkIaFEOT14jPzUgKEUaAggUBXx9cEFLdVhUcGhRDRlyfWB9bQ5GAgpGWixfURsHaE5tdR", "ackStatus": "SUCCESS", "message": { "data": "cHJvamVjdHMvbXlwcm9qZWN0L2xvY2F0aW9ucy91cy1jZW50cmFsMS9kYXRhc2V0cy9teS1kYXRhc2V0L2RpY29tU3RvcmVzL215LWRpY29tLXN0b3JlL2RpY29tV2ViL3N0dWRpZXMvMS4zLjYuMS40LjEuMTExMjkuNS41LjExMTM5NjM5OTM2MTk2OTg5ODIwNTM2NDQwMDU0OTc5OTI1Mjg1NzYwNC9zZXJpZXMvMS4zLjYuMS40LjEuMTExMjkuNS41LjE5NTYyODIxMzY5NDMwMDQ5ODk0Njc2MDc2NzQ4MTI5MTI2MzUxMTcyNC9pbnN0YW5jZXMvMS4zLjYuMS40LjEuMTExMjkuNS41LjE1Mzc1MTAwOTgzNTEwNzYxNDY2NjgzNDU2MzI5NDY4NDMzOTc0NjQ4MA==", "messageId": "7586159156345265", "publishTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ" } } ] }
gcloud

Führen Sie den Befehl gcloud pubsub subscriptions pull aus.

Im Beispiel werden die folgenden Google Cloud CLI-Flags verwendet:
- --limit=10: Es werden maximal 10 Nachrichten zurückgegeben. Passen Sie diesen Wert an Ihren Anwendungsfall an.
- --format=json: Die Ausgabe wird als JSON gerendert.
- --auto-ack: Jede abgerufene Nachricht wird automatisch bestätigt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
- PROJECT_ID ist die ID Ihres Google Cloud-Projekts
- PUBSUB_SUBSCRIPTION_ID: die ID des Abos, das mit dem Pub/Sub-Thema verknüpft ist, das im DICOM-Speicher konfiguriert ist
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud pubsub subscriptions pull \ projects/PROJECT_ID/subscriptions/PUBSUB_SUBSCRIPTION_ID \ --limit=10 \ --auto-ack \ --format=json
Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud pubsub subscriptions pull ` projects/PROJECT_ID/subscriptions/PUBSUB_SUBSCRIPTION_ID ` --limit=10 ` --auto-ack ` --format=json
Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud pubsub subscriptions pull ^ projects/PROJECT_ID/subscriptions/PUBSUB_SUBSCRIPTION_ID ^ --limit=10 ^ --auto-ack ^ --format=json
Sie sollten eine Antwort ähnlich der folgenden erhalten:
[ { "ackId": "RFAGFixdRkhRNxkIaFEOT14jPzUgKEUaAggUBXx9cEFLdVhUcGhRDRlyfWB9bQ5GAgpGWixfURsHaE5tdR", "ackStatus": "SUCCESS", "message": { "data": "cHJvamVjdHMvbXlwcm9qZWN0L2xvY2F0aW9ucy91cy1jZW50cmFsMS9kYXRhc2V0cy9teS1kYXRhc2V0L2RpY29tU3RvcmVzL215LWRpY29tLXN0b3JlL2RpY29tV2ViL3N0dWRpZXMvMS4zLjYuMS40LjEuMTExMjkuNS41LjExMTM5NjM5OTM2MTk2OTg5ODIwNTM2NDQwMDU0OTc5OTI1Mjg1NzYwNC9zZXJpZXMvMS4zLjYuMS40LjEuMTExMjkuNS41LjE5NTYyODIxMzY5NDMwMDQ5ODk0Njc2MDc2NzQ4MTI5MTI2MzUxMTcyNC9pbnN0YW5jZXMvMS4zLjYuMS40LjEuMTExMjkuNS41LjE1Mzc1MTAwOTgzNTEwNzYxNDY2NjgzNDU2MzI5NDY4NDMzOTc0NjQ4MA==", "messageId": "7586159156345265", "publishTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ" } } ]

Cloud Healthcare API und Pub/Sub-Nachrichtenspeicherrichtlinie

Um sicherzustellen, dass sich die Cloud Healthcare API-Daten und die zugehörigen Daten in Pub/Sub-Nachrichten in derselben Region befinden, müssen Sie eine Pub/Sub-Nachrichtenspeicherrichtlinie festlegen.

Sie müssen die Nachrichtenspeicherrichtlinie für das im Datenspeicher konfigurierte Pub/Sub-Thema explizit festlegen, damit die Daten in derselben Region bleiben. Wenn sich Ihr Cloud Healthcare API-Dataset und Ihr FHIR-Speicher beispielsweise in us-central1 befinden, darf die Nachrichtenspeicherrichtlinie nur die Region us-central1 zulassen.

Informationen zum Konfigurieren einer Richtlinie für den Nachrichtenspeicher finden Sie unter Richtlinien für den Nachrichtenspeicher konfigurieren.

Fehlerbehebung bei fehlenden Pub/Sub-Nachrichten

Wenn eine Benachrichtigung nicht in Pub/Sub veröffentlicht werden kann, wird ein Fehler in Cloud Logging in Logs erfasst. Weitere Informationen finden Sie unter Fehlerlogs in Cloud Logging ansehen.

Wenn die Fehlergenerierungsrate ein Limit überschreitet, werden Fehler, die dieses Limit überschreiten, nicht an Cloud Logging gesendet.

DICOM-Pub/Sub-Benachrichtigungen konfigurieren

Hinweise

Pub/Sub-Publisher-Berechtigungen hinzufügen

Format und Inhalt der Benachrichtigung

Benachrichtigungen konfigurieren und ansehen

DICOM-Speicher konfigurieren

Erforderliche Berechtigungen für diese Aufgabe

REST

curl

PowerShell

APIs Explorer

Antwort

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Antwort

DICOM-Instanz speichern oder importieren und Pub/Sub-Benachrichtigung ansehen

Erforderliche Berechtigungen für diese Aufgabe

REST

curl

PowerShell

APIs Explorer

Antwort

gcloud

Linux, macOS oder Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Cloud Healthcare API und Pub/Sub-Nachrichtenspeicherrichtlinie

Fehlerbehebung bei fehlenden Pub/Sub-Nachrichten

Nächste Schritte