Udostępnij za pośrednictwem

Usages - List

  • Odwołanie
Usługa:
Quota
Wersja interfejsu API:
2025-03-01

Pobierz listę bieżącego użycia dla wszystkich zasobów dla określonego zakresu.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
scope
 path True

string

Docelowy identyfikator URI zasobu platformy Azure. Na przykład /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qms-test/providers/Microsoft.Batch/batchAccounts/testAccount/. Jest to docelowy identyfikator URI zasobu platformy Azure dla operacji List GET. Jeśli {resourceName} zostanie dodany po /quotas, jest to docelowy identyfikator URI zasobu platformy Azure w operacji GET dla określonego zasobu.
api-version
 query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

UsagesLimits

OK. Informacje o użyciu zostaną zwrócone w odpowiedzi z podziałem na strony.

Nagłówki

ETag: string
Other Status Codes

ExceptionResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Autoryzacja protokołu OAuth 2.0 w usłudze Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation Personifikuj konto użytkownika.

Przykłady

Quotas_listUsagesForCompute
Quotas_listUsagesForNetwork
Quotas_listUsagesMachineLearningServices

Quotas_listUsagesForCompute

Przykładowe żądanie

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/usages?api-version=2025-03-01

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardFSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardFSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardFSv2Family",
          "localizedValue": "Standard FSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNDSFamily",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNDSFamily",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNDSFamily",
          "localizedValue": "Standard NDS Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNCSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNCSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNCSv2Family",
          "localizedValue": "Standard NCSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNCSv3Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNCSv3Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNCSv3Family",
          "localizedValue": "Standard NCSv3 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardLSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardLSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardLSv2Family",
          "localizedValue": "Standard LSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardPBSFamily",
      "type": "Microsoft.Quota/Usages",
      "name": "standardPBSFamily",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardPBSFamily",
          "localizedValue": "Standard PBS Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardEIv3Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardEIv3Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardEIv3Family",
          "localizedValue": "Standard EIv3 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardEISv3Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardEISv3Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardEISv3Family",
          "localizedValue": "Standard EISv3 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardDCSFamily",
      "type": "Microsoft.Quota/Usages",
      "name": "standardDCSFamily",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardDCSFamily",
          "localizedValue": "Standard DCS Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardNVSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardNVSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardNVSv2Family",
          "localizedValue": "Standard NVSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/standardMSv2Family",
      "type": "Microsoft.Quota/Usages",
      "name": "standardMSv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": true,
        "name": {
          "value": "standardMSv2Family",
          "localizedValue": "Standard MSv2 Family vCPUs"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/Usages/availabilitySets",
      "type": "Microsoft.Quota/Usages",
      "name": "availabilitySets",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "isQuotaApplicable": false,
        "name": {
          "value": "availabilitySets",
          "localizedValue": "Availability Sets"
        }
      }
    }
  ],
  "nextLink": ""
}

Quotas_listUsagesForNetwork

Przykładowe żądanie

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages?api-version=2025-03-01

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "VirtualNetworks",
          "localizedValue": "Virtual Networks"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "VirtualNetworks"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "StaticPublicIPAddresses",
          "localizedValue": "Static Public IP Addresses"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "StaticPublicIPAddresses"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NetworkSecurityGroups",
          "localizedValue": "Network Security Groups"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NetworkSecurityGroups"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PublicIPAddresses",
          "localizedValue": "Public IP Addresses - Basic"
        },
        "isQuotaApplicable": true,
        "resourceType": "PublicIpAddresses",
        "properties": {}
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PublicIPAddresses"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PublicIpPrefixes",
          "localizedValue": "Public Ip Prefixes"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PublicIpPrefixes"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NatGateways",
          "localizedValue": "Nat Gateways"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NatGateways"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NetworkInterfaces",
          "localizedValue": "Network Interfaces"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NetworkInterfaces"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PrivateEndpoints",
          "localizedValue": "Private Endpoints"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PrivateEndpoints"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PrivateEndpointRedirectMaps",
          "localizedValue": "Private Endpoint Redirect Maps"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PrivateEndpointRedirectMaps"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "LoadBalancers",
          "localizedValue": "Load Balancers"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "LoadBalancers"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PrivateLinkServices",
          "localizedValue": "Private Link Services"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PrivateLinkServices"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "ApplicationGateways",
          "localizedValue": "Application Gateways"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "ApplicationGateways"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "RouteTables",
          "localizedValue": "Route Tables"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "RouteTables"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "RouteFilters",
          "localizedValue": "Route Filters"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "RouteFilters"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "NetworkWatchers",
          "localizedValue": "Network Watchers"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "NetworkWatchers"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "PacketCaptures",
          "localizedValue": "Packet Captures"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "PacketCaptures"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "ApplicationSecurityGroups",
          "localizedValue": "Application Security Groups."
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "ApplicationSecurityGroups"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "StandardSkuLoadBalancers",
          "localizedValue": "Standard Sku Load Balancers"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "StandardSkuLoadBalancers"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "StandardSkuPublicIpAddresses",
          "localizedValue": "Public IP Addresses - Standard"
        },
        "isQuotaApplicable": true,
        "resourceType": "PublicIpAddresses"
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "StandardSkuPublicIpAddresses"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "DnsServersPerVirtualNetwork",
          "localizedValue": "DNS servers per Virtual Network"
        },
        "properties": {},
        "isQuotaApplicable": false
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "DnsServersPerVirtualNetwork"
    },
    {
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "MinPublicIpInterNetworkPrefixLength",
          "localizedValue": "Min Public Ip InterNetwork Prefix Length"
        },
        "properties": {},
        "isQuotaApplicable": true
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/usages/",
      "type": "Microsoft.Quota/usages",
      "name": "MinPublicIpInterNetworkPrefixLength"
    }
  ]
}

Quotas_listUsagesMachineLearningServices

Przykładowe żądanie

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/usages?api-version=2025-03-01

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/usages/standardDv2Family",
      "type": "Microsoft.Quota/usages",
      "name": "standardDv2Family",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "standardDv2Family",
          "localizedValue": "Standard Dv2 Family vCPUs"
        },
        "resourceType": "dedicated"
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/usages/totalLowPriorityCores",
      "type": "Microsoft.Quota/usages",
      "name": "totalLowPriorityCores",
      "properties": {
        "usages": {
          "value": 10
        },
        "unit": "Count",
        "name": {
          "value": "totalLowPriorityCores",
          "localizedValue": "Total Regional Low-priority vCPUs"
        },
        "resourceType": "lowPriority"
      }
    }
  ]
}

Definicje

Nazwa Opis
CurrentUsagesBase

Użycie zasobów.
ExceptionResponse

Błąd.
ResourceName

Nazwa zasobu dostarczonego przez dostawcę zasobów. Podczas żądania limitu przydziału użyj tej nazwy właściwości.
ServiceError

Szczegóły błędu interfejsu API.
ServiceErrorDetail

Szczegóły błędu.
UsagesLimits

Limity przydziału.
UsagesObject

Wartość użycia zasobów.
UsagesProperties

Właściwości użycia dla określonego zasobu.
usagesTypes

Typy limitów przydziału lub użycia.

CurrentUsagesBase

Objekt

Użycie zasobów.

Nazwa Typ Opis
id

string

Identyfikator zasobu.
name

string

Nazwa zasobu.
properties

UsagesProperties

Właściwości użycia dla określonego zasobu.
type

string

Typ zasobu.

ExceptionResponse

Objekt

Błąd.

Nazwa Typ Opis
error

ServiceError

Szczegóły błędu interfejsu API.

ResourceName

Objekt

Nazwa zasobu dostarczonego przez dostawcę zasobów. Podczas żądania limitu przydziału użyj tej nazwy właściwości.

Nazwa Typ Opis
localizedValue

string

Nazwa wyświetlana zasobu.
value

string

Nazwa zasobu.

ServiceError

Objekt

Szczegóły błędu interfejsu API.

Nazwa Typ Opis
code

string

Kod błędu.
details

ServiceErrorDetail[]

Lista szczegółów błędu.
message

string

Komunikat o błędzie.

ServiceErrorDetail

Objekt

Szczegóły błędu.

Nazwa Typ Opis
code

string

Kod błędu.
message

string

Komunikat o błędzie.

UsagesLimits

Objekt

Limity przydziału.

Nazwa Typ Opis
nextLink

string

Identyfikator URI używany do pobierania następnej strony limitów przydziału. Jeśli nie ma więcej stron, jest to wartość null.
value

CurrentUsagesBase[]

Lista limitów przydziału.

UsagesObject

Objekt

Wartość użycia zasobów.

Nazwa Typ Opis
usagesType

usagesTypes

Typy limitów przydziału lub użycia.
value

integer (int32)

Wartość użycia.

UsagesProperties

Objekt

Właściwości użycia dla określonego zasobu.

Nazwa Typ Opis
isQuotaApplicable

boolean

Stany, jeśli można zażądać limitu przydziału dla tego zasobu.
name

ResourceName

Nazwa zasobu podana przez dostawcę zasobu. Użyj tej nazwy właściwości podczas żądania limitu przydziału.
properties

object

Dodatkowe właściwości dla określonego dostawcy zasobów.
quotaPeriod

string

Okres podsumowania wartości użycia limitu przydziału. Na przykład: *P1D (dziennie) *PT1M (na jedną minutę) *PT1S (na jedną sekundę). Ten parametr jest opcjonalny, ponieważ nie jest odpowiedni dla wszystkich zasobów, takich jak obliczenia.
resourceType

string

Nazwa typu zasobu. Pole opcjonalne.
unit

string

Jednostki użycia limitu przydziału, takie jak Liczba i Bajty. Podczas żądania limitu przydziału użyj wartości jednostki zwróconej w odpowiedzi GET w treści żądania operacji PUT.
usages

UsagesObject

Właściwości limitu przydziału dla tego zasobu.

usagesTypes

Wyliczanie

Typy limitów przydziału lub użycia.

Wartość Opis
Combined
Individual