Log Analytics - Get Waf Log Analytics Rankings

Dienst:

Front Door Service

API-Version:

2025-04-15

Abrufen von WAF-Protokollanalysediagrammen für AFD-Profil

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getWafLogAnalyticsRankings?api-version=2025-04-15&metrics=clientRequestCount&dateTimeBegin={dateTimeBegin}&dateTimeEnd={dateTimeEnd}&maxRanking={maxRanking}&rankings={rankings}

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getWafLogAnalyticsRankings?api-version=2025-04-15&metrics=clientRequestCount&dateTimeBegin={dateTimeBegin}&dateTimeEnd={dateTimeEnd}&maxRanking={maxRanking}&rankings={rankings}&actions={actions}&ruleTypes={ruleTypes}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
profileName	path	True	string	Name des Azure Front Door Standard- oder Azure Front Door Premium-Profils, das innerhalb der Ressourcengruppe eindeutig ist. die innerhalb der Ressourcengruppe eindeutig ist.
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.
dateTimeBegin	query	True	string (date-time)
dateTimeEnd	query	True	string (date-time)
maxRanking	query	True	integer (int32)
metrics	query	True	WafMetric[]
rankings	query	True	WafRankingType[]
actions	query		WafAction[]
ruleTypes	query		WafRuleType[]

Antworten

Name	Typ	Beschreibung
200 OK	WafRankingsResponse	Beschreiben des Ergebnisses eines erfolgreichen Vorgangs.
Other Status Codes	ErrorResponse	Azure Front Door Error Response, 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

LogAnalytics_GetWafLogAnalyticsRankings

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/getWafLogAnalyticsRankings?api-version=2025-04-15&metrics=clientRequestCount&dateTimeBegin=2020-11-04T06:49:27.554Z&dateTimeEnd=2020-11-04T09:49:27.554Z&maxRanking=5&rankings=ruleId

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Cdn.Models;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Cdn;

// Generated from example definition: specification/cdn/resource-manager/Microsoft.Cdn/stable/2025-04-15/examples/LogAnalytics_GetWafLogAnalyticsRankings.json
// this example is just showing the usage of "LogAnalytics_GetWafLogAnalyticsRankings" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ProfileResource created on azure
// for more information of creating ProfileResource, please refer to the document of ProfileResource
string subscriptionId = "subid";
string resourceGroupName = "RG";
string profileName = "profile1";
ResourceIdentifier profileResourceId = ProfileResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, profileName);
ProfileResource profile = client.GetProfileResource(profileResourceId);

// invoke the operation
IEnumerable<WafMetric> metrics = new WafMetric[] { WafMetric.ClientRequestCount };
DateTimeOffset dateTimeBegin = DateTimeOffset.Parse("2020-11-04T06:49:27.554Z");
DateTimeOffset dateTimeEnd = DateTimeOffset.Parse("2020-11-04T09:49:27.554Z");
int maxRanking = 5;
IEnumerable<WafRankingType> rankings = new WafRankingType[] { WafRankingType.RuleId };
ProfileResourceGetWafLogAnalyticsRankingsOptions options = new ProfileResourceGetWafLogAnalyticsRankingsOptions(metrics, dateTimeBegin, dateTimeEnd, maxRanking, rankings);
WafRankingsResponse result = await profile.GetWafLogAnalyticsRankingsAsync(options);

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

200

{
  "dateTimeBegin": "2020-11-04T14:49:27.554+08:00",
  "dateTimeEnd": "2020-11-04T17:49:27.554+08:00",
  "groups": [
    "ruleId"
  ],
  "data": [
    {
      "groupValues": [
        "BlockRateLimit"
      ],
      "metrics": [
        {
          "metric": "clientRequestCount",
          "value": 1268,
          "percentage": 0
        }
      ]
    }
  ]
}

Definitionen

Name	Beschreibung
Data
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
WafAction
WafMetric
WafRankingsResponse	Waf Ranking Response
WafRankingType
WafRuleType

Data

Objekt

Name	Typ	Beschreibung
dateTime	string (date-time)
value	number

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.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

WafAction

Enumeration

Wert	Beschreibung
allow
block
log
redirect

WafMetric

Enumeration

Wert	Beschreibung
clientRequestCount

WafRankingsResponse

Objekt

Waf Ranking Response

Name	Typ	Beschreibung
data	Data[]
dateTimeBegin	string (date-time)
dateTimeEnd	string (date-time)
groups	string[]

WafRankingType

Enumeration

Wert	Beschreibung
action
clientIp
countryOrRegion
ruleGroup
ruleId
ruleType
url
userAgent

WafRuleType

Enumeration

Wert	Beschreibung
bot
custom
managed