Kuota dan batas

Cloud Healthcare API memberlakukan batas pada penggunaan resource karena berbagai alasan. Misalnya, kuota melindungi komunitas pengguna Google Cloud dengan mencegah lonjakan penggunaan yang tidak terduga. Google Cloud juga menawarkan kuota uji coba gratis yang menyediakan akses terbatas bagi pengguna yang menjelajahi Google Cloud, termasuk Cloud Healthcare API.

Kuota untuk Cloud Healthcare API diterapkan per project berdasarkan per region atau multi-region. Kehabisan kuota di satu region tidak memengaruhi penggunaan Cloud Healthcare API Anda di region lain.

Memeriksa kuota dan penggunaan

Kuota adalah batas penyimpanan (juga disebut batas masuk) dan operasi.

Untuk memeriksa kuota yang tersedia untuk resource di project Anda, buka halaman Kuota di Konsol Google Cloud.

Untuk hanya menampilkan kuota Cloud Healthcare API, di menu drop-down Filter table, pilih Service, lalu pilih Cloud Healthcare API.

Tidak semua project memiliki kuota yang sama. Seiring meningkatnya penggunaan Cloud Healthcare API Anda dari waktu ke waktu, kuota Anda juga dapat terus meningkat. Jika Anda memperkirakan adanya peningkatan penggunaan yang signifikan di masa mendatang, Anda dapat secara proaktif meminta penyesuaian kuota dari halaman Kuota di konsol Google Cloud. Meminta peningkatan kuota tidak dikenakan biaya. Biaya akan meningkat hanya jika resource yang Anda gunakan melebihi batas.

Batas resource

Cloud Healthcare API membatasi ukuran konten permintaan, seperti ukuran gambar X-ray dalam permintaan DICOM. Anda tidak dapat meminta perubahan pada batas resource; tetapi, dalam beberapa situasi, Anda dapat menggunakan operasi impor untuk mengimpor konten yang lebih besar dari batas resource.

Batas resource berikut berlaku dan dapat berubah sewaktu-waktu.

Modalitas Batas ukuran permintaan
DICOM
  • Transaksi penyimpanan: Tidak terbatas. Semua metode lainnya 10 MB.
  • Menyimpan transaksi atau mengambil transaksi: Waktu tunggu habis jika operasi melebihi satu jam.
  • Metode transaksi penelusuran memiliki offset maksimum 1.000.000 dan batas maksimum 5.000 untuk studi/serial dan 50.000 untuk instance.
  • De-identifikasi: De-identifikasi tidak dapat memproses file DICOM yang lebih besar dari 1 GB jika melibatkan penyamaran piksel.
  • File DICOM yang ditransfer memiliki batas 2 GB per tag. Batas ini mencakup PixelData yang dienkode dalam format native.
  • Saat melakukan transcoding data DICOM, ukuran file maksimum adalah 1 GB dan ukuran frame maksimum adalah 150 MB.
  • dicomStores.import: Ukuran file maksimum adalah 100 GB.
FHIR
HL7v2 10 MB

Jika Anda mencoba memproses konten yang lebih besar dari batas resource terkait, error akan terjadi.

Batas ukuran executeBundle FHIR

Anda dapat menggunakan metode fhir.executeBundle untuk melakukan beberapa operasi FHIR dalam satu permintaan API. Jumlah operasi bergantung pada jumlah entri dalam batch atau paket transaksi. Pendekatan ini lebih efisien daripada membuat panggilan API satu per satu untuk setiap operasi.

Waktu pemrosesan untuk permintaan fhir.executeBundle meningkat seiring dengan jumlah entri dalam paket. Faktor seperti pertentangan resource (misalnya, memperbarui resource yang sama sebagai bagian dari banyak paket transaksi secara paralel) juga dapat memengaruhi performa. Untuk mengetahui contoh kapan pertentangan resource dapat terjadi dan cara mencegahnya agar tidak menyebabkan error, lihat Praktik terbaik throughput data. Paket besar, terutama yang melebihi 1.000 entri, mungkin kehabisan waktu tunggu dan gagal diselesaikan.

Untuk memastikan pemrosesan yang berhasil dan tepat waktu, pertimbangkan batas berikut saat mengirim permintaan fhir.executeBundle:

  • Paket transaksi: Paket yang melebihi 4.500 entri akan segera ditolak untuk mencegah waktu tunggu habis. Paket transaksi memerlukan semua operasi agar berhasil.
  • Paket batch: Tidak ada batas entri tertentu, tetapi paket yang lebih besar meningkatkan risiko waktu tunggu habis. Waktu tunggu habis dapat menyebabkan keberhasilan sebagian, dengan hanya beberapa entri yang diproses.

Menggunakan operasi impor untuk konten yang melebihi batas resource

Operasi impor memungkinkan Anda memproses konten yang lebih besar dari batas resource terkait. Ukuran konten dalam operasi impor hanya dibatasi oleh ukuran penyimpanan maksimum Google Cloud sebesar 5 TB untuk setiap objek. Operasi impor tunduk pada kuota penyimpanan yang menentukan berapa lama waktu yang diperlukan untuk operasi impor. Anda mungkin ingin menggunakan operasi impor, misalnya, jika ingin menyimpan banyak instance DICOM di penyimpanan DICOM dan tidak ingin tunduk pada batas ukuran permintaan. Daripada mengupload instance menggunakan metode Transaksi Penyimpanan yang tersedia, Anda dapat mengupload instance ke bucket Cloud Storage, lalu mengimpornya ke penyimpanan DICOM.

Untuk mengetahui langkah-langkah mendetail dalam mengimpor data DICOM menggunakan operasi impor, lihat Mengimpor dan mengekspor data DICOM.

Untuk mengetahui langkah-langkah mendetail guna mengimpor resource FHIR menggunakan operasi impor, lihat Mengimpor dan mengekspor Resource FHIR.

Untuk mengetahui langkah-langkah mendetail guna mengimpor pesan HL7v2 menggunakan operasi impor, lihat Mengimpor pesan HL7v2 dari Cloud Storage.

Meminta perubahan kuota

Untuk meminta perubahan pada kuota, Anda harus memiliki izin serviceusage.quotas.update. Izin ini disertakan secara default untuk peran bawaan berikut: Pemilik, Editor, dan Administrator Kuota.

  1. Buka halaman Kuota.

    Buka Kuota

  2. Di halaman Kuota, pilih kuota yang ingin diubah. Jika Anda ingin hanya menampilkan kuota Cloud Healthcare API, pilih Layanan dari menu drop-down Filter table, lalu pilih Cloud Healthcare API.

  3. Centang kotak kuota yang ingin Anda edit.

  4. Klik tombol Edit Kuota di bagian atas halaman.

  5. Isi formulir, lalu klik Berikutnya.

  6. Masukkan batas yang Anda minta, lalu klik Berikutnya.

  7. Klik Submit request.

Permintaan untuk mengurangi kuota ditolak secara default. Jika Anda ingin mengurangi kuota, balas email dukungan dengan penjelasan tentang persyaratan Anda. Perwakilan dukungan akan menanggapi permintaan Anda.

Anda akan menerima respons dari tim Cloud Healthcare API dalam waktu 24 hingga 48 jam setelah permintaan dikirimkan.

Rencanakan untuk meminta resource tambahan setidaknya beberapa hari sebelumnya untuk memastikan bahwa tersedia waktu yang cukup untuk memenuhi permintaan Anda.

Permintaan kuota lokasi

Anda dapat meminta penambahan kuota untuk Cloud Healthcare API di region tertentu, atau di lokasi multi-region.

Untuk meminta penambahan kuota di satu region: Dalam permintaan penambahan kuota, tentukan region.

Untuk meminta penambahan kuota di lokasi multi-region:

  • Untuk penambahan kuota di multi-region us, nyatakan dalam permintaan Anda bahwa kuota tersebut untuk "region meta AS".
  • Untuk penambahan kuota di multi-region eu, nyatakan dalam permintaan Anda bahwa kuota tersebut untuk "region meta Uni Eropa".

Batas kuota

Bagian berikut menjelaskan kuota yang terkait dengan operasi dan penyimpanan data Cloud Healthcare API.

Kuota DICOM

Tabel berikut menjelaskan kuota Cloud Healthcare API yang terkait dengan penyimpanan DICOM dan operasi DICOM.

Nama metrik Nama tampilan Deskripsi
dicomweb_ops Jumlah operasi DICOMweb per menit per region Mencakup metode berikut:
  • Semua metode projects.locations.datasets.dicomStores.studies di v1beta1 dan v1
  • Semua metode projects.locations.datasets.dicomStores.studies.series di v1beta1 dan v1
  • Semua metode projects.locations.datasets.dicomStores.studies.series.instances di v1beta1 dan v1
  • Semua metode projects.locations.datasets.dicomStores.studies.series.instances.frames di v1beta1 dan v1
dicom_structured_storage_bytes Ingress penyimpanan DICOM terstruktur dalam byte per menit per region Byte terstruktur, dalam bentuk tag DICOM dan metadata terkait, dikirim ke Cloud Healthcare API saat memproses operasi dicomweb_ops.
dicom_store_ops Jumlah operasi penyimpanan DICOM per menit per region Operasi pada penyimpanan DICOM, bukan data DICOM. Mencakup metode berikut:
dicom_store_lro_ops Jumlah operasi penyimpanan DICOM yang berjalan lama per menit per region Operasi di penyimpanan DICOM, bukan data DICOM, yang menampilkan operasi yang berjalan lama. Mencakup metode berikut:
dicom_structured_storage_operations_bytes Ingress penyimpanan DICOM terstruktur untuk operasi yang berjalan lama dalam byte per menit per region Byte terstruktur, dalam bentuk tag DICOM dan metadata terkait, dikirim ke Cloud Healthcare API saat memproses operasi dicom_store_lro_ops.

Kuota FHIR

Tabel berikut menjelaskan kuota Cloud Healthcare API yang terkait dengan penyimpanan FHIR dan operasi FHIR.

Nama metrik Nama tampilan Deskripsi
fhir_read_ops Jumlah operasi baca FHIR per menit per region Diukur dalam satuan, dengan satu unit adalah satu permintaan baca pada setiap resource FHIR.

Mencakup metode berikut:

v1beta1: v1:
fhir_write_ops Jumlah operasi tulis FHIR per menit per region Diukur dalam satuan, dengan satu satuan adalah satu permintaan pembuatan, pembaruan, atau penghapusan pada setiap resource FHIR.

Mencakup metode berikut:

v1beta1: v1:
fhir_search_ops Jumlah operasi penelusuran FHIR per menit per region Diukur dalam satuan, dengan satu unit adalah permintaan penelusuran pada jenis resource FHIR tempat penelusuran tidak memerlukan resolusi referensi, kecuali jika _include digunakan. Misalnya, penelusuran Observation?subject:Patient.identifier=system|value menggunakan dua unit kuota fhir_search_ops karena memerlukan dua penelusuran, satu di resource Observation dan satu di resource Patient, menggunakan subject sebagai referensi.

Mencakup metode berikut:

v1beta1: v1:
fhir_storage_egress_bytes Traffic keluar penyimpanan FHIR dalam byte per menit per region Diukur dalam satuan, dengan satu satuan adalah satu byte yang dibaca Cloud Healthcare API dari penyimpanan saat memproses operasi fhir_read_ops, fhir_write_ops, dan fhir_search_ops.
fhir_storage_bytes Ingress penyimpanan FHIR dalam byte per menit per region Byte yang dikirim ke Cloud Healthcare API saat memproses operasi fhir_write_ops.
fhir_store_ops Jumlah operasi penyimpanan FHIR per menit per region Operasi pada penyimpanan FHIR, bukan data FHIR.

Mencakup metode berikut:
fhir_store_lro_ops Jumlah operasi penyimpanan FHIR yang berjalan lama per menit per region Operasi di penyimpanan FHIR, bukan data FHIR, yang menampilkan operasi yang berjalan lama.

Mencakup metode berikut:
fhir_storage_operations_bytes Ingress penyimpanan FHIR untuk operasi yang berjalan lama dalam byte per menit per region Byte yang dikirim ke Cloud Healthcare API saat memproses operasi fhir_store_lro_ops.

Satu permintaan dapat menggunakan beberapa unit kuota. Misalnya, permintaan penelusuran GET yang menggunakan Observation?subject:Patient.identifier=system|value sebagai parameter penelusuran menggunakan dua unit kuota fhir_search_ops. Dua operasi penelusuran dilakukan, satu di resource Pengamatan dan satu di resource Pasien, menggunakan subject sebagai referensi.

Jika permintaan penghapusan bersyarat menggunakan Observation?status=canceled sebagai kriteria penelusuran menelusuri dan menghapus enam resource Observation, unit kuota berikut akan digunakan:

  • Satu unit kuota fhir_search_ops, karena permintaan penelusuran GET hanya dilakukan pada satu jenis resource FHIR, yaitu resource Pengamatan. Permintaan ini menampilkan semua resource Observation yang cocok dengan kriteria penelusuran.
  • Enam unit kuota fhir_write_ops, karena ada total enam operasi DELETE pada resource Pengamatan yang dihapus.

Menjalankan penggunaan kuota paket

Untuk mengirim permintaan execute bundle, terlepas dari kuota yang digunakan permintaan, project Google Cloud Anda harus memiliki setidaknya satu unit yang tersedia untuk setiap kuota berikut:

  • fhir_read_ops
  • fhir_write_ops
  • fhir_search_ops

Jika kuota ini tidak tersedia, permintaan eksekusi paket akan gagal.

Misalnya, jika Anda mengirim permintaan fhir.executeBundle dengan paket transaksi yang berisi 100 operasi POST, yang masing-masing membuat resource FHIR, Cloud Healthcare API akan memverifikasi terlebih dahulu bahwa setidaknya satu unit kuota tersedia untuk fhir_read_ops, fhir_write_ops, dan fhir_search_ops. Jika verifikasi berhasil, Cloud Healthcare API akan mengeksekusi paket dan membuat resource FHIR, yang menggunakan total 100 unit kuota fhir_write_ops.

Pertimbangkan paket transaksi berikut, yang menggunakan referensi kondisional untuk membuat resource Pengamatan jika reference ada:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [
    {
      "request": {
        "method": "POST",
        "url": "Observation"
      },
      "resource": {
        "resourceType": "Observation",
        "subject": {
          "reference": "Patient?identifier=a1b2c3d4e5"
        }
      }
    }
  ]
}

Saat Anda menjalankan paket, Cloud Healthcare API akan memverifikasi terlebih dahulu bahwa setidaknya satu unit kuota tersedia untuk fhir_read_ops, fhir_write_ops, dan fhir_search_ops. Jika verifikasi berhasil, Cloud Healthcare API akan mengeksekusi paket. Unit kuota berikut digunakan:

  • Satu fhir_write_ops untuk membuat resource Pengamatan baru.
  • Satu fhir_search_ops, karena satu operasi penelusuran dilakukan pada referensi Patient?identifier=a1b2c3d4e5.

Praktik terbaik

Untuk praktik terbaik dalam mengelola kuota Cloud Healthcare API, lihat Praktik terbaik pengelolaan kuota.