Membuat dan mengelola penyimpanan anotasi

Halaman ini menjelaskan cara membuat, memberi label, melihat, mencantumkan, dan menghapus penyimpanan anotasi. Penyimpanan anotasi menyimpan data anotasi, yang merupakan label yang dapat Anda tambahkan ke resource layanan kesehatan.

Untuk ringkasan penyimpanan anotasi dan data anotasi, lihat Anotasi.

Membuat penyimpanan anotasi

Sebelum dapat membuat penyimpanan anotasi, Anda harus membuat set data.

Contoh berikut menunjukkan cara membuat penyimpanan anotasi.

gcloudAPI

Untuk membuat penyimpanan anotasi, jalankan perintah gcloud beta healthcare annotation-stores create:

  • ANNOTATION_STORE_ID harus unik dalam region. String ini dapat berupa string Unicode dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
gcloud beta healthcare annotation-stores create ANNOTATION_STORE_ID \
  --dataset=DATASET_ID \
  --location=LOCATION

Jika permintaan berhasil, command prompt akan menampilkan pesan berikut:

Created annotationStore [ANNOTATION_STORE_ID].

Untuk membuat penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.create.

curlPowerShell

Untuk membuat penyimpanan anotasi, buat permintaan POST dan tentukan informasi berikut:

  • Set data induk
  • Nama untuk penyimpanan anotasi. ID penyimpanan anotasi harus unik dalam set data induknya. String ini dapat berupa string Unicode dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
  • Token akses

Contoh berikut menunjukkan permintaan POST yang menggunakan 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"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Untuk membuat penyimpanan anotasi, buat permintaan POST dan tentukan informasi berikut:

  • Set data induk
  • Nama untuk penyimpanan anotasi. ID penyimpanan anotasi harus unik dalam set data induknya. String ini dapat berupa string Unicode dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
  • Token akses

Contoh berikut menunjukkan permintaan POST menggunakan 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

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Memberi label pada penyimpanan anotasi

Anda dapat menambahkan satu atau beberapa label nilai kunci ke penyimpanan anotasi. Salah satu kasus penggunaan untuk menambahkan label adalah menambahkan label dan tag untuk data anotasi yang terkait dengan teks atau gambar.

Contoh berikut menunjukkan cara menambahkan label ke penyimpanan anotasi.

gcloudAPI

gcloud CLI tidak mendukung pengeditan label penyimpanan anotasi. Sebagai gantinya, gunakan curl, Windows PowerShell, atau bahasa pilihan Anda.

Untuk menambahkan label ke penyimpanan anotasi, gunakan perintah projects.locations.datasets.annotationStores.patch.

curlPowerShell

Untuk memberi label pada penyimpanan anotasi, buat permintaan PATCH dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Data label yang akan diperbarui
  • Mask update
  • Token akses

Contoh berikut menunjukkan permintaan PATCH yang menggunakan 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"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Untuk memberi label pada penyimpanan anotasi, buat permintaan PATCH dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Data label yang akan diperbarui
  • Mask update
  • Token akses

Contoh berikut menunjukkan permintaan PATCH menggunakan 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

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Mendapatkan detail penyimpanan anotasi

Contoh berikut menunjukkan cara mendapatkan detail tentang penyimpanan anotasi.

gcloudAPI

Untuk mendapatkan detail tentang penyimpanan anotasi, jalankan perintah gcloud beta healthcare annotation-stores describe:

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

Jika permintaan berhasil, command prompt akan menampilkan detail penyimpanan anotasi:

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

Untuk mendapatkan detail tentang penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.get.

curlPowerShell

Untuk mendapatkan detail tentang penyimpanan anotasi, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan GET yang menggunakan 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"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Jika Anda mengonfigurasi kolom apa pun di resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

Untuk mendapatkan detail tentang penyimpanan anotasi, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan GET menggunakan 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

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Jika Anda mengonfigurasi kolom apa pun di resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

Mencantumkan penyimpanan anotasi dalam set data

Contoh berikut menunjukkan cara mencantumkan penyimpanan anotasi dalam set data.

gcloudAPI

Untuk mencantumkan penyimpanan anotasi dalam set data, jalankan perintah gcloud beta healthcare annotation-stores list:

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

Jika permintaan berhasil, perintah akan mencantumkan penyimpanan anotasi:

ID                   LOCATION
ANNOTATION_STORE_ID  LOCATION

Untuk mencantumkan penyimpanan anotasi dalam set data, gunakan metode projects.locations.datasets.annotationStores.list.

curlPowerShell

Untuk mencantumkan penyimpanan anotasi dalam set data, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Token akses

Contoh berikut menunjukkan permintaan GET yang menggunakan 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"

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Jika Anda mengonfigurasi kolom apa pun di resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

Untuk mencantumkan penyimpanan anotasi dalam set data, buat permintaan GET dan berikan informasi berikut:

  • Nama set data induk
  • Token akses

Contoh berikut menunjukkan permintaan GET menggunakan 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

Jika permintaan berhasil, server akan menampilkan respons dalam format JSON:

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

Jika Anda mengonfigurasi kolom apa pun di resource AnnotationStore, kolom tersebut juga akan muncul dalam respons.

Menghapus penyimpanan anotasi

Contoh berikut menunjukkan cara menghapus penyimpanan anotasi.

gcloudAPI

Untuk menghapus penyimpanan anotasi, jalankan perintah gcloud beta healthcare annotation-stores delete:

  1. Jalankan perintah delete.

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

  2. Untuk mengonfirmasi, ketik Y.

Jika permintaan berhasil, command prompt akan menampilkan hal berikut:

Deleted annotationStore [ANNOTATION_STORE_ID].

Untuk menghapus penyimpanan anotasi, gunakan perintah projects.locations.datasets.annotationStores.delete.

curlPowerShell

Untuk menghapus penyimpanan anotasi, buat permintaan DELETE dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan DELETE yang menggunakan 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"

Jika permintaan berhasil, server akan menampilkan isi respons kosong dalam format JSON:

{}

Untuk menghapus penyimpanan anotasi, buat permintaan DELETE dan berikan informasi berikut:

  • Nama set data induk
  • Nama penyimpanan anotasi
  • Token akses

Contoh berikut menunjukkan permintaan DELETE menggunakan 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

Jika permintaan berhasil, server akan menampilkan isi respons kosong dalam format JSON:

{}