Freigeben über

Usage - List

Dienst:
Compute
API-Version:
2025-04-01

Ruft für den angegebenen Standort die aktuellen Informationen zur Nutzung der Computing-Ressource sowie die Grenzwerte für Computing-Ressourcen im Rahmen des Abonnements ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/usages?api-version=2025-04-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
location
 path True

string

minLength: 1

Der Name der Azure-Region.
subscriptionId
 path True

string

minLength: 1

Hierbei handelt es sich um die ID des Zielabonnements.
api-version
 query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

ListUsagesResult

Die Anforderung war erfolgreich.
Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Usage_List_MaximumSet_Gen
Usage_List_MinimumSet_Gen

Usage_List_MaximumSet_Gen

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/4_./usages?api-version=2025-04-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "unit": "Count",
      "currentValue": 17,
      "limit": 19,
      "name": {
        "value": "aaaaaaaaaaaaaaaaaa",
        "localizedValue": "aaaaaaaaaaaaaa"
      }
    }
  ],
  "nextLink": "a://example.com/aaaaaaaaaaaaaaaaaaaaaaaaaaa"
}

Usage_List_MinimumSet_Gen

Beispielanforderung

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/_--/usages?api-version=2025-04-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "unit": "Count",
      "currentValue": 17,
      "limit": 19,
      "name": {}
    }
  ]
}

Definitionen

Name Beschreibung
ApiError

API-Fehler.
ApiErrorBase

API-Fehlerbasis.
CloudError

Eine Fehlerantwort vom Compute-Dienst.
InnerError

Innere Fehlerdetails.
ListUsagesResult

Die Antwort des Vorgangs List Usages.
Usage

Beschreibt die Berechnungsressourcennutzung.
UsageName

Die Verwendungsnamen.

ApiError

Objekt

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.
details

ApiErrorBase[]

Die Details zum API-Fehler
innererror

InnerError

Der innere API-Fehler
message

string

Die Fehlermeldung.
target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

Objekt

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.
message

string

Die Fehlermeldung.
target

string

Das Ziel des bestimmten Fehlers.

CloudError

Objekt

Eine Fehlerantwort vom Compute-Dienst.

Name Typ Beschreibung
error

ApiError

API-Fehler.

InnerError

Objekt

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder der Ausnahmedump.
exceptiontype

string

Der Ausnahmetyp.

ListUsagesResult

Objekt

Die Antwort des Vorgangs List Usages.

Name Typ Beschreibung
nextLink

string (uri)

Der URI zum Abrufen der nächsten Seite mit Informationen zur Nutzung von Computing-Ressourcen. Rufen Sie ListNext() mit diesem Argument auf, um die nächste Seite mit Informationen zur Nutzung von Computing-Ressourcen abzurufen.
value

Usage[]

Die Liste der verwendeten Computing-Ressourcen.

Usage

Objekt

Beschreibt die Berechnungsressourcennutzung.

Name Typ Beschreibung
currentValue

integer (int32)

Die aktuelle Verwendung der Ressource.
limit

integer (int64)

Die maximal zulässige Verwendung der Ressource.
name

UsageName

Der Name des Verwendungstyps.
unit enum:

Count

Eine Enumeration, die die Maßeinheit der Nutzung beschreibt.

UsageName

Objekt

Die Verwendungsnamen.

Name Typ Beschreibung
localizedValue

string

Der lokalisierte Name der Ressource.
value

string

Der Name der Ressource.