配額與限制

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

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

查看配額與用量

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

如要查看專案的可用資源配額，請前往 Google Cloud 主控台的「配額」頁面。

如要只顯示 Cloud Healthcare API 配額，請在「篩選表格」下拉式選單中依序選取「服務」和「Cloud Healthcare API」。

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

資源限制

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

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

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

FHIR executeBundle 大小限制

您可以使用 fhir.executeBundle 方法，在單一 API 要求中執行多項 FHIR 作業。作業數量取決於批次或交易組合中的項目數量。相較於針對每項作業分別呼叫 API，這種做法更有效率。

fhir.executeBundle 要求的處理時間會隨著套件中項目數量增加。資源爭用 (例如，在許多交易組合中同時更新相同資源) 等因素也可能會影響效能。如要瞭解何時可能發生資源競爭，以及如何避免資源競爭導致錯誤，請參閱「資料處理量最佳做法」。大型套件 (尤其是超過 1,000 個項目的套件) 可能會逾時，並且無法完成。

為確保順利及時處理，請在傳送 fhir.executeBundle 要求時考量下列限制：

• 交易套件：系統會立即拒絕超過 4,500 個項目的套件，以免發生逾時。交易組合需要所有作業都成功。
• 批次套件：沒有特定的項目限制，但較大的套件會增加逾時的風險。逾時可能導致部分成功，只有部分項目會處理。

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

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

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

如需使用匯入作業匯入 FHIR 資源的詳細步驟，請參閱匯入及匯出 FHIR 資源。

如需使用匯入作業匯入 HL7v2 訊息的詳細步驟，請參閱「從 Cloud Storage 匯入 HL7v2 訊息」。

要求調整配額

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

1. 前往「配額」頁面。

   前往配額頁面

2. 在「配額」頁面中，選擇要變更的配額項目。如果只想查看 Cloud Healthcare API 的配額，請在「篩選表格」下拉式選單中依序選取 [服務] 和 [Cloud Healthcare API]。

3. 依據您要編輯的配額項目勾選相應的方塊。

4. 按一下頁面頂端的 [編輯配額] 按鈕。

5. 填寫表單後，按一下 [下一步]。

6. 輸入要求的上限，然後按一下 [下一步]。

7. 點選 [提交要求]。

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

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

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

位置資訊配額要求

您可以要求提高 Cloud Healthcare API 在特定區域或多區域位置的配額。

如要申請單一區域的配額提高：請在配額提高要求中指定區域。

如要在多地區位置申請提高配額，請按照下列步驟操作：

• 如要提高 us 多區域的配額，請在申請中指出配額適用於「美國元區域」。
• 如要提高 eu 多區域的配額，請在要求中指出配額適用於「歐盟中繼區域」。

配額限制

以下各節說明與 Cloud Healthcare API 資料儲存庫和作業相關的配額。

DICOM 配額

下表說明與 DICOM 儲存空間和 DICOM 作業相關聯的 Cloud Healthcare API 配額。

FHIR 配額

下表說明與 FHIR 儲存空間和 FHIR 作業相關聯的 Cloud Healthcare API 配額。

多項作業搜尋

單一要求可能會耗用多個配額單位。舉例來說，如果 GET 搜尋要求使用 Observation?subject:Patient.identifier=system|value 做為搜尋參數，就會消耗兩個 fhir_search_ops 配額單位。系統會執行兩項搜尋作業，一個是針對觀察資源，另一個是針對病患資源，並使用 subject 做為參照。

如果使用 Observation?status=canceled 做為搜尋條件的有條件刪除要求搜尋並刪除六個 Observation 資源，系統會消耗下列配額單位：

• 一個 fhir_search_ops 配額單位，因為 GET 搜尋要求只會針對一種 FHIR 資源 (Observation 資源) 執行。這項要求會傳回符合搜尋條件的所有 Observation 資源。
• 六個 fhir_write_ops 配額單位，因為在已刪除的 Observation 資源上，共有六個 DELETE 作業。

執行軟體包配額使用量

如要傳送執行套件要求，無論要求消耗的配額為何，Google Cloud 專案必須為下列每個配額提供至少一個單位：

• fhir_read_ops
• fhir_write_ops
• fhir_search_ops

如果這些配額無法使用，執行套件要求就會失敗。

舉例來說，如果您傳送 fhir.executeBundle 要求，其中包含包含 100 個 POST 作業的交易組合，而每個作業都會建立 FHIR 資源，Cloud Healthcare API 會先驗證 fhir_read_ops、fhir_write_ops 和 fhir_search_ops 至少有一個配額單位。如果驗證成功，Cloud Healthcare API 就會執行套件並建立 FHIR 資源，這會消耗總共 100 個 fhir_write_ops 配額單位。

請參考下列交易套件，該套件會在 reference 存在時，使用條件式參照建立 Observation 資源：

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

執行套件時，Cloud Healthcare API 會先驗證 fhir_read_ops、fhir_write_ops 和 fhir_search_ops 至少有一個配額單位。如果驗證成功，Cloud Healthcare API 就會執行套件。系統會耗用下列配額單位：

• 一個 fhir_write_ops，用於建立新的 Observation 資源。
• 一個 fhir_search_ops，因為會在 Patient?identifier=a1b2c3d4e5 參照項目上執行單一搜尋作業。

最佳做法

如要瞭解管理 Cloud Healthcare API 配額的最佳做法，請參閱「配額管理最佳做法」。