Kuota dan batas

Cloud Healthcare API menerapkan batas 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 diberlakukan oleh project atas dasar per region atau multi-region. Kehabisan kuota di satu region tidak akan memengaruhi penggunaan Anda atas Cloud Healthcare API 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 Quotas di Konsol Google Cloud.

Untuk menampilkan hanya 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 dari waktu ke waktu, kuota Anda juga dapat meningkat. Jika Anda mengharapkan adanya peningkatan penggunaan yang signifikan di masa mendatang, Anda dapat secara proaktif meminta penyesuaian kuota dari halaman Quotas di Google Cloud Console. Meminta peningkatan kuota tidak dikenakan biaya. Biaya Anda hanya akan meningkat jika Anda menggunakan lebih banyak resource.

Batas resource

Cloud Healthcare API membatasi ukuran konten permintaan, seperti ukuran gambar sinar-X 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.

Modalitas Batas ukuran permintaan
DICOM
  • Transaksi toko: Tidak terbatas. Semua metode lainnya 10 MB.
  • Transaksi toko 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/seri dan 50.000 untuk instance.
  • De-identifikasi: De-identifikasi tidak dapat memproses file DICOM yang berukuran lebih besar dari 1 GB jika penyamaran piksel terlibat.
  • File DICOM yang ditransfer memiliki batas 2 GB per tag. Batasnya 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 20 GB.
FHIR executeBundle: 50 MB, semua metode lainnya 10 MB
HL7v2 10 MB

Error akan terjadi jika Anda mencoba memproses konten yang lebih besar dari batas resource terkait.

Menggunakan operasi impor untuk konten yang melebihi batas resource

Operasi impor mengizinkan Anda untuk 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 masing-masing objek. Operasi impor tunduk pada kuota penyimpanan yang menentukan berapa lama operasi impor berlangsung. 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 Toko yang tersedia, Anda dapat mengupload instance ke bucket Cloud Storage lalu mengimpornya ke penyimpanan DICOM.

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

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

Guna mengetahui langkah-langkah mendetail untuk mengimpor pesan HL7v2 menggunakan operasi impor, lihat Mengimpor pesan HL7v2.

Meminta perubahan kuota

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

  1. Buka halaman Kuota.

    Buka Quotas

  2. Di halaman Quotas, pilih kuota yang ingin Anda ubah. Jika Anda hanya ingin menampilkan kuota Cloud Healthcare API, pilih Service 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 Next.

  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 Anda.

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

Batas kuota

Bagian berikut menjelaskan kuota yang terkait dengan penyimpanan dan operasi 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 di 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_ops Jumlah operasi FHIR per menit per region Diukur dalam satuan, dengan setiap unit adalah satu permintaan ke metode projects.locations.datasets.fhirStores.fhir apa pun di v1beta1 dan v1.
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 unit, dengan satu unit adalah satu permintaan buat, perbarui, atau hapus 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 dengan penelusuran yang tidak memerlukan penyelesaian referensi, kecuali saat _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 satunya di resource Pasien, 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 unit 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 Traffic masuk penyimpanan FHIR dalam byte per menit per region Byte dikirim ke Cloud Healthcare API saat memproses operasi fhir_ops.
fhir_store_ops Jumlah operasi penyimpanan FHIR per menit per region Operasi di penyimpanan FHIR, bukan data FHIR.

Mencakup metode berikut:
fhir_store_lro_ops Jumlah operasi yang berjalan lama penyimpanan FHIR 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 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 akan menggunakan dua unit kuota fhir_search_ops. Dua operasi penelusuran dilakukan, satu di resource Observation dan satunya di resource Pasien, menggunakan subject sebagai referensi.

Jika permintaan penghapusan bersyarat yang 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 Observation. Permintaan tersebut menampilkan semua resource Observation yang cocok dengan kriteria penelusuran.
  • Enam unit kuota fhir_write_ops, karena ada total enam operasi DELETE pada resource Observation yang dihapus.

Menjalankan pemakaian kuota paket

Untuk mengirim permintaan eksekusi paket, terlepas dari kuota yang digunakan permintaan, project Google Cloud Anda harus memiliki minimal satu unit yang tersedia untuk setiap kuota berikut:

  • fhir_read_ops
  • fhir_write_ops
  • fhir_search_ops

Jika kuota ini tidak tersedia, permintaan paket yang dijalankan 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 terlebih dahulu memverifikasi 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 memakai total 100 unit kuota fhir_write_ops.

Pertimbangkan paket transaksi berikut, yang menggunakan referensi bersyarat 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 mengeksekusi paket, Cloud Healthcare API terlebih dahulu memverifikasi bahwa setidaknya satu unit kuota tersedia untuk fhir_read_ops, fhir_write_ops, dan fhir_search_ops. Jika verifikasi berhasil, Cloud Healthcare API akan menjalankan paket. Unit kuota berikut digunakan:

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