App Service Environments - List Usages

Dienst:: App Service

API-Version:: 2026-03-15

Beschreibung für Erhalten Sie globale Nutzungsmetriken einer App Service-Umgebung.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{name}/usages?api-version=2026-03-15

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{name}/usages?api-version=2026-03-15&$filter={$filter}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
name	path	True	string	Name der App Service-Umgebung.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
$filter	query		string	Gibt nur die im Filter angegebenen Verwendungen/Metriken zurück. Der Filter entspricht der odata-Syntax. Beispiel: $filter=(name.value eq 'Metric1' oder name.value eq 'Metric2') und startTime eq 2014-01-01T00:00:00Z und endTime eq 2014-12-31T23:59:59Z und timeGrain eq duration'[Stunde\|Minute\|Tag]".

Antworten

Name	Typ	Beschreibung
200 OK	CsmUsageQuotaCollection	Azure-Operation erfolgreich abgeschlossen.
Other Status Codes	DefaultErrorResponse	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

Get global usage metrics of an App Service Environment.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase/usages?api-version=2026-03-15

Beispiel für eine Antwort

Statuscode:: 200

{
  "nextLink": null,
  "value": [
    {
      "name": {
        "localizedValue": "File System Storage",
        "value": "FileSystemStorage"
      },
      "currentValue": 37888,
      "limit": 1099511627776,
      "nextResetTime": "9999-12-31T23:59:59.9999999Z",
      "unit": "Bytes"
    }
  ]
}

Definitionen

Name	Beschreibung
CsmUsageQuota	Verwendung der Kontingentressource.
CsmUsageQuotaCollection	Ausgezogene Sammlung von CsmUsageQuota-Einträgen
DefaultErrorResponse	Fehlerantwort des App-Diensts.
DefaultErrorResponseError	Fehlermodell.
DefaultErrorResponseErrorDetailsItem	Detaillierte Fehler.
LocalizableString	Lokalisierbares Zeichenfolgenobjekt, das den Namen und einen lokalisierten Wert enthält.

CsmUsageQuota

Objekt

Verwendung der Kontingentressource.

Name	Typ	Beschreibung
currentValue	integer (int64)	Der aktuelle Wert des Ressourcenzählers.
limit	integer (int64)	Das Ressourcenlimit.
name	LocalizableString	Name des Kontingents.
nextResetTime	string (date-time)	Nächster Zeitpunkt zum Zurücksetzen des Ressourcenindikators.
unit	string	Maßeinheiten für die Kontingentressource.

CsmUsageQuotaCollection

Objekt

Ausgezogene Sammlung von CsmUsageQuota-Einträgen

Name	Typ	Beschreibung
nextLink	string (uri)	Der Link zur nächsten Seite von Elementen
value	CsmUsageQuota[]	Die CsmUsageQuota-Elemente auf dieser Seite

DefaultErrorResponse

Objekt

Fehlerantwort des App-Diensts.

Name	Typ	Beschreibung
error	DefaultErrorResponseError	Fehlermodell.

DefaultErrorResponseError

Objekt

Fehlermodell.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
details	DefaultErrorResponseErrorDetailsItem[]	Detaillierte Fehler.
innererror	string	Weitere Informationen zum Debuggen von Fehlern.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

DefaultErrorResponseErrorDetailsItem

Objekt

Detaillierte Fehler.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

LocalizableString

Objekt

Lokalisierbares Zeichenfolgenobjekt, das den Namen und einen lokalisierten Wert enthält.

Name	Typ	Beschreibung
localizedValue	string	Lokalisierter Name.
value	string	Nicht lokalisierter Name.