配額與限制

由於各方面因素的考量,Cloud Healthcare API 有資源用量的限制。舉例來說,限制配額可以預防用量突然暴增的情況,進而保障 Google Cloud 使用者社群的權益。Google Cloud 也提供免費試用配額,讓使用者能體驗 Google Cloud (包括 Cloud Healthcare API) 的部分功能。

每個地區有各自的 Cloud Healthcare API 配額。在某個地區耗盡配額,不會影響您在其他地區的 Cloud Healthcare API 用量上限。

查看配額與用量

配額指的是儲存空間 (也稱為輸入限制) 和作業方面的限制。

如要查看專案的可用資源配額,請前往 Cloud Console 的「配額」頁面。

如果您只想查看 Cloud Healthcare API 配額,請依序按一下 [所有服務] 和 [無],然後選取 [Cloud Healthcare API]

並非所有專案的配額都相同。在您使用 Cloud Healthcare API 一段時間後,系統可能會根據您的用量增長情況自動提升您的配額。如果您預期用量將大幅攀升,可以透過 Google Cloud Console 的「配額」頁面主動要求增加配額。這類要求不會產生任何費用。除非您使用了更多資源,否則費用不會增加。

資源限制

Cloud Healthcare API 會限制要求的內容大小,例如 DICOM 要求中的 X 光影像的大小。您無法要求調整資源限制,但在某些情況下,您可以使用匯入作業來匯入超過資源限制的內容。

目前資源限制如下 (未來可能會有所異動):

模型 要求大小限制
DICOM
  • 儲存交易:無限制,其他方法均為 10 MB
  • 儲存交易/擷取交易:如果作業時間超過一個小時,就會發生逾時
  • 搜尋交易方法的偏移值最多可達 1,000,000
  • 去識別化:去識別化作業無法處理超過 1 GB 的 DICOM 檔案
  • 以擷取的 DICOM 檔案來說,上限為每個標記 2 GB。這項限制包含以原生格式編碼的 PixelData。
  • 在 DICOM 資料的轉碼作業中,檔案大小上限為 1 GB,影格大小上限則為 150 MB
  • dicomStores.import:檔案大小上限為 20 GB
FHIR executeBundle:50 MB,所有其他方法則限制為 10 MB
HL7v2 10 MB

如果您嘗試處理超過相關資源限制的內容,則會收到錯誤訊息。

使用匯入作業來匯入超過資源限制的內容

匯入作業可用於處理超過相關資源限制的內容,匯入作業的內容大小限制為 Google Cloud 針對個別物件所設的最大儲存大小 5 TB。匯入作業受儲存空間配額限制,這會決定匯入作業的完成所需時間。舉例來說,如果您想在 DICOM 儲存庫中儲存大量的 DICOM 執行個體,而不想受到要求大小的限制,建議您使用匯入作業。若不使用儲存交易方法上傳執行個體,您可以改為將執行個體上傳至 Cloud Storage 值區,再匯入至 DICOM 儲存庫。

如需使用匯入作業匯入 DICOM 資料的詳細步驟,請參閱匯入及匯出 DICOM 資料相關說明。

如需使用匯入作業匯入 FHIR 資源的詳細步驟,請參閱匯入及匯出 FHIR 資源相關說明。

要求調整配額

您必須具備 serviceusage.quotas.update 權限,才能要求調整配額。根據預設,擁有者、編輯者和配額管理員這些預先定義的角色都具備這項權限。

  1. 前往「配額」頁面。

    前往「配額」頁面

  2. 「配額」頁面中,選擇您要變更的配額項目。如果您只想查看 Cloud Healthcare API 配額,請依序按一下 [服務] 清單和 [無],然後選取 [Cloud Healthcare API]
  3. 根據您要編輯的配額,勾選對應的方塊。
  4. 按一下頁面頂端的 [編輯配額] 按鈕。
  5. 填寫表單後,按一下 [下一步]
  6. 輸入要求的上限,然後按一下 [下一步]
  7. 點選 [提交要求]

根據預設,系統會自動拒絕減少配額的要求。如想減少配額,請回覆支援電子郵件,並附上提出該需求的原因。我們的支援代表將會回覆您的要求。

您會在提交要求後的 24 至 48 小時內收到 Cloud Healthcare API 團隊的回覆。

請至少提前幾天規劃所需的額外資源並提出申請,確保您的申請可以及時獲得核准。