Diese Seite wurde von der Cloud Translation API übersetzt.

DICOM-Speicherklasse ändern

Auf dieser Seite wird beschrieben, wie Sie die Speicherklasse für DICOM-Daten in Cloud Healthcare API

Übersicht

Die Cloud Healthcare API bietet die folgenden Speicherklassen:

Standard
Nearline
Coldline
Archivieren

Diese Speicherklassen ähneln den in Cloud Storage eins.

Sie können die Speicherklasse Ihres DICOM-Objekts ändern, um Kosten zu sparen in Szenarien wie den folgenden:

Verschieben einer Folge von DICOM-Images, auf die selten zugegriffen wird, von Standard Storage zu Nearline Storage oder Coldline Storage. Dadurch werden die Standard-Storage-Buckets freigegeben, um Images zu speichern, häufig aufgerufen wird.
Patientendaten werden aus dem Standardspeicher in den Archivspeicher verschoben zur Archivierung von Daten, die aus rechtlichen Gründen aufbewahrt werden müssen. Archivspeicher ist die kostengünstigste Speicherklasse mit hoher Langlebigkeit.

Methoden zum Ändern der DICOM-Speicherklasse

Standardmäßig hat eine DICOM-Instanz eine Standardspeicherklasse. Sie können die mithilfe der folgenden Methoden:

Die import Methode: Legen Sie die Speicherklasse fest, wenn Sie eine DICOM-Instanz aus einer Cloud Storage-Bucket mit dem Feld blobStorageSettings
Die storeInstances Methode: Legen Sie die Speicherklasse beim Speichern eines DICOM fest. Instanz aus einem lokalen Pfad
Die Methode setBlobStorageSettings: Ändern der Speicherklasse eines DICOM Instanz, in einem DICOM-Speicher auf Instanz-, Serien- oder Studienebene

Hinweise

Bevor Sie die Speicherklasse Ihrer DICOM-Instanzen in der Cloud Healthcare API ändern, prüfen Sie die folgenden Preisangaben:

DICOM-Datenspeicher
Gebühren für das Abrufen von DICOM-Daten

Speicherklasse einer DICOM-Instanz ändern

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

Rollen

Healthcare-DICOM-Bearbeiter (roles/healthcare.dicomEditor)

Die folgenden Beispiele zeigen, wie Sie die Speicherklasse einer DICOM-Instanz ändern. auf einer Instanz, Serie oder Lernniveau.

Auf Instanzebene

Führen Sie folgende Schritte aus, um die Speicherklasse einer DICOM-Instanz auf Instanzebene zu ändern: diese Schritte:

REST

Verwenden Sie die Methode projects.locations.datasets.dicomStores.studies.series.instances.setBlobStorageSettings.

Speicherklasse der DICOM-Instanz auf der Instanz ändern
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
- STUDY_INSTANCE_UID: die eindeutige Kennung der Studieninstanz
- SERIES_INSTANCE_UID: die eindeutige Kennung der Serieninstanz
- INSTANCE_UID: die eindeutige Instanzkennzeichnung
- STORAGE_CLASS: die Speicherklasse für das DICOM-Objekt im DICOM-Speicher von STANDARD, NEARLINE, COLDLINE und ARCHIVE
JSON-Text der Anfrage:
```
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
```
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'
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
EOF
```
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instance/INSTANCE_UID:setBlobStorageSettings"
```
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:
```
@'
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
'@  | 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 POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instance/INSTANCE_UID:setBlobStorageSettings" | Select-Object -Expand Content
```
Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}
```
Rufen Sie den Status des Vorgangs mit langer Ausführungszeit ab.
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: das übergeordnete Dataset des DICOM-Speichers
- OPERATION_ID ist die ID, die vom lang andauernden Vorgang zurückgegeben wurde
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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
```
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 folgenden Befehl aus:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
```
Wenn der lang andauernde Vorgang noch läuft, gibt der Server eine Antwort zurück. durch die Anzahl der DICOM-Instanzen, für die eine Änderung der Speicherklasse aussteht. Wenn der Parameter erfolgreich abgeschlossen wurde, gibt der Server eine Antwort mit dem Status des Vorgangs in JSON-Format: <ph type="x-smartling-placeholder">
</ph>
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1beta1.storageinfo.StorageInfoService.SetBlobStorageSettings",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME",
    "logsUrl": https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL,
    "counter": {
      "success": "SUCCESS_COUNT"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}
```

Auf Serienebene

Führen Sie folgende Schritte aus, um die Speicherklasse einer DICOM-Instanz auf Serienebene zu ändern: diese Schritte:

REST

Verwenden Sie die Methode projects.locations.datasets.dicomStores.studies.series.setBlobStorageSettings.

Speicherklasse der DICOM-Instanz in der Serie ändern
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
- STUDY_INSTANCE_UID: die eindeutige Kennung der Studieninstanz
- SERIES_INSTANCE_UID: die eindeutige Kennung der Serieninstanz
- STORAGE_CLASS: die Speicherklasse für das DICOM-Objekt im DICOM-Speicher von STANDARD, NEARLINE, COLDLINE und ARCHIVE
JSON-Text der Anfrage:
```
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
```
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'
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
EOF
```
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID:setBlobStorageSettings"
```
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:
```
@'
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
'@  | 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 POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID:setBlobStorageSettings" | Select-Object -Expand Content
```
Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}
```
Rufen Sie den Status des Vorgangs mit langer Ausführungszeit ab.
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: das übergeordnete Dataset des DICOM-Speichers
- OPERATION_ID ist die ID, die vom lang andauernden Vorgang zurückgegeben wurde
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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
```
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 folgenden Befehl aus:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
```
Wenn der lang andauernde Vorgang noch läuft, gibt der Server eine Antwort zurück. durch die Anzahl der DICOM-Instanzen, für die eine Änderung der Speicherklasse aussteht. Wenn der Parameter erfolgreich abgeschlossen wurde, gibt der Server eine Antwort mit dem Status des Vorgangs in JSON-Format: <ph type="x-smartling-placeholder">
</ph>
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1beta1.storageinfo.StorageInfoService.SetBlobStorageSettings",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME",
    "logsUrl": https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL,
    "counter": {
      "success": "SUCCESS_COUNT"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}
```

Auf Lernniveau

Führen Sie folgende Schritte aus, um die Speicherklasse einer DICOM-Instanz auf Studienebene zu ändern: diese Schritte:

REST

Verwenden Sie die Methode projects.locations.datasets.dicomStores.studies.setBlobStorageSettings.

Speicherklasse der DICOM-Instanz in der Studie ändern
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
- STUDY_INSTANCE_UID: die eindeutige Kennung der Studieninstanz
- STORAGE_CLASS: die Speicherklasse für das DICOM-Objekt im DICOM-Speicher von STANDARD, NEARLINE, COLDLINE und ARCHIVE
JSON-Text der Anfrage:
```
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
```
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'
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
EOF
```
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID:setBlobStorageSettings"
```
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:
```
@'
{
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
'@  | 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 POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID:setBlobStorageSettings" | Select-Object -Expand Content
```
Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}
```
Rufen Sie den Status des Vorgangs mit langer Ausführungszeit ab.
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: das übergeordnete Dataset des DICOM-Speichers
- OPERATION_ID ist die ID, die vom lang andauernden Vorgang zurückgegeben wurde
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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
```
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 folgenden Befehl aus:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
```
Wenn der lang andauernde Vorgang noch läuft, gibt der Server eine Antwort zurück. durch die Anzahl der DICOM-Instanzen, für die eine Änderung der Speicherklasse aussteht. Wenn der Parameter erfolgreich abgeschlossen wurde, gibt der Server eine Antwort mit dem Status des Vorgangs in JSON-Format: <ph type="x-smartling-placeholder">
</ph>
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1beta1.storageinfo.StorageInfoService.SetBlobStorageSettings",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME",
    "logsUrl": https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL,
    "counter": {
      "success": "SUCCESS_COUNT"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}
```

Filter verwenden

Im folgenden Abschnitt wird gezeigt, wie Sie bestimmte Instanzen filtern und ihre Speicherklasse auf Studien-, Serien- oder Instanzebene mithilfe einer Filterdatei.

Sie müssen dem Dienstkonto Healthcare Service Agent die Rolle Storage Object Viewer hinzufügen, das Zugriff auf den Bucket hat, in dem die Filterdatei gespeichert ist.

Filterdatei konfigurieren

Mithilfe einer Filterdatei können Sie die Liste der DICOM-Dateien definieren, deren Speicherklasse geändert werden muss.

Jede Zeile in der Filterdatei definiert die Studie, Serie oder Instanz verwendet das Format /studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID

Sie können eine Zeile kürzen, um festzulegen, auf welcher Ebene der Filter angewendet werden soll. Sie können beispielsweise die Speicherklasse einer gesamten Studie ändern, indem Sie /studies/STUDY_INSTANCE_UID, oder Sie ändern die Speicherklasse eines ganze Reihe angeben, indem Sie /studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID.

Betrachten Sie die folgende Filterdatei:

/studies/1.123.456.789
/studies/1.666.333.111/series/123.456
/studies/1.666.333.111/series/567.890
/studies/1.888.999.222/series/123.456/instances/111
/studies/1.888.999.222/series/123.456/instances/222
/studies/1.888.999.222/series/123.456/instances/333

Mit dieser Filterdatei wird Folgendes gefiltert:

Die gesamte Studie mit der Studieninstanz-UID als 1.123.456.789
Zwei separate Reihen mit Serieninstanz-UIDs als 123.456 und 567.890 in der Studie „1.666.333.111“
Drei einzelne Instanzen mit den Instanz-IDs 111, 222 und 333 in der Studium 1.888.999.222 und Reihe 123.456

Filterdatei mit BigQuery erstellen

Um eine Filterdatei mit BigQuery zu erstellen, müssen Sie Die Metadaten Ihres DICOM-Speichers nach BigQuery exportieren Die exportierten Metadaten zeigt Ihnen die Studien-, Serien- und Instanz-UIDs der DICOM-Daten in Ihrem DICOM speichern.

Führen Sie nach dem Exportieren die folgenden Schritte aus:

Fragen Sie die erforderlichen Studien-, Serien- und Instanz-UIDs ab.

Führen Sie beispielsweise nach dem Exportieren von DICOM-Metadaten nach BigQuery den folgenden Befehl aus: die folgende Abfrage, um die Studie, die Serie und Instanz-UIDs, die den Anforderungen an das Filterdateiformat entsprechen:
```
SELECT CONCAT
    ('/studies/', StudyInstanceUID, '/series/', SeriesInstanceUID, '/instances/', SOPInstanceUID)
FROM
    [PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE]
```
Optional: Wenn die Abfrage eine große Ergebnismenge zurückgibt, die die Maximale Antwortgröße Abfrageergebnisse in einer neuen Zieltabelle speichern in BigQuery.
Speichern Sie die Abfrageergebnisse in einem und exportieren Sie sie in Cloud Storage. Wenn Sie Ihre Abfrageergebnisse in eine neue Zieltabelle in Schritt 2 einfügen, Tabellendaten exportieren, um die in Cloud Storage hochladen.
Bearbeiten Sie die exportierte Datei nach Bedarf und verwenden Sie sie als Filterdatei. Der Speicherort der Filterdatei in Cloud Storage ist erforderlich in die Methode setBlobStorageSettings.

Filterdatei manuell erstellen

Um eine Filterdatei mit benutzerdefiniertem Inhalt und in einen Cloud Storage-Bucket hochladen, führen Sie diese Schritte aus:

Filterdatei mit einer Liste der Instanzen erstellen, deren Speicherklasse benötigt wird auf Ihrem lokalen Rechner zu ändern. Verwenden Sie das in den Filterdatei konfigurieren .
Laden Sie die Filtertextdatei in einen Cloud Storage-Speicherort hoch.
```
gcloud storage cp PATH_TO_FILTER_FILE/FILTER_FILE_NAME.txt gs://BUCKET/DIRECTORY
```
Ersetzen Sie Folgendes:
- PATH_TO_FILTER_FILE: Pfad zur Filterdatei auf Ihrem lokalen Computer
- FILTER_FILE_NAME: der Name der Filterdatei
- BUCKET/DIRECTORY: der Pfad zum Cloud Storage-Speicherort
Beispiel:
```
gcloud storage cp my-local-folder/archive-filters.txt gs://my-bucket/my-directory
```

Filterdatei übergeben

REST

projects.locations.datasets.dicomStores.studies.setBlobStorageSettings verwenden Methode zum Ändern der Speicherklasse aller Instanzen in der Filterdatei unter auf DICOM-Speicherebene.

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
- STORAGE_CLASS: die Speicherklasse für das DICOM-Objekt im DICOM-Speicher von STANDARD, NEARLINE, COLDLINE und ARCHIVE
- BUCKET/DIRECTORY
JSON-Text der Anfrage:
```
{
  "filter_config": {
    "resource_paths_gcs_uri": "gs://BUCKET/DIRECTORY"
  },
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
```
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'
{
  "filter_config": {
    "resource_paths_gcs_uri": "gs://BUCKET/DIRECTORY"
  },
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
EOF
```
Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d @request.json \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:setBlobStorageSettings"
```
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:
```
@'
{
  "filter_config": {
    "resource_paths_gcs_uri": "gs://BUCKET/DIRECTORY"
  },
  "blobStorageSettings": {
    "blob_storage_class": "STORAGE_CLASS"
  }
}
'@  | 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 POST `
    -Headers $headers `
    -ContentType: "application/json" `
    -InFile request.json `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID:setBlobStorageSettings" | Select-Object -Expand Content
```
Die Ausgabe sieht so aus. Die Antwort enthält eine Kennung für einen Vorgang mit langer Ausführungszeit. Lang andauernde Vorgänge werden zurückgegeben, wenn die Ausführung von Methodenaufrufen sehr lange dauern kann. Notieren Sie sich den Wert von OPERATION_ID. Sie benötigen diesen Wert im nächsten Schritt.
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
}
```
Rufen Sie den Status des Vorgangs mit langer Ausführungszeit ab.

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: das übergeordnete Dataset des DICOM-Speichers
- OPERATION_ID ist die ID, die vom lang andauernden Vorgang zurückgegeben wurde
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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"
```
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 folgenden Befehl aus:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand Content
```
Wenn der lang andauernde Vorgang noch läuft, gibt der Server eine Antwort zurück. durch die Anzahl der DICOM-Instanzen, für die eine Änderung der Speicherklasse aussteht. Wenn der Parameter erfolgreich abgeschlossen wurde, gibt der Server eine Antwort mit dem Status des Vorgangs in JSON-Format: <ph type="x-smartling-placeholder">
</ph>
Antwort
```
{
  "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.healthcare.v1beta1.OperationMetadata",
    "apiMethodName": "google.cloud.healthcare.v1beta1.storageinfo.StorageInfoService.SetBlobStorageSettings",
    "createTime": "CREATE_TIME",
    "endTime": "END_TIME",
    "logsUrl": https://console.cloud.google.com/logs/query/CLOUD_LOGGING_URL,
    "counter": {
      "success": "SUCCESS_COUNT"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}
```

Speicherklasse einer DICOM-Instanz prüfen

Methode `getStorageInfo` verwenden

Die folgenden Beispiele zeigen, wie Sie die Speicherklasse einer DICOM-Instanz anzeigen.

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.dicomWebRead

Rollen

REST

Verwenden Sie die Methode projects.locations.datasets.dicomStores.dicomWeb.studies.series.instances.getStorageInfo .

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
STUDY_INSTANCE_UID: die eindeutige Kennung der Studieninstanz
SERIES_INSTANCE_UID: die eindeutige Kennung der Serieninstanz
INSTANCE_UID: die eindeutige Instanzkennzeichnung

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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID:getStorageInfo"

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 folgenden Befehl aus:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID:getStorageInfo" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

Antwort

{
  "referencedResource": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID/dicomWeb/studies/STUDY_INSTANCE_UID/series/SERIES_INSTANCE_UID/instances/INSTANCE_UID",
  "structuredStorageInfo": {
    "sizeBytes": "STRUCTURED_STORAGE_SIZE"
  },
  "blobStorageInfo": {
    "sizeBytes": "DICOM_OBJECT_SIZE",
    "storageClass": "STORAGE_CLASS",
    "storageClassUpdateTime": "STORAGE_CLASS_UPDATE_TIME"
  }
}

Exportierte DICOM-Metadaten in BigQuery abfragen

Sie können auch DICOM-Metadaten nach BigQuery exportieren und fragen Sie das BigQuery-Dataset ab, um die Speicherklassen DICOM-Instanzen.

Sie können beispielsweise die folgende Abfrage ausführen, um die UID der Studieninstanz anzusehen: die Serieninstanz-UID, die Instanz-UID, die Blob-Speichergröße und das Blob Speicherklasse aller Instanzen in Ihrem BigQuery-Dataset:

SELECT StudyInstanceUID,SeriesInstanceUID,SOPInstanceUID,BlobStorageSize,StorageClass FROM PROJECT_ID:BIGQUERY_DATASET.BIGQUERY_TABLE LIMIT 1000

DICOM-Speicherklasse ändern

Übersicht

Methoden zum Ändern der DICOM-Speicherklasse

Hinweise

Speicherklasse einer DICOM-Instanz ändern

Erforderliche Berechtigungen für diese Aufgabe

Auf Instanzebene

REST

curl

PowerShell

Antwort

curl

PowerShell

Antwort

Auf Serienebene

REST

curl

PowerShell

Antwort

curl

PowerShell

Antwort

Auf Lernniveau

REST

curl

PowerShell

Antwort

curl

PowerShell

Antwort

Filter verwenden

Filterdatei konfigurieren

Filterdatei mit BigQuery erstellen

Filterdatei manuell erstellen

Filterdatei übergeben

REST

curl

PowerShell

Antwort

curl

PowerShell

Antwort

Speicherklasse einer DICOM-Instanz prüfen

Methode getStorageInfo verwenden

Erforderliche Berechtigungen für diese Aufgabe

REST

curl

PowerShell

Antwort

Exportierte DICOM-Metadaten in BigQuery abfragen

Methode `getStorageInfo` verwenden