Azure Quota Service API

Az Azure Quota Service REST API-t az Azure-erőforrás-szolgáltatók kvótáinak megtekintésére és kezelésére tervezték.

Fontos

Az Azure Quota Service API nyilvános előzetes verziójú

Az Azure Quota API új verziója nyilvános előzetes verzió. Ez az API a Microsoft.Quota erőforrás-szolgáltatót használja, támogatja az Azure-beli virtuális gépeket (cores/vCPU), az Azure Machine Learninget (dedikált/vCPU), a hálózatkezelést, az Azure HPC Cache, a Storage-t és az Azure Purview-szolgáltatásokat.

A kvóta az Azure-előfizetés egy erőforrásán beállított szolgáltatási korlát vagy kibocsátási egység. Minden Azure-szolgáltatás meghatározza a kvótáit, és meghatározza az alapértelmezett értékeket. A leggyakoribb Microsoft Azure-kvótákkal kapcsolatos további információkért lásd: Azure-előfizetések és -szolgáltatások korlátai, kvótái és megkötései.

Kvóta API-k használata

A Kvóta API-val a következőket teheti:

  1. Lekérheti egy erőforrás aktuális kvótáit és használati adatait.
  2. Lekérheti az összes erőforrás aktuális kvótáit és használati adatait.
  3. Erőforrások kvótáinak létrehozása vagy frissítése.
  4. Az erőforrás kvótakérelmeinek állapotának lekérése.
  5. Egy erőforrás egy évre vonatkozó összes kvótakérelmének listájának lekérése

Kvóta API PUT-hívása és hatóköre

A Kvóta API PUT kérése tartalmaz egy "hatókör" paramétert, amely testre szabható a kvótanövelést kérő erőforrás-szolgáltatók követelményeinek megfelelően, biztosítva, hogy az API-hívás egységes maradjon.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Erőforrás-szolgáltató Hatókör
Microsoft.Compute subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{azure location}
Microsoft.HDInsight subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{azure location}
Microsoft.MachineLearningService subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningService/locations/{azure location}
Microsoft.Network subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{azure location}
Microsoft.Purview subscriptions/{subscriptionId}/providers/Microsoft.Purview/locations/{azure location}

Megjegyzés: Példa a PUT-hívásra a számításhoz itt található.

Előfeltételek

Fontos

A Kvóta API használata előtt a következőket kell tennie:

A Microsoft Kvóta erőforrás-szolgáltató regisztrálása

A Microsoft Kvóta erőforrás-szolgáltató regisztrálásához használja az alábbi PowerShell-parancsot:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Az alábbi kimenethez hasonló eredményeket ad vissza:

ProviderNamespace : Microsoft.Quota
RegistrationState : Registering
ResourceTypes     : {usages, quotas, quotaRequests, operationsStatus...}
Locations         : {West Europe, East US, South Central US...}

A Microsoft.Quota erőforrás-szolgáltató regisztrálása után a RegistrationState értéke Registered. További információ az Azure-erőforrás-szolgáltatók kezeléséről: Azure-erőforrás-szolgáltatók.

Throttling

Ha túl sok API-kérést küld, minden előfizetési szintű és bérlőszintű API-hívás szabályozható. Ha az API-hívás szabályozva van, hibaüzenet jelenik meg, amely szerint a kiszolgáló elutasította az API-kérést. Az API-hívás egy kis idő leteltét követően újrapróbálkozott.

Az API-szabályozással, a szabályozási problémák elhárításával és a szabályozás elkerülésének módjával kapcsolatos részletekért lásd: Szabályozási hibák elhárítása az Azure-ban.

Kvótakérelmek operátori szerepköre

A kvótakérelmek operátora egy, a kvótaműveletekhez testre szabott Azure-beli beépített szerepkör. Engedélyeket ad a kvótakérelmek olvasásához és létrehozásához, a kvótakérelmek állapotának lekéréséhez és támogatási jegyek létrehozásához. Rendelje hozzá ezt a szerepkört kvótaműveleteket használó felhasználókhoz, csoportokhoz, szolgáltatásnevekhez, felügyelt identitásokhoz és alkalmazásokhoz. Referenciaként a Kvótakérési operátor szerepkör azonosítója: 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

A Kvótakérelem-kezelő szerepkör ki van terjesztve a kvótaerőforrás-szolgáltatói engedélyekre.

A kvóta API-k ajánlott eljárásai

  1. Kvóta-kihasználtság monitorozása: Használja az Azure Quota API-t a kvótahasználat hatékony nyomon követéséhez. Ez az API valós idejű információkat nyújt az aktuális használatról és az előfizetés, a virtuálisgép-család és a régió egy adott kombinációjára vonatkozó rendelkezésre álló kvótáról. A kvótanövelés mérlegelése előtt fontos, hogy rendszeresen ellenőrizze a kvóta kihasználtságát.

  2. Kvótanövelés kérése: Ha a kvóta kihasználtsága meghaladja az előre meghatározott célt, hozzon létre egy kvótanövelési kérést az Azure Kvóta API használatával, hogy a kihasználtság ismét összhangban legyen a céljaival. A folyamat egyszerű – egyszerűen küldjön be egy API-kérést, amely felvázolja a kívánt kvótanövelést. Ha például a Dv2 virtuális gép családi kvótájának célkihasználtsága Észak-Európában az "előfizetés1" alatt 80%, és az Azure-beli kvóta API-monitorozása 85%-os tényleges kihasználtságot jelez, 10%-ról 20%-ra növeli a kvótát.

Tipp

Javasoljuk, hogy kérje az erőforrás-hitelesítés 10%-ról 20%-ra történő kvótanövelését, mivel ez rezonálható puffert biztosít az erőforrás-használat váratlan kiugrásaihoz, biztosítva, hogy a növekedés után ne érje el azonnal az új kvótakorlátot. Ez a megközelítés minimálisra csökkenti a gyakori API-hívások szükségességét, hogy további kvótát kérhessenek, ezzel javítva a jóváhagyás esélyét.

  1. Kvótanövelési respnose: Kvótanövelési kérelem elküldésekor választ kap, amely jelzi, hogy a kérelmet jóváhagyták-e vagy elutasították-e. Elutasítás esetén az Azure Támogatási REST API-val vagy a Azure Portal új támogatási kérésével, beleértve a megtagadott kvótanövelési kérelem sajátosságait és a vizsgálat okát, egy támogatási kérés naplózásával kezdeményezhet további lépéseket.

Kvóta API-hibák elhárítása

Az alábbi táblázatokkal elháríthatja a Kvóta API használata során esetlegesen felmerülő hibákat.

Hibakód Hogyan oldhatja meg?
ContactSupport Nyisson meg egy új támogatási kérést a Azure Portal. A Problématípus kiválasztása területen válassza a Szolgáltatás- és előfizetési korlátok (kvóták) lehetőséget. Az Azure Támogatási REST API-val programozott módon is megnyithatja.
InternalServerError Belső kiszolgálóhiba. Próbálkozzon újra az API-hívással később.
MissingRegistration Regisztrálja a Microsoft.Quota erőforrás-szolgáltatót az egyes előfizetésekhez. Hibaelhárítási útmutatásért lásd: Az erőforrás-szolgáltató regisztrációjának hibáinak elhárítása.
QuotaNotAvailableForResource A kvóta jelenleg nem érhető el a kért erőforrás helyén. Nyisson meg egy új támogatási kérést a Azure Portal. A Problématípus kiválasztása területen válassza a Szolgáltatás- és előfizetési korlátok (kvóták) lehetőséget. Az Azure Támogatási REST API-val programozott módon is megnyithatja.
QuotaReductionNotSupported Az aktuális kvótakorlát magasabb, mint a kért kvóta, vagy az aktuális használat magasabb, mint a kért kvóta. A kvóták csökkentése nem támogatott. A kvóta nem csökkenthető.
Kérelem szabályozva Minden előfizetési szintű és bérlőszintű API-kérés szabályozva lehet a szolgáltatás általános teljesítményének elősegítése érdekében. A kérések száma túllépte az API-kérések maximális megengedett sebességét. Próbálkozzon újra később.
ResourceNotAvailableForOffer Az erőforrás jelenleg nem érhető el az ajánlattípus helyén. Az aktuális és kivezetett ajánlatok listáját a Microsoft Azure-ajánlat részletei oldalon találja. Az ajánlat típusának módosításához tekintse meg az Azure-előfizetés módosítása másik ajánlatra oldalt. Új támogatási kérést is megnyithat a Azure Portal. A Problématípus kiválasztása területen válassza a Szolgáltatás- és előfizetési korlátok (kvóták) lehetőséget. Az Azure Támogatási REST API-val programozott módon is megnyithatja.
ResourceNotAvailableForSubscription Az erőforrás jelenleg nem érhető el a kért előfizetés helyén. Nyisson meg egy új támogatási kérést a Azure Portal. A Problématípus kiválasztása területen válassza a Szolgáltatás- és előfizetési korlátok (kvóták) lehetőséget. Az Azure Támogatási REST API-val programozott módon is megnyithatja.
UnableToIncreaseQuota A kért előfizetések kvótái nem növelhetőek. Nyisson meg egy új támogatási kérést a Azure Portal. A Problématípus kiválasztása területen válassza a Szolgáltatás- és előfizetési korlátok (kvóták) lehetőséget.
MFA szükséges A kvótakérelmekhez többtényezős hitelesítés szükséges. Engedélyezze a többtényezős hitelesítést a bérlőhöz/fiókhoz az MFA engedélyezésével kapcsolatos utasításokat követve, majd próbálkozzon újra
RequestPartiallyFulfilled A kvótakérelem részben teljesült. Ha kérdése van, nyisson meg egy új támogatási kérést a Azure Portal. A Problématípus kiválasztása területen válassza a Szolgáltatás- és előfizetési korlátok (kvóták) lehetőséget.

További nyelvek és interfészek támogatása

A Quota REST API a következő nyelvspecifikus Microsoft Azure SDK-kban érhető el:

Kvóták kezelése Azure Portal és támogatási API használatával

Az Azure lehetővé teszi támogatási kérések, más néven támogatási jegyek létrehozását és kezelését. A következőket teheti:

  • Last updated on