Azure 配額 API

配額 API 是 REST API，可用來檢視和管理 Azure 服務的配額。

重要

配額 API 正式運作

Azure 配額 API 現已正式推出。 它目前支援 (核心/vCPU) 和 Azure Machine Learning 服務 (專用/vCPU) 的 Azure 虛擬機。

注意： 新版本的配額 REST API 處於公開預覽狀態，位於 Azure 配額服務 Rest API。 其使用 Microsoft.Quota 資源提供者，並支援 Azure 虛擬機 (核心/vCPU) 、Azure Machine Learning、Azure 網路、Azure HPC Cache 和 Azure Purview 服務。

配額是 Azure 訂用帳戶中資源、動作和專案的最大值。 每個 Azure 服務都會定義其配額，並決定其預設值。 根據您的業務需求，您可能需要增加配額值。

如需最常見 Microsoft Azure 限制的詳細資訊，請參閱 Azure 訂用帳戶 和服務限制、配額和條件約束。

使用配額 API

使用配額 API，您可以：

• 取得資源的目前配額和使用量。
• 取得所有資源的目前配額和使用量清單。
• 建立或更新資源的配額。
• 取得資源的配額要求狀態。
• 取得資源的所有配額要求清單一年。

REST 作業

Azure 配額 API 可讓您輕鬆地使用這些 REST 作業來查閱配額和要求增加：

• 如需配額管理 REST 作業詳細數據，請參閱 配額 API 參考。
• 如需配額要求狀態 REST 作業詳細數據，請參閱 配額要求狀態 API 參考。

必要條件

重要

使用配額 API 之前，您必須先：

• 使用 PowerShell 為您的所有訂用帳戶註冊 Microsoft Capacity (Microsoft.Capacity) 資源提供者。
• 將配額要求操作員角色指派 給將執行配額作業的所有用戶帳戶和應用程式。

註冊 Microsoft Capacity 資源提供者

若要註冊 Microsoft 容量資源提供者，請使用下列 PowerShell 命令：

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

它會傳回類似此輸出的結果：

ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes     : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations         : {West Europe, East US, South Central US...}

註冊 Microsoft.Capacity 資源提供者之後， RegistrationState 會將 設定為 Registered。 如需管理 Azure 資源提供者的詳細資訊，請參閱 Azure 資源提供者。

配額要求操作員角色

配額要求操作員角色是針對配額作業自定義的 Azure 內建角色。 它會授與讀取和建立配額要求的許可權、取得配額要求狀態，以及建立支援票證。 將此角色指派給執行配額作業的使用者、群組、服務主體、受控識別和應用程式。 如需參考，配額要求操作員角色標識符為 0e5f05e5-9ab9-446b-b98d-1e2157c94125。

vCPU 配額

您可以使用配額 API 來管理這兩種 vCPU 配額類型的配額：

• 隨用隨付 VM 和保留 VM 實例的標準 vCPU 配額。
• 現成 VM 的現成vCPU 配額。

若要深入瞭解 Azure 限制和配額，請參閱 Azure 訂用帳戶和服務限制、配額和條件約束。

Azure Machine Learning 配額

您可以使用配額 API 來管理 Azure Machine Learning 工作區和計算的配額。 閱讀 使用 Azure Machine Learning 管理及增加資源的配額 一文，以瞭解：

• 與 Azure Machine Learning 相關的 Azure 資源的預設限制。
• 建立工作區層級配額。
• 檢視您的配額和限制。
• 要求增加配額。
• 私人端點和 DNS 配額。

區域

大部分的配額都是任何一個區域中工作負載的特定配額。 針對您要部署服務的每個區域要求個別配額。 若要列出服務存在的所有 Azure 區域，請使用 依服務區域列出 作業。

節流

如果您傳送太多 API 要求，則可以節流每個訂用帳戶層級和租用戶層級 API 呼叫。 如果您的 API 呼叫已節流，您會收到錯誤訊息，指出伺服器拒絕 API 要求。 經過一段時間之後，您可以重試 API 呼叫。

如需 API 節流、如何針對節流問題進行疑難解答，以及如何避免節流的詳細資訊，請參閱 針對 Azure 中的節流錯誤進行疑難解答。

針對配額 API 錯誤進行疑難解答

使用下表來針對您在使用配額 API 時可能取得的錯誤進行疑難解答。

錯誤碼	如何加以解決
ContactSupport	在 Azure 入口網站 中開啟新的支援要求。 在 [選取問題類型] 下，選擇 [服務與訂用帳戶限制] (配額) 。 您也可以使用 Azure 支援 REST API 以程式設計方式開啟它。
InternalServerError	內部伺服器錯誤。 稍後再重試 API 呼叫。
MissingRegistration	註冊每個訂用帳戶的 Microsoft.Capacity 資源提供者。 如需疑難解答指引，請參閱 解決資源提供者註冊的錯誤。
QuotaNotAvailableForResource	目前在要求資源的位置無法使用配額。 在 Azure 入口網站 中開啟新的支援要求。 在 [選取問題類型] 下，選擇 [服務與訂用帳戶限制] (配額) 。 您也可以使用 Azure 支援 REST API 以程式設計方式開啟它。
QuotaReductionNotSupported	目前的配額限制高於要求的配額，或目前的使用量高於要求的配額。 不支援減少配額。 無法減少配額。
RequestThrottled	每個訂用帳戶層級和租用戶層級 API 要求可能會受到節流，以協助服務的整體效能。 要求數目超過允許的 API 要求速率上限。 請稍後再試一次。
ResourceNotAvailableForOffer	供應項目類型的位置目前無法使用資源。 如需目前和已淘汰的供應專案清單，請參閱 Microsoft Azure 供應專案詳細數據 頁面。 若要變更供應項目類型，請參閱 將 Azure 訂用帳戶變更為不同的供應項目 頁面。 您也可以在 Azure 入口網站 中開啟新的支援要求。 在 [選取問題類型] 下，選擇 [服務與訂用帳戶限制] (配額) 。 您也可以使用 Azure 支援 REST API 以程式設計方式開啟它。
ResourceNotAvailableForSubscription	資源目前無法在要求之訂用帳戶的位置中使用。 在 Azure 入口網站 中開啟新的支援要求。 在 [選取問題類型] 下，選擇 [服務與訂用帳戶限制] (配額) 。 您也可以使用 Azure 支援 REST API 以程式設計方式開啟它。
UnableToIncreaseQuota	無法增加所要求訂用帳戶的配額。 在 Azure 入口網站 中開啟新的支援要求。 在 [選取問題類型] 下，選擇 [服務與訂用帳戶限制] (配額) 。

其他語言和介面中的支援

配額 REST API 適用於下列語言特定的 Microsoft Azure SDK：

• Microsoft Azure SDK for .NET：NuGet 套件
• 適用於 Python 的 Microsoft Azure SDK： Py 套件
• Microsoft Azure SDK for JavaScript (NodeJS & Browser) ： js 套件
• Microsoft Azure SDK for Go： Go 套件

使用 Azure 入口網站和支援 API 來管理配額

Azure 可讓您建立及管理支援要求，也稱為支援票證。 您可以：

• 使用 Azure 入口網站 建立支援票證。
• 使用 Azure 支援 票證 REST API 以程式設計方式建立支援票證。