Halaman ini menjelaskan cara membuat, mengedit, melihat, mencantumkan, dan menghapus penyimpanan Digital Imaging and Communications in Medicine (DICOM).
DICOM menyimpan instance DICOM. Anda dapat menambahkan dan mengelola instance DICOM di penyimpanan DICOM menggunakan implementasi DICOMweb di Cloud Healthcare API, atau Anda dapat mengimpor dan mengekspor instance DICOM menggunakan layanan Google Cloud.
Untuk mengetahui informasi selengkapnya tentang kepatuhan Cloud Healthcare API dengan standar DICOM, lihat pernyataan kesesuaian DICOM.
Membuat penyimpanan DICOM
Sebelum dapat membuat penyimpanan DICOM, Anda harus membuat set data.
Contoh berikut menunjukkan cara membuat penyimpanan DICOM:
Konsol
Untuk membuat penyimpanan DICOM:
- Di konsol Google Cloud, buka halaman Datasets.
- Pilih {i>dataset<i} tempat Anda ingin membuat penyimpanan DICOM.
- Klik Create Data Store.
- Pilih DICOM sebagai jenis penyimpanan data.
- Masukkan nama pilihan yang unik dalam set data Anda. Jika namanya tidak unik, pembuatan penyimpanan data akan gagal.
- Klik Next.
-
Jika ingin mengonfigurasi topik Pub/Sub untuk penyimpanan data, klik Receive
Cloud Pub/Sub notifications dan pilih nama topik.
Saat menentukan topik Pub/Sub, masukkan URI yang memenuhi syarat ke topik tersebut, seperti yang ditunjukkan pada
contoh berikut:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Klik Next.
- Untuk menambahkan satu atau beberapa label ke penyimpanan, klik Tambahkan Label untuk mengatur penyimpanan data dan masukkan label kunci/nilai. Untuk mengetahui informasi selengkapnya tentang label resource, lihat Menggunakan label resource.
- Klik Create.
Penyimpanan data baru akan muncul dalam daftar.
gcloud
Untuk membuat penyimpanan DICOM, jalankan perintah gcloud healthcare dicom-stores create
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
LOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID untuk penyimpanan DICOM. ID penyimpanan DICOM harus memiliki hal berikut:- ID unik dalam set datanya
- String Unicode yang terdiri dari 1-256 karakter yang terdiri dari hal berikut:
- Numbers
- Surat
- Tanda garis bawah
- Tanda hubung garis
- Menstruasi
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores create DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores create DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Anda akan melihat respons seperti berikut:
Respons
Created dicomStore [DICOM_STORE_ID].
REST
Untuk membuat penyimpanan DICOM, gunakan metode projects.locations.datasets.dicomStores.create
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID untuk penyimpanan DICOM. ID penyimpanan DICOM harus memiliki hal berikut:- ID unik dalam set datanya
- String Unicode yang terdiri dari 1-256 karakter yang terdiri dari hal berikut:
- Numbers
- Surat
- Tanda garis bawah
- Tanda hubung garis
- Menstruasi
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
APIs Explorer
Buka halaman referensi metode. Panel APIs Explorer akan terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan melihat respons JSON seperti berikut:
Go
Java
Node.js
Python
Mengedit penyimpanan DICOM
Contoh berikut menunjukkan cara membuat perubahan berikut pada penyimpanan DICOM:
- Edit topik Pub/Sub yang akan menjadi tujuan pengiriman notifikasi perubahan penyimpanan DICOM oleh Cloud Healthcare API.
- Edit label. Label adalah key-value pair yang membantu Anda mengatur resource Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPICAgar notifikasi dapat berfungsi, Anda harus memberikan izin tambahan ke akun layanan Agen Layanan Cloud Healthcare. Untuk mengetahui informasi selengkapnya, lihat izin Pub/Sub penyimpanan DICOM, FHIR, dan HL7v2.
Konsol
Untuk mengedit penyimpanan DICOM, selesaikan langkah-langkah berikut:
- Di konsol Google Cloud, buka halaman Datasets.
- Pilih set data berisi penyimpanan DICOM yang ingin Anda edit.
- Di daftar Penyimpanan data, klik penyimpanan data yang ingin diedit.
- Jika Anda ingin mengonfigurasi topik Pub/Sub untuk penyimpanan data, pilih nama topik dari Select a Cloud Pub/Sub Topic.
- Untuk menambahkan satu atau beberapa label ke toko, klik Menggunakan label resource. Label, klik Tambahkan label, lalu masukkan label kunci/nilai. Untuk mengetahui informasi selengkapnya tentang label resource, lihat
- Klik Save.
gcloud
Untuk mengedit penyimpanan DICOM, jalankan perintah gcloud healthcare dicom-stores update
.
Gcloud CLI tidak mendukung pengeditan label.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
LOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID penyimpanan DICOMPUBSUB_TOPIC
: topik Pub/Sub tempat pesan dipublikasikan saat terjadi peristiwa di penyimpanan data
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (PowerShell)
gcloud healthcare dicom-stores update DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (cmd.exe)
gcloud healthcare dicom-stores update DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Anda akan melihat respons seperti berikut:
Respons
Updated dicomStore [DICOM_STORE_ID]. ... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
REST
Untuk mengedit penyimpanan DICOM, gunakan metode projects.locations.datasets.dicomStores.patch
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID penyimpanan DICOMPUBSUB_TOPIC
: topik Pub/Sub tempat pesan dipublikasikan saat terjadi peristiwa di penyimpanan dataKEY_1
: kunci label pertamaVALUE_1
: nilai label pertamaKEY_2
: kunci label keduaVALUE_2
: nilai label kedua
Meminta isi JSON:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json
.
Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
Kemudian, jalankan perintah berikut untuk mengirim permintaan REST Anda:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
Simpan isi permintaan dalam file bernama request.json
.
Jalankan perintah berikut di terminal untuk membuat atau menimpa file ini di direktori saat ini:
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Kemudian jalankan perintah berikut untuk mengirim permintaan REST Anda:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
APIs Explorer
Salin isi permintaan dan buka halaman referensi metode. Panel APIs Explorer akan terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Tempelkan isi permintaan di alat ini, lengkapi kolom wajib lainnya, lalu klik Jalankan.
Anda akan menerima respons seperti berikut.
Jika Anda mengonfigurasi kolom apa pun di resource DicomStore
, kolom tersebut juga akan muncul dalam respons.
Go
Java
Node.js
Python
Mendapatkan detail toko DICOM
Contoh berikut menunjukkan cara mendapatkan detail tentang penyimpanan DICOM.
Konsol
Untuk melihat detail toko DICOM:
- Di konsol Google Cloud, buka halaman Datasets.
- Pilih set data berisi penyimpanan DICOM yang ingin Anda lihat.
- Klik nama penyimpanan DICOM.
Tab Ringkasan menampilkan detail toko DICOM yang dipilih. Tab Metrics menampilkan metrik penyimpanan DICOM, studi DICOM, dan metrik deret DICOM. Untuk informasi selengkapnya, lihat Melihat metrik seri DICOM, studi DICOM, dan penyimpanan DICOM.
gcloud
Untuk mendapatkan detail tentang penyimpanan DICOM, jalankan perintah gcloud healthcare dicom-stores describe
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID penyimpanan DICOM
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Anda akan menerima respons seperti berikut.
Jika Anda mengonfigurasi kolom apa pun di resource DicomStore
, kolom tersebut juga akan muncul dalam respons.
Respons
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
Untuk mendapatkan detail tentang penyimpanan DICOM, gunakan metode projects.locations.datasets.dicomStores.get
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID penyimpanan DICOM
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
APIs Explorer
Buka halaman referensi metode. Panel APIs Explorer akan terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan menerima respons seperti berikut.
Jika Anda mengonfigurasi kolom apa pun di resource DicomStore
, kolom tersebut juga akan muncul dalam respons.
Go
Java
Node.js
Python
Mencantumkan penyimpanan DICOM dalam {i>dataset<i}
Contoh berikut menunjukkan cara membuat daftar penyimpanan DICOM dalam set data:
Konsol
Untuk melihat penyimpanan data dalam sebuah {i>dataset<i}:
- Di konsol Google Cloud, buka halaman Datasets.
- Pilih {i>dataset<i} berisi penyimpanan data yang ingin Anda lihat.
gcloud
Untuk menampilkan daftar penyimpanan DICOM dalam set data, jalankan perintah gcloud healthcare dicom-stores list
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOM
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud healthcare dicom-stores list \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores list ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores list ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Anda akan menerima respons seperti berikut.
Jika Anda mengonfigurasi kolom apa pun di resource DicomStore
, kolom tersebut juga akan muncul dalam respons.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Untuk mencantumkan penyimpanan DICOM dalam set data, gunakan metode projects.locations.datasets.dicomStores.list
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOM
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores" | Select-Object -Expand Content
APIs Explorer
Buka halaman referensi metode. Panel APIs Explorer akan terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan menerima respons seperti berikut.
Jika Anda mengonfigurasi kolom apa pun di resource DicomStore
, kolom tersebut juga akan muncul dalam respons.
Go
Java
Node.js
Python
Menghapus penyimpanan DICOM
Contoh berikut menunjukkan cara menghapus penyimpanan DICOM:
Konsol
Untuk menghapus penyimpanan data:
- Di konsol Google Cloud, buka halaman Datasets.
- Pilih set data berisi penyimpanan data yang ingin Anda hapus.
- Pilih Hapus dari menu drop-down Tindakan untuk penyimpanan data yang ingin Anda hapus.
- Untuk mengonfirmasi, ketik nama penyimpanan data, lalu klik Hapus.
gcloud
Untuk menghapus penyimpanan DICOM, jalankan perintah gcloud healthcare dicom-stores delete
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
LOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID penyimpanan DICOM
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID].
REST
Untuk menghapus penyimpanan DICOM, gunakan metode projects.locations.datasets.dicomStores.delete
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
PROJECT_ID
: ID project Google Cloud AndaLOCATION
: lokasi set dataDATASET_ID
: set data induk penyimpanan DICOMDICOM_STORE_ID
: ID penyimpanan DICOM
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Jalankan perintah berikut:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
Jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
APIs Explorer
Buka halaman referensi metode. Panel APIs Explorer akan terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan melihat respons JSON seperti berikut: