Annotationsspeicher erstellen und verwalten

Auf dieser Seite wird erläutert, wie Sie Annotationsspeicher erstellen, mit Labels versehen, anzeigen, auflisten und löschen. Annotationsspeicher enthalten Annotations-Datensätze. Das sind Label, die Sie Gesundheitsressourcen hinzufügen können.

Eine Übersicht über Annotationsspeicher und Annotations-Datensätze finden Sie unter Annotationen.

Annotationsspeicher erstellen

Bevor Sie einen Annotationsspeicher erstellen können, müssen Sie ein Dataset erstellen.

Die folgenden Beispiele zeigen, wie ein Annotationsspeicher erstellt wird.

gcloud

Führen Sie den Befehl gcloud beta healthcare annotation-stores create aus, um einen Annotationsspeicher zu erstellen:

  • Die ANNOTATION_STORE_ID muss innerhalb der Region 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.
gcloud beta healthcare annotation-stores create ANNOTATION_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION

Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung die folgende Meldung angezeigt:

Created annotationStore [ANNOTATION_STORE_ID].

API

Verwenden Sie zum Erstellen eines Annotationsspeichers die Methode projects.locations.datasets.annotationStores.create.

curl

Um einen Annotationsspeicher zu erstellen, senden Sie eine POST-Anfrage und geben Sie die folgenden Informationen an:

  • Das übergeordnete Dataset
  • Ein Name für den Annotationsspeicher. Die Store-ID für die Annotation 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

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/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores?annotationStoreId=ANNOTATION_STORE_ID"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

PowerShell

Um einen Annotationsspeicher zu erstellen, senden Sie eine POST-Anfrage und geben Sie die folgenden Informationen an:

  • Das übergeordnete Dataset
  • Ein Name für den Annotationsspeicher. Die Store-ID für die Annotation 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

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/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores?annotationStoreId=ANNOTATION_STORE_ID" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

Label für Annotationsspeicher

Sie können einem Annotationsspeicher ein oder mehrere Schlüssel/Wert-Labels hinzufügen. Ein Anwendungsfall für das Hinzufügen von Labels könnte das Hinzufügen von Labels und Tags für Annotationsdatensätze in Bezug auf Text oder Bilder sein.

In den folgenden Beispielen wird gezeigt, wie Sie einem Annotationsspeicher Labels hinzufügen.

gcloud

Die gcloud CLI unterstützt das Bearbeiten von Labels für Annotationsspeicher nicht. Verwenden Sie stattdessen curl, Windows PowerShell oder Ihre bevorzugte Sprache.

API

Verwenden Sie den Befehl projects.locations.datasets.annotationStores.patch, um einem Annotationsspeicher Labels hinzuzufügen.

curl

Wenn Sie einen Annotationsspeicher mit einem Label versehen möchten, senden Sie eine PATCH-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des Annotationsspeichers
  • Die zu aktualisierenden Labeldaten
  • 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 "{
      'labels': {
        'KEY': 'VALUE'
      }
    }" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID?updateMask=labels"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID",
  "labels": {
    "KEY": "VALUE"
  }
}

PowerShell

Wenn Sie einen Annotationsspeicher mit einem Label versehen möchten, senden Sie eine PATCH-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des Annotationsspeichers
  • Die zu aktualisierenden Labeldaten
  • 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 "{
      'labels': {
        'KEY': 'VALUE'
      }
  }" `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID?updateMask=labels" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID",
  "labels": {
    "KEY": "VALUE"
  }
}

Details zu einem Annotationsspeicher abrufen

Die folgenden Beispiele zeigen, wie Sie Details zu einem Annotationsspeicher erhalten.

gcloud

Führen Sie den Befehl gcloud beta healthcare annotation-stores describe aus, um Details zu einem Annotationsspeicher abzurufen:

gcloud beta healthcare annotation-stores describe ANNOTATION_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION

Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die Speicherinformationen für die Annotation angezeigt:

name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/annotation-stores/ANNOTATION_STORE_ID

API

Verwenden Sie die Methode projects.locations.datasets.annotationStores.get, um Details zu einem Annotationsspeicher abzurufen.

curl

Wenn Sie Details zu einem Annotationsspeicher abrufen möchten, stellen Sie eine GET-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des Annotationsspeichers
  • 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/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

Wenn Sie in der Ressource AnnotationStore Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.

PowerShell

Wenn Sie Details zu einem Annotationsspeicher abrufen möchten, stellen Sie eine GET-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des Annotationsspeichers
  • 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/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
}

Wenn Sie in der Ressource AnnotationStore Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.

Annotationsspeicher in einem Dataset auflisten

Die folgenden Beispiele zeigen, wie die Annotationsspeicher in einem Dataset aufgelistet werden.

gcloud

Führen Sie den Befehl gcloud beta healthcare annotation-stores list aus, um die Annotationsspeicher in einem Dataset aufzulisten:

gcloud beta healthcare annotation-stores list \
  --dataset=DATASET_ID \
  --location=LOCATION

Wenn die Anfrage erfolgreich ist, werden in der Eingabeaufforderung die Speicher für die Annotation aufgelistet:

ID                   LOCATION
ANNOTATION_STORE_ID  LOCATION

API

Verwenden Sie die Methode projects.locations.datasets.annotationStores.list, um die Annotationsspeicher in einem Dataset aufzulisten.

curl

Wenn Sie die Annotationsspeicher 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 curl.

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores"

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "annotationStores": [
    {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
    },
    {
      ...
    }
  ]
}

Wenn Sie in der Ressource AnnotationStore Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.

PowerShell

Wenn Sie die Annotationsspeicher 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/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, gibt der Server die Antwort im JSON-Format zurück:

{
  "annotationStores": [
    {
      "name": "projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"
    },
    {
      ...
    }
  ]
}

Wenn Sie in der Ressource AnnotationStore Felder konfiguriert haben, werden diese auch in der Antwort angezeigt.

Annotationsspeicher löschen

Die folgenden Beispiele zeigen, wie ein Annotationsspeicher gelöscht wird.

gcloud

Führen Sie den Befehl gcloud beta healthcare annotation-stores delete aus, um einen Annotationsspeicher zu löschen:

  1. Führen Sie den Befehl delete aus:

    gcloud beta healthcare annotation-stores delete ANNOTATION_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION

  2. Geben Sie zur Bestätigung Y ein.

Wenn die Anfrage erfolgreich ist, wird in der Eingabeaufforderung Folgendes angezeigt:

Deleted annotationStore [ANNOTATION_STORE_ID].

API

Verwenden Sie den Befehl projects.locations.datasets.annotationStores.delete, um einen Annotationsspeicher zu löschen.

curl

Wenn Sie einen Annotationsspeicher löschen möchten, senden Sie eine DELETE-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des Annotationsspeichers
  • 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/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID"

Wenn die Anfrage erfolgreich ist, gibt der Server einen leeren Antworttext im JSON-Format zurück:

{}

PowerShell

Wenn Sie einen Annotationsspeicher löschen möchten, senden Sie eine DELETE-Anfrage und geben Sie die folgenden Informationen an:

  • Der Name des übergeordneten Datasets
  • Der Name des Annotationsspeichers
  • 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 `
  -Uri "https://healthcare.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/datasets/DATASET_ID/annotationStores/ANNOTATION_STORE_ID" | Select-Object -Expand Content

Wenn die Anfrage erfolgreich ist, gibt der Server einen leeren Antworttext im JSON-Format zurück:

{}