Halaman ini menjelaskan cara membuat, memberi label, melihat, mencantumkan, dan menghapus penyimpanan anotasi. Penyimpanan Annotation menyimpan data anotasi, yang merupakan label yang dapat Anda tambahkan ke resource layanan kesehatan.
Untuk ringkasan penyimpanan anotasi dan catatan anotasi, lihat Anotasi.
Membuat penyimpanan anotasi
Sebelum dapat membuat penyimpanan anotasi, Anda perlu membuat set data.
Contoh berikut menunjukkan cara membuat penyimpanan anotasi.
gcloud
Untuk membuat penyimpanan anotasi, jalankan
perintah
gcloud beta healthcare annotation-stores create
:
- ANNOTATION_STORE_ID harus unik di dalam wilayah. String ini dapat berupa string Unicode yang terdiri 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].
API
Untuk membuat penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.create
.
curl
Untuk membuat penyimpanan anotasi, buat permintaan POST
dan tentukan informasi
berikut:
- {i>Dataset<i} induk
- Nama untuk penyimpanan anotasi. ID penyimpanan anotasi harus unik dalam set data induknya. Bisa berupa string Unicode apa pun dari 1 hingga 256 karakter yang terdiri dari angka, huruf, garis bawah, tanda hubung, dan titik.
- Token akses
Contoh berikut menunjukkan permintaan POST
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" }
PowerShell
Untuk membuat penyimpanan anotasi, buat permintaan POST
dan tentukan informasi
berikut:
- {i>Dataset<i} induk
- Nama untuk penyimpanan anotasi. ID penyimpanan anotasi harus unik dalam set data induknya. Bisa berupa string Unicode apa pun 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 catatan anotasi yang terkait dengan teks atau gambar.
Contoh berikut menunjukkan cara menambahkan label ke penyimpanan anotasi.
gcloud
Gcloud CLI tidak mendukung pengeditan label penyimpanan anotasi.
Sebagai gantinya, gunakan curl
, Windows PowerShell, atau bahasa
pilihan Anda.
API
Untuk menambahkan label ke penyimpanan anotasi, gunakan perintah projects.locations.datasets.annotationStores.patch
.
curl
Untuk memberi label penyimpanan anotasi, buat permintaan PATCH
dan berikan informasi
berikut:
- Nama set data induk
- Nama penyimpanan anotasi
- Data label yang akan diperbarui
- Mask pembaruan
- 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" } }
PowerShell
Untuk memberi label penyimpanan anotasi, buat permintaan PATCH
dan berikan informasi
berikut:
- Nama set data induk
- Nama penyimpanan anotasi
- Data label yang akan diperbarui
- Mask pembaruan
- 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.
gcloud
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
API
Untuk mendapatkan detail tentang penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.get
.
curl
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 dalam resource AnnotationStore
, kolom tersebut juga akan muncul dalam respons.
PowerShell
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 dalam resource AnnotationStore
, kolom tersebut juga akan muncul dalam respons.
Anotasi listingan disimpan dalam set data
Contoh berikut menunjukkan cara mencantumkan anotasi yang disimpan dalam set data.
gcloud
Untuk menampilkan daftar yang disimpan 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, command prompt akan mencantumkan penyimpanan anotasi:
ID LOCATION ANNOTATION_STORE_ID LOCATION
API
Untuk mencantumkan anotasi yang disimpan dalam set data, gunakan metode projects.locations.datasets.annotationStores.list
.
curl
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 dalam resource AnnotationStore
, kolom tersebut juga akan muncul dalam respons.
PowerShell
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 dalam resource AnnotationStore
, kolom tersebut juga akan muncul dalam respons.
Menghapus penyimpanan anotasi
Contoh berikut menunjukkan cara menghapus penyimpanan anotasi.
gcloud
Untuk menghapus penyimpanan anotasi, jalankan
perintah
gcloud beta healthcare annotation-stores delete
:
Jalankan perintah
delete
.gcloud beta healthcare annotation-stores delete ANNOTATION_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Untuk mengonfirmasi, ketik Y.
Jika permintaan berhasil, command prompt akan menampilkan hal berikut:
Deleted annotationStore [ANNOTATION_STORE_ID].
API
Untuk menghapus penyimpanan anotasi, gunakan perintah projects.locations.datasets.annotationStores.delete
.
curl
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:
{}
PowerShell
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:
{}