限制與配額

請參閱本指南，瞭解使用 Data Manager API 時的限制和配額。

專案限制

您必須擁有 Google Cloud 專案，才能使用 Data Manager API。Google Cloud 雲端專案會提供 OAuth 用戶端和憑證，供您驗證 API 要求。

Data Manager API 會對每個 Google Cloud 專案強制執行頻率限制，並依服務和作業類型 (讀取與變動) 分開計算：

服務 作業 每日要求數 每分鐘要求數
IngestionService 變更 (寫入) 100,000 300
IngestionService 讀取 100,000 300
所有其他服務加總 變更 (寫入) 50,000 次 300
所有其他服務加總 讀取 50,000 次 300

如果要求超出限制，系統會拒絕要求，並傳回 RESOURCE_EXHAUSTED 錯誤和 HTTP 狀態 429 Too Many Requests。

您可以主動減少要求數量，並從用戶端節流 QPS，藉此控管應用程式並減輕頻率限制。您也可以在 Google Cloud 控制台中設定配額警告和監控，在應用程式達到限制前收到通知。

配額名稱

每個限制都對應至 Google Cloud 中的配額限制名稱和指標。如果要求超出限制，Data Manager API 會在 metadata.quota_limit 下的 ErrorInfo 標準詳細資料酬載中，傳回配額限制名稱：

配額限制名稱 服務 作業 視窗 限制
IngestionMutateRequestsPerDayPerProject IngestionService 更改 天 100,000
IngestionMutateRequestsPerMinutePerProject IngestionService 更改 分鐘 300
IngestionReadRequestsPerDayPerProject IngestionService 讀取 天 100,000
IngestionReadRequestsPerMinutePerProject IngestionService 讀取 分鐘 300
ManagementMutateRequestsPerDayPerProject 所有其他服務 更改 天 50,000 次
ManagementMutateRequestsPerMinutePerProject 所有其他服務 更改 分鐘 300
ManagementReadRequestsPerDayPerProject 所有其他服務 讀取 天 50,000 次
ManagementReadRequestsPerMinutePerProject 所有其他服務 讀取 分鐘 300

檢查 ErrorInfo 酬載中的 metadata.quota_limit，區分每日限制和每分鐘限制錯誤，並判斷是否要暫時暫停並重試 (使用退避)，或暫停直到每日配額重設為止。詳情請參閱「配額和頻率限制錯誤」。

要求限制

特定要求的限制如下：