本文說明如何解決大量執行個體 API 建立作業的問題。
作業錯誤
使用大量執行個體 API 建立 VM 時,如果要求成功啟動,create
要求會傳回 HTTP 200 OK
,狀態為 RUNNING
。如果要求未順利啟動,API 會傳回下列其中一個回應。
無效
如果您在建立 VM 時看到下列 API 回應欄位,表示 API 要求撰寫有誤,或使用了大量 API 不支援的屬性。
API 回應欄位:
HTTP 400
"reason": "invalid"
如要解決這個問題,請按照下列步驟操作:
- 查看回應中的
message
欄位,判斷要求中的哪個屬性導致錯誤。 - 更新導致錯誤的屬性。
- 重試要求。
- 如果要求再次失敗,請嘗試使用 API Explorer 驗證要求。詳情請參閱「驗證 API 要求」。
超過配額
如果您在建立 VM 時看到下列 API 回應欄位,表示您已達到資源的配額上限。如要進一步瞭解配額,請參閱「資源配額」。
API 回應欄位:
HTTP 403
"reason": "quotaExceeded"
- 查看 `message` 欄位,找出要求超出的資源配額。
- 執行下列其中一項操作:
- 減少 VM 數量後重試要求
- 申請提高配額
超過頻率限制
如果您在建立 VM 時看到下列 API 回應欄位,表示您已達到每秒 20 項要求的限制,或同時執行超過 10 項大量作業。
API 回應欄位:
HTTP 403
"reason": "rateLimitExceeded"
如要解決這個問題,請等待部分要求完成,然後再次嘗試要求。
容量不足
如果您在建立 VM 時看到下列 API 回應欄位,表示您嘗試建立 VM 的區域或可用區容量不足。
API 回應欄位:
HTTP 503
"reason": "insufficientCapacity"
- 在不同區域中建立 VM
- 如果使用區域端點,請在不同可用區中建立 VM
- 請改用其他 VM 設定
- 稍後再試一次要求
要求狀態錯誤
使用大量執行個體 API 建立 VM 時,如果要求成功啟動,create
要求會傳回狀態為 RUNNING
的 HTTP 200 OK
。不過,要求可能會在完成前失敗。你可以查看要求狀態,確認要求是否已順利完成。如果要求未順利完成,您會看到下列其中一個要求狀態。
超過配額
如果您輪詢作業時出現下列 API 回應欄位,表示您的要求因達到資源配額限制而失敗。如要進一步瞭解配額,請參閱「資源配額」。
API 回應欄位:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
如要解決這個問題,請按照下列步驟操作:
- 查看 `message` 欄位,找出要求超出的資源配額。
- 執行下列其中一項操作:
- 減少 VM 數量後重試要求
- 申請提高配額
這個資源已存在
輪詢作業時,如果出現下列 API 回應欄位,表示要求失敗,因為要求嘗試建立已存在的資源。
API 回應欄位:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
如要解決這個問題,請按照下列步驟操作:
- 查看「
message
」欄位,找出已存在的資源名稱。 - 請使用其他
namePattern
重試要求。詳情請參閱「在區域中建立多個 VM」。
容量不足
如果輪詢作業時出現下列 API 回應欄位,表示您嘗試在容量不足的區域或可用區 (如果使用可用區端點) 中建立 VM,因此要求失敗。
API 回應欄位:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
如要解決這個問題,請按照下列其中一種做法進行:
- 在不同區域中建立 VM
- 如果使用區域端點,請在不同可用區中建立 VM
- 請改用其他 VM 設定
- 稍後再試一次要求
後續步驟
- 如要進一步瞭解如何使用大量執行個體 API,請參閱「使用大量執行個體 API」。