Rule Sets - List Resource Usage

Dienst:: Front Door Service

API-Version:: 2025-04-15

Überprüft das Kontingent und die tatsächliche Nutzung von Endpunkten unter dem angegebenen Azure Front Door-Profil..

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/usages?api-version=2025-04-15

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-[a-zA-Z0-9])$	Name des Azure Front Door Standard oder Azure Front Door Premium, der innerhalb der Ressourcengruppe eindeutig ist.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Name der Ressourcengruppe innerhalb des Azure-Abonnements.
ruleSetName	path	True	string	Name des Regelsatzes unter dem Profil, das global eindeutig ist.
subscriptionId	path	True	string	Die Azure-Abonnement-ID.
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2025-04-15.

Antworten

Name	Typ	Beschreibung
200 OK	UsagesListResult	OKAY. Die Anforderung ist erfolgreich.
Other Status Codes	AfdErrorResponse	Azure Front Door-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

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

RuleSets_ListResourceUsage

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1/usages?api-version=2025-04-15

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "unit": "Count",
      "currentValue": 0,
      "limit": 25,
      "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/rulesets/ruleSet1/rules/rule1",
      "name": {
        "value": "rule",
        "localizedValue": "rule"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AfdErrorResponse	Fehlerantwort
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
Usage	Beschreibt die Ressourcennutzung.
UsageName	Die Verwendungsnamen.
UsagesListResult	Antwort auf die Listenverwendungsoperation.
UsageUnit	Eine Enumeration, die die Maßeinheit beschreibt.

AfdErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

Usage

Objekt

Beschreibt die Ressourcennutzung.

Name	Typ	Beschreibung
currentValue	integer (int64)	Der aktuelle Wert der Verwendung.
id	string	Ressourcenbezeichner.
limit	integer (int64)	Der Grenzwert für die Nutzung.
name	UsageName	Der Name des Typs der Verwendung.
unit	UsageUnit	Eine Enumeration, die die Maßeinheit beschreibt.

UsageName

Objekt

Die Verwendungsnamen.

Name	Typ	Beschreibung
localizedValue	string	Eine lokalisierte Zeichenfolge, die den Ressourcennamen beschreibt.
value	string	Eine Zeichenfolge, die den Ressourcennamen beschreibt.

UsagesListResult

Objekt

Antwort auf die Listenverwendungsoperation.

Name	Typ	Beschreibung
nextLink	string	URL, um den nächsten Satz von Ergebnissen abzurufen.
value	Usage[]	Die Liste der Ressourcenverwendungen.

UsageUnit

Enumeration

Eine Enumeration, die die Maßeinheit beschreibt.

Wert	Beschreibung
Count