Quota Request Status - List

Riferimento

Servizio:: Quota

Versione API:: 2025-03-01

Per l'ambito specificato, ottenere le richieste di quota correnti per un periodo di un anno che termina al momento dell'esecuzione. Usare il filtro oData per selezionare le richieste di quota.

GET https://management.azure.com/{scope}/providers/Microsoft.Quota/quotaRequests?api-version=2025-03-01

Con parametri facoltativi:

GET https://management.azure.com/{scope}/providers/Microsoft.Quota/quotaRequests?api-version=2025-03-01&$filter={$filter}&$top={$top}&$skiptoken={$skiptoken}

Parametri dell'URI

Nome In Necessario Tipo Descrizione

scope

path

True

string

URI della risorsa di Azure di destinazione. Ad esempio: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qms-test/providers/Microsoft.Batch/batchAccounts/testAccount/. Si tratta dell'URI della risorsa di Azure di destinazione per l'operazione List GET. Se un {resourceName} viene aggiunto dopo /quotas, è l'URI della risorsa di Azure di destinazione nell'operazione GET per la risorsa specifica.

api-version

query

True

string

minLength: 1

Versione dell'API da usare per questa operazione.

$filter

query

string

Campo	Operatori supportati

|requestSubmitTime | ge, le, eq, gt, lt |provisioningState eq {QuotaRequestState} |resourceName eq {resourceName}

$skiptoken

query

string

Il parametro Skiptoken viene utilizzato solo se un'operazione precedente ha restituito un risultato parziale. Se una risposta precedente contiene un elemento nextLink, il relativo valore include un parametro skiptoken che specifica un punto di partenza da utilizzare per le chiamate successive.

$top

query

integer (int32)

minimum: 1

Numero di record da restituire.

Risposte

Nome	Tipo	Descrizione
200 OK	QuotaRequestDetailsList	OK. Invio dello stato e dei dettagli della richiesta di quota.
Other Status Codes	ExceptionResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Autorizzazione OAuth 2.0 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	Rappresentare l'account utente.

Esempio

QuotaRequestHistory

Esempio di richiesta

GET https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests?api-version=2025-03-01


/**
 * Samples for QuotaRequestStatus List.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/quota/resource-manager/Microsoft.Quota/stable/2025-03-01/examples/getQuotaRequestsHistory.json
     */
    /**
     * Sample code: QuotaRequestHistory.
     * 
     * @param manager Entry point to QuotaManager.
     */
    public static void quotaRequestHistory(com.azure.resourcemanager.quota.QuotaManager manager) {
        manager.quotaRequestStatus().list(
            "subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus", null,
            null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.quota import QuotaMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-quota
# USAGE
    python get_quota_requests_history.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = QuotaMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.quota_request_status.list(
        scope="subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/quota/resource-manager/Microsoft.Quota/stable/2025-03-01/examples/getQuotaRequestsHistory.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armquota_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/quota/armquota"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/8691e5081766c7ad602a9e55de841d07bed5196a/specification/quota/resource-manager/Microsoft.Quota/stable/2025-03-01/examples/getQuotaRequestsHistory.json
func ExampleRequestStatusClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armquota.NewClientFactory(cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewRequestStatusClient().NewListPager("subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus", &armquota.RequestStatusClientListOptions{Filter: nil,
		Top:       nil,
		Skiptoken: nil,
	})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.RequestDetailsList = armquota.RequestDetailsList{
		// 	Value: []*armquota.RequestDetails{
		// 		{
		// 			Name: to.Ptr("2B5C8515-37D8-4B6A-879B-CD641A2CF605"),
		// 			Type: to.Ptr("Microsoft.Quota/quotaRequests"),
		// 			ID: to.Ptr("/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605"),
		// 			Properties: &armquota.RequestProperties{
		// 				Message: to.Ptr("Request completed"),
		// 				ProvisioningState: to.Ptr(armquota.QuotaRequestStateSucceeded),
		// 				RequestSubmitTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-08-19T19:23:17.904Z"); return t}()),
		// 				Value: []*armquota.SubRequest{
		// 					{
		// 						Name: &armquota.ResourceName{
		// 							LocalizedValue: to.Ptr("Standard NC Promo Family vCPUs"),
		// 							Value: to.Ptr("standardNCPromoFamily"),
		// 						},
		// 						Limit: &armquota.LimitObject{
		// 							LimitObjectType: to.Ptr(armquota.LimitTypeLimitValue),
		// 							Value: to.Ptr[int32](50),
		// 						},
		// 						Message: to.Ptr("Request completed"),
		// 						ProvisioningState: to.Ptr(armquota.QuotaRequestStateSucceeded),
		// 						SubRequestID: to.Ptr("AD07450A-DE86-4FD3-859B-107BEF218C4C"),
		// 				}},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("7E73A85C-83BB-4DE4-903F-076F1A2B91D6"),
		// 			Type: to.Ptr("Microsoft.Quota/quotaRequests"),
		// 			ID: to.Ptr("/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/7E73A85C-83BB-4DE4-903F-076F1A2B91D6"),
		// 			Properties: &armquota.RequestProperties{
		// 				Message: to.Ptr("Request completed"),
		// 				ProvisioningState: to.Ptr(armquota.QuotaRequestStateSucceeded),
		// 				RequestSubmitTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-08-18T19:23:17.904Z"); return t}()),
		// 				Value: []*armquota.SubRequest{
		// 					{
		// 						Name: &armquota.ResourceName{
		// 							LocalizedValue: to.Ptr("Standard NV Promo Family vCPUs"),
		// 							Value: to.Ptr("standardNVPromoFamily"),
		// 						},
		// 						Limit: &armquota.LimitObject{
		// 							LimitObjectType: to.Ptr(armquota.LimitTypeLimitValue),
		// 							Value: to.Ptr[int32](150),
		// 						},
		// 						Message: to.Ptr("Request completed"),
		// 						ProvisioningState: to.Ptr(armquota.QuotaRequestStateSucceeded),
		// 						SubRequestID: to.Ptr("AD07450A-DE86-4FD3-859B-107BEF218C4C"),
		// 				}},
		// 			},
		// 		},
		// 		{
		// 			Name: to.Ptr("5E460077-AB53-4802-8997-A6940E0B7649"),
		// 			Type: to.Ptr("Microsoft.Quota/quotaRequests"),
		// 			ID: to.Ptr("/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/5E460077-AB53-4802-8997-A6940E0B7649"),
		// 			Properties: &armquota.RequestProperties{
		// 				Error: &armquota.ServiceErrorDetail{
		// 					Code: to.Ptr("ResourceNotAvailableForOffer"),
		// 					Message: to.Ptr("The resource is currently unavailable in the location for the offer type."),
		// 				},
		// 				Message: to.Ptr("The resource is currently unavailable in the location for the offer type."),
		// 				ProvisioningState: to.Ptr(armquota.QuotaRequestStateSucceeded),
		// 				RequestSubmitTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-08-17T19:23:17.904Z"); return t}()),
		// 				Value: []*armquota.SubRequest{
		// 					{
		// 						Name: &armquota.ResourceName{
		// 							LocalizedValue: to.Ptr("Standard HBS Family vCPUs"),
		// 							Value: to.Ptr("standardHBSFamily"),
		// 						},
		// 						Limit: &armquota.LimitObject{
		// 							LimitObjectType: to.Ptr(armquota.LimitTypeLimitValue),
		// 							Value: to.Ptr[int32](52),
		// 						},
		// 						Message: to.Ptr("Request failed, please contact support."),
		// 						ProvisioningState: to.Ptr(armquota.QuotaRequestStateSucceeded),
		// 						SubRequestID: to.Ptr("AD07450A-DE86-4FD3-859B-107BEF218C4C"),
		// 				}},
		// 			},
		// 	}},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { AzureQuotaExtensionAPI } = require("@azure/arm-quota");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to For the specified scope, get the current quota requests for a one year period ending at the time is made. Use the **oData** filter to select quota requests.
 *
 * @summary For the specified scope, get the current quota requests for a one year period ending at the time is made. Use the **oData** filter to select quota requests.
 * x-ms-original-file: specification/quota/resource-manager/Microsoft.Quota/stable/2025-03-01/examples/getQuotaRequestsHistory.json
 */
async function quotaRequestHistory() {
  const scope =
    "subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus";
  const credential = new DefaultAzureCredential();
  const client = new AzureQuotaExtensionAPI(credential);
  const resArray = new Array();
  for await (let item of client.quotaRequestStatus.list(scope)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Quota;

// Generated from example definition: specification/quota/resource-manager/Microsoft.Quota/stable/2025-03-01/examples/getQuotaRequestsHistory.json
// this example is just showing the usage of "QuotaRequestStatus_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// get the collection of this QuotaRequestDetailResource
string scope = "subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus";
QuotaRequestDetailCollection collection = client.GetQuotaRequestDetails(new ResourceIdentifier(scope));

// invoke the operation and iterate over the result
await foreach (QuotaRequestDetailResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    QuotaRequestDetailData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/microsoft.Quota/resourceProviders/Microsoft.Compute/locations/eastus/quotaRequests?api-version=2021-03-15&amp;$top=3",
  "value": [
    {
      "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605",
      "type": "Microsoft.Quota/quotaRequests",
      "name": "2B5C8515-37D8-4B6A-879B-CD641A2CF605",
      "properties": {
        "requestSubmitTime": "2019-08-19T19:23:17.904Z",
        "message": "Request completed",
        "provisioningState": "Success",
        "value": [
          {
            "limit": {
              "limitObjectType": "LimitValue",
              "value": 50
            },
            "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C",
            "name": {
              "value": "standardNCPromoFamily",
              "localizedValue": "Standard NC Promo Family vCPUs"
            },
            "message": "Request completed",
            "provisioningState": "Success"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/7E73A85C-83BB-4DE4-903F-076F1A2B91D6",
      "type": "Microsoft.Quota/quotaRequests",
      "name": "7E73A85C-83BB-4DE4-903F-076F1A2B91D6",
      "properties": {
        "requestSubmitTime": "2019-08-18T19:23:17.904Z",
        "message": "Request completed",
        "provisioningState": "Succeeded",
        "value": [
          {
            "limit": {
              "limitObjectType": "LimitValue",
              "value": 150
            },
            "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C",
            "name": {
              "value": "standardNVPromoFamily",
              "localizedValue": "Standard NV Promo Family vCPUs"
            },
            "message": "Request completed",
            "provisioningState": "Succeeded"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/5E460077-AB53-4802-8997-A6940E0B7649",
      "type": "Microsoft.Quota/quotaRequests",
      "name": "5E460077-AB53-4802-8997-A6940E0B7649",
      "properties": {
        "requestSubmitTime": "2019-08-17T19:23:17.904Z",
        "message": "The resource is currently unavailable in the location for the offer type.",
        "provisioningState": "Failed",
        "error": {
          "code": "ResourceNotAvailableForOffer",
          "message": "The resource is currently unavailable in the location for the offer type."
        },
        "value": [
          {
            "limit": {
              "limitObjectType": "LimitValue",
              "value": 52
            },
            "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C",
            "name": {
              "value": "standardHBSFamily",
              "localizedValue": "Standard HBS Family vCPUs"
            },
            "message": "Request failed, please contact support.",
            "provisioningState": "Failed"
          }
        ]
      }
    }
  ]
}

Definizioni

Nome	Descrizione
ExceptionResponse	Errore.
LimitObject	Valore limite della quota di risorse.
quotaLimitTypes	Tipi di limite di quota o utilizzo.
QuotaRequestDetails	Elenco delle richieste di quota con i dettagli.
QuotaRequestDetailsList	Informazioni sulla richiesta di quota.
QuotaRequestState	Stato della richiesta di quota.
ResourceName	Nome della risorsa fornita dal provider di risorse. Quando si richiede la quota, usare questo nome di proprietà.
ServiceError	Dettagli dell'errore dell'API.
ServiceErrorDetail	Dettagli errore.
SubRequest	Proprietà Request.

ExceptionResponse

Object

Errore.

Nome	Tipo	Descrizione
error	ServiceError	Dettagli dell'errore dell'API.

LimitObject

Object

Valore limite della quota di risorse.

Nome	Tipo	Descrizione
limitObjectType	string: LimitValue	Tipo di oggetto limite.
limitType	quotaLimitTypes	Tipi di limite di quota o utilizzo.
value	integer (int32)	La quota/valore limite

quotaLimitTypes

Enumerazione

Tipi di limite di quota o utilizzo.

Valore	Descrizione
Independent
Shared

QuotaRequestDetails

Object

Elenco delle richieste di quota con i dettagli.

Nome	Tipo	Descrizione
id	string	ID richiesta quota.
name	string	Nome della richiesta di quota.
properties.error	ServiceErrorDetail	Dettagli dell'errore della richiesta di quota.
properties.message	string	Messaggio di stato descrittivo.
properties.provisioningState	QuotaRequestState	Stato della richiesta di quota.
properties.requestSubmitTime	string (date-time)	Tempo di invio della richiesta di quota. La data è conforme al formato seguente specificato dallo standard ISO 8601: aaaa-MM-ggTHH:mm:ssZ
properties.value	SubRequest[]	Dettagli della richiesta di quota.
type	string	Tipo di risorsa. "Microsoft.Quota/quotes".

QuotaRequestDetailsList

Object

Informazioni sulla richiesta di quota.

Nome	Tipo	Descrizione
nextLink	string	URI per il recupero della pagina successiva dei limiti di quota. Quando non sono presenti altre pagine, questa stringa è null.
value	QuotaRequestDetails[]	Dettagli della richiesta di quota.

QuotaRequestState

Enumerazione

Stato della richiesta di quota.

Valore	Descrizione
Accepted
Failed
InProgress
Invalid
Succeeded

ResourceName

Object

Nome della risorsa fornita dal provider di risorse. Quando si richiede la quota, usare questo nome di proprietà.

Nome	Tipo	Descrizione
localizedValue	string	Nome visualizzato della risorsa.
value	string	Nome risorsa.

ServiceError

Object

Dettagli dell'errore dell'API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ServiceErrorDetail[]	Elenco dei dettagli dell'errore.
message	string	Messaggio di errore.

ServiceErrorDetail

Object

Dettagli errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.

SubRequest

Object

Proprietà Request.

Nome	Tipo	Descrizione
limit	LimitJsonObject: LimitObject	Proprietà del limite della quota di risorse.
message	string	Messaggio di stato descrittivo.
name	ResourceName	Nome risorsa.
provisioningState	QuotaRequestState	Stato della richiesta di quota.
resourceType	string	Tipo di risorsa per cui sono state richieste le proprietà della quota.
subRequestId	string	ID richiesta quota.
unit	string	Unità limite di quota, ad esempio Conteggio e byte. Quando si richiede la quota, usare l'unità valore restituito nella risposta GET nel corpo della richiesta dell'operazione PUT.