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.
gcloud
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].
API
Untuk membuat penyimpanan anotasi, gunakan metode projects.locations.datasets.annotationStores.create.
curl
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"
}
PowerShell
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.
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 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"
}
}
PowerShell
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.
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 di 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 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.
gcloud
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
API
Untuk mencantumkan penyimpanan anotasi 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 di 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 di 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:
{}