Usages - List By Subscription

Tjänst:: Search Management

API-version:: 2026-11-01

Få en lista över alla Azure AI-sökning-kvotanvändningar i hela prenumerationen.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages?api-version=2026-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
location	path	True	string minLength: 1	Namnet på Azure-regionen.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandehuvud

Name	Obligatorisk	Typ	Description
x-ms-client-request-id		string (uuid)	Ett klientgenererat GUID-värde som identifierar den här begäran. Om det anges inkluderas detta i svarsinformationen som ett sätt att spåra begäran.

Svar

Name	Typ	Description
200 OK	QuotaUsagesListResult	Begäran har slutförts.
Other Status Codes	CloudError	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

GetQuotaUsagesList

Exempelbegäran

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Search/locations/westus/usages?api-version=2026-11-01

Exempelsvar

Statuskod:: 200

{
  "nextLink": null,
  "value": [
    {
      "name": {
        "localizedValue": "F - Free",
        "value": "free"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/free",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "B - Basic",
        "value": "basic"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/basic",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "S - Standard",
        "value": "standard"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/standard",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "S2 - Standard2",
        "value": "standard2"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/standard2",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "S3 - Standard3",
        "value": "standard3"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/standard3",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "L1 - Storage Optimized",
        "value": "storageOptimizedL1"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/storageOptimizedL1",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "L2 - Storage Optimized",
        "value": "storageOptimizedL2"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/storageOptimizedL2",
      "limit": 16,
      "unit": "Count"
    },
    {
      "name": {
        "localizedValue": "SL - Serverless",
        "value": "serverless"
      },
      "currentValue": 8,
      "id": "/subscriptions/{subscriptionId}/providers/Microsoft.Search/locations/{location}/usages/serverless",
      "limit": 16,
      "unit": "Count"
    }
  ]
}

Definitioner

Name	Description
CloudError	Innehåller information om ett API-fel.
CloudErrorBody	Beskriver ett visst API-fel med en felkod och ett meddelande.
QuotaUsageResult	Beskriver kvotanvändningen för en viss SKU.
QuotaUsageResultName	SKU-namninformationen, inklusive dess identifierare och lokaliserade visningsnamn.
QuotaUsagesListResult	Svar som innehåller information om kvotanvändning för alla SKU:er som stöds i Azure AI-sökning.

CloudError

Objekt

Innehåller information om ett API-fel.

Name	Typ	Description
error	CloudErrorBody	Beskriver ett visst API-fel med en felkod och ett meddelande.
message	string	En kort beskrivning av felet som antyder vad som gick fel (mer information/felsökningsinformation finns i egenskapen "error.message").

CloudErrorBody

Objekt

Beskriver ett visst API-fel med en felkod och ett meddelande.

Name	Typ	Description
code	string	En felkod som beskriver feltillståndet mer exakt än en HTTP-statuskod. Kan användas för att programmatiskt hantera specifika felfall.
details	CloudErrorBody[]	Innehåller kapslade fel som är relaterade till det här felet.
message	string	Ett meddelande som beskriver felet i detalj och ger felsökningsinformation.
target	string	Målet för det specifika felet (till exempel namnet på den felaktiga egenskapen).

QuotaUsageResult

Objekt

Beskriver kvotanvändningen för en viss SKU.

Name	Typ	Description
currentValue	integer (int32)	Det för närvarande förbrukade värdet för den specifika sök-SKU:n.
id	string	Resurs-ID för kvotanvändnings-SKU-endpointen för Microsoft. Sök leverantör.
limit	integer (int32)	Kvotgränsen för den specifika sök-SKU:n.
name	QuotaUsageResultName	SKU-namninformationen för den aktuella söktjänsten.
unit	string	Måttenheten för sök-SKU:n.

QuotaUsageResultName

Objekt

SKU-namninformationen, inklusive dess identifierare och lokaliserade visningsnamn.

Name	Typ	Description
localizedValue	string	Det lokaliserade strängvärdet för SKU-namnet.
value	string	SKU-namnet stöds av Azure AI-sökning.

QuotaUsagesListResult

Objekt

Svar som innehåller information om kvotanvändning för alla SKU:er som stöds i Azure AI-sökning.

Name	Typ	Description
nextLink	string	Begär URL som kan användas för att köra frågor mot nästa sida med kvotanvändningar. Returneras när det totala antalet begärda kvotanvändningar överskrider den maximala sidstorleken.
value	QuotaUsageResult[]	Kvotanvändningen för SKU:er som stöds av Azure AI-sökning.