Application Gateway Waf Dynamic Manifests - Get

Referencia

Szolgáltatás:: Application Gateway

API-verzió:: 2024-05-01

Lekéri a regionális Application Gateway waf-jegyzékfájlt.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/applicationGatewayWafDynamicManifests?api-version=2024-05-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
location	path	True	string	Az a régió, ahol az nrp található.
subscriptionId	path	True	string	Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version	query	True	string	Ügyfél API-verziója.

Válaszok

Name	Típus	Description
200 OK	ApplicationGatewayWafDynamicManifestResultList	A kérés sikeres. A regionális Application Gateway waf-jegyzékfájljának visszaadása
Other Status Codes	CloudError	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Gets WAF manifests

Mintakérelem

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/locations/westus/applicationGatewayWafDynamicManifests?api-version=2024-05-01


/**
 * Samples for ApplicationGatewayWafDynamicManifests Get.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/
     * GetApplicationGatewayWafDynamicManifests.json
     */
    /**
     * Sample code: Gets WAF manifests.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getsWAFManifests(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.networks().manager().serviceClient().getApplicationGatewayWafDynamicManifests().get("westus",
            com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.network import NetworkManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-network
# USAGE
    python get_application_gateway_waf_dynamic_manifests.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = NetworkManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.application_gateway_waf_dynamic_manifests.get(
        location="westus",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/GetApplicationGatewayWafDynamicManifests.json
if __name__ == "__main__":
    main()

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

package armnetwork_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/network/armnetwork/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ab04533261eff228f28e08900445d0edef3eb70c/specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/GetApplicationGatewayWafDynamicManifests.json
func ExampleApplicationGatewayWafDynamicManifestsClient_NewGetPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetwork.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewApplicationGatewayWafDynamicManifestsClient().NewGetPager("westus", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.ApplicationGatewayWafDynamicManifestResultList = armnetwork.ApplicationGatewayWafDynamicManifestResultList{
		// 	Value: []*armnetwork.ApplicationGatewayWafDynamicManifestResult{
		// 		{
		// 			Name: to.Ptr("default"),
		// 			Type: to.Ptr("Microsoft.Network/applicationGatewayWafDynamicManifest"),
		// 			ID: to.Ptr("/subscriptions/subid/providers/Microsoft.Network/applicationGatewayWafDynamicManifests/default"),
		// 			Properties: &armnetwork.ApplicationGatewayWafDynamicManifestPropertiesResult{
		// 				AvailableRuleSets: []*armnetwork.ApplicationGatewayFirewallManifestRuleSet{
		// 					{
		// 						RuleGroups: []*armnetwork.ApplicationGatewayFirewallRuleGroup{
		// 							{
		// 								Description: to.Ptr(""),
		// 								RuleGroupName: to.Ptr("General"),
		// 								Rules: []*armnetwork.ApplicationGatewayFirewallRule{
		// 									{
		// 										Description: to.Ptr("Failed to Parse Request Body."),
		// 										Action: to.Ptr(armnetwork.ApplicationGatewayWafRuleActionTypesAnomalyScoring),
		// 										RuleID: to.Ptr[int32](200002),
		// 										RuleIDString: to.Ptr("200002"),
		// 										State: to.Ptr(armnetwork.ApplicationGatewayWafRuleStateTypesEnabled),
		// 									},
		// 									{
		// 										Description: to.Ptr("Multipart Request Body Strict Validation."),
		// 										Action: to.Ptr(armnetwork.ApplicationGatewayWafRuleActionTypesAnomalyScoring),
		// 										RuleID: to.Ptr[int32](200003),
		// 										RuleIDString: to.Ptr("200003"),
		// 										State: to.Ptr(armnetwork.ApplicationGatewayWafRuleStateTypesEnabled),
		// 									},
		// 									{
		// 										Description: to.Ptr("Possible Multipart Unmatched Boundary."),
		// 										Action: to.Ptr(armnetwork.ApplicationGatewayWafRuleActionTypesAnomalyScoring),
		// 										RuleID: to.Ptr[int32](200004),
		// 										RuleIDString: to.Ptr("200004"),
		// 										State: to.Ptr(armnetwork.ApplicationGatewayWafRuleStateTypesEnabled),
		// 								}},
		// 						}},
		// 						RuleSetType: to.Ptr("OWASP"),
		// 						RuleSetVersion: to.Ptr("3.2"),
		// 						Status: to.Ptr(armnetwork.ApplicationGatewayRuleSetStatusOptions("0")),
		// 						Tiers: []*armnetwork.ApplicationGatewayTierTypes{
		// 							to.Ptr(armnetwork.ApplicationGatewayTierTypesWAFV2)},
		// 					}},
		// 					DefaultRuleSet: &armnetwork.DefaultRuleSetPropertyFormat{
		// 						RuleSetType: to.Ptr("OWASP"),
		// 						RuleSetVersion: to.Ptr("3.2"),
		// 					},
		// 				},
		// 		}},
		// 	}
	}
}

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

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets the regional application gateway waf manifest.
 *
 * @summary Gets the regional application gateway waf manifest.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/GetApplicationGatewayWafDynamicManifests.json
 */
async function getsWafManifests() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const location = "westus";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (let item of client.applicationGatewayWafDynamicManifests.list(location)) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Network;

// Generated from example definition: specification/network/resource-manager/Microsoft.Network/stable/2024-05-01/examples/GetApplicationGatewayWafDynamicManifests.json
// this example is just showing the usage of "ApplicationGatewayWafDynamicManifests_Get" 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 SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "subid";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// get the collection of this ApplicationGatewayWafDynamicManifestResource
AzureLocation location = new AzureLocation("westus");
ApplicationGatewayWafDynamicManifestCollection collection = subscriptionResource.GetApplicationGatewayWafDynamicManifests(location);

// invoke the operation and iterate over the result
await foreach (ApplicationGatewayWafDynamicManifestResource item in collection.GetAllAsync())
{
    // the variable item is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ApplicationGatewayWafDynamicManifestData resourceData = item.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

Console.WriteLine("Succeeded");

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

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "name": "default",
      "id": "/subscriptions/subid/providers/Microsoft.Network/applicationGatewayWafDynamicManifests/default",
      "type": "Microsoft.Network/applicationGatewayWafDynamicManifest",
      "properties": {
        "defaultRuleSet": {
          "ruleSetType": "OWASP",
          "ruleSetVersion": "3.2"
        },
        "availableRuleSets": [
          {
            "ruleSetType": "OWASP",
            "ruleSetVersion": "3.2",
            "status": "0",
            "tiers": [
              "WAF_v2"
            ],
            "ruleGroups": [
              {
                "ruleGroupName": "General",
                "description": "",
                "rules": [
                  {
                    "ruleId": 200002,
                    "ruleIdString": "200002",
                    "description": "Failed to Parse Request Body.",
                    "state": "Enabled",
                    "action": "AnomalyScoring"
                  },
                  {
                    "ruleId": 200003,
                    "ruleIdString": "200003",
                    "description": "Multipart Request Body Strict Validation.",
                    "state": "Enabled",
                    "action": "AnomalyScoring"
                  },
                  {
                    "ruleId": 200004,
                    "ruleIdString": "200004",
                    "description": "Possible Multipart Unmatched Boundary.",
                    "state": "Enabled",
                    "action": "AnomalyScoring"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

Definíciók

Name	Description
ApplicationGatewayFirewallRule	Webalkalmazás tűzfalszabálya.
ApplicationGatewayFirewallRuleGroup	Webalkalmazási tűzfalszabály-csoport.
ApplicationGatewayRuleSetStatusOptions	A szabálykészlet állapota
ApplicationGatewayTierTypes	A szabálykészletet támogató application gateway szintje.
ApplicationGatewayWafDynamicManifestResult	Válasz az ApplicationGatewayWafDynamicManifest API szolgáltatáshívására.
ApplicationGatewayWafDynamicManifestResultList	Válasz az ApplicationGatewayWafDynamicManifests API szolgáltatáshívására.
ApplicationGatewayWafRuleActionTypes	A webalkalmazás tűzfalszabály-műveletének sztring-ábrázolása.
ApplicationGatewayWafRuleSensitivityTypes	A webalkalmazás tűzfalszabály-érzékenységének sztring-ábrázolása.
ApplicationGatewayWafRuleStateTypes	A webalkalmazás tűzfalszabály-állapotának sztring-ábrázolása.
CloudError	Hibaválasz a szolgáltatástól.
CloudErrorBody	Hibaválasz a szolgáltatástól.

ApplicationGatewayFirewallRule

Objektum

Webalkalmazás tűzfalszabálya.

Name	Típus	Description
action	ApplicationGatewayWafRuleActionTypes	A webalkalmazás tűzfalszabály-műveletének sztring-ábrázolása.
description	string	A webalkalmazás tűzfalszabályának leírása.
ruleId	integer (int32)	A webalkalmazás tűzfalszabályának azonosítója.
ruleIdString	string	A webalkalmazás tűzfalszabály-azonosítójának sztring-ábrázolása.
sensitivity	ApplicationGatewayWafRuleSensitivityTypes	A webalkalmazás tűzfalszabály-érzékenységének sztring-ábrázolása.
state	ApplicationGatewayWafRuleStateTypes	A webalkalmazás tűzfalszabály-állapotának sztring-ábrázolása.

ApplicationGatewayFirewallRuleGroup

Objektum

Webalkalmazási tűzfalszabály-csoport.

Name	Típus	Description
description	string	A webalkalmazás tűzfalszabály-csoportjának leírása.
ruleGroupName	string	A webalkalmazás tűzfalszabály-csoportjának neve.
rules	ApplicationGatewayFirewallRule[]	A webalkalmazás tűzfalszabály-csoportjának szabályai.

ApplicationGatewayRuleSetStatusOptions

Enumerálás

A szabálykészlet állapota

Érték	Description
Deprecated
GA
Preview
Supported

ApplicationGatewayTierTypes

Enumerálás

A szabálykészletet támogató application gateway szintje.

Érték	Description
Standard
Standard_v2
WAF
WAF_v2

ApplicationGatewayWafDynamicManifestResult

Objektum

Válasz az ApplicationGatewayWafDynamicManifest API szolgáltatáshívására.

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.availableRuleSets.ruleGroups	ApplicationGatewayFirewallRuleGroup[]	A webalkalmazás tűzfalszabálykészletének szabálycsoportjai.
properties.availableRuleSets.ruleSetType	string	A webalkalmazás tűzfalszabálykészletének típusa.
properties.availableRuleSets.ruleSetVersion	string	A webalkalmazás tűzfalszabály-készletének típusa.
properties.availableRuleSets.status	ApplicationGatewayRuleSetStatusOptions	A szabálykészlet állapota
properties.availableRuleSets.tiers	ApplicationGatewayTierTypes[]	A szabálykészletet támogató application gateway szintje.
properties.defaultRuleSet.ruleSetType	string	A webalkalmazás tűzfalszabálykészletének típusa.
properties.defaultRuleSet.ruleSetVersion	string	A webalkalmazás tűzfalszabály-készletének típusa.
type	string	Erőforrás típusa.

ApplicationGatewayWafDynamicManifestResultList

Objektum

Válasz az ApplicationGatewayWafDynamicManifests API szolgáltatáshívására.

Name	Típus	Description
nextLink	string	URL-cím a következő találatkészlet lekéréséhez.
value	ApplicationGatewayWafDynamicManifestResult[]	Az Application Gateway waf jegyzékfájljának listája.

ApplicationGatewayWafRuleActionTypes

Enumerálás

A webalkalmazás tűzfalszabály-műveletének sztring-ábrázolása.

Érték	Description
Allow
AnomalyScoring
Block
Log
None

ApplicationGatewayWafRuleSensitivityTypes

Enumerálás

A webalkalmazás tűzfalszabály-érzékenységének sztring-ábrázolása.

Érték	Description
High
Low
Medium
None

ApplicationGatewayWafRuleStateTypes

Enumerálás

A webalkalmazás tűzfalszabály-állapotának sztring-ábrázolása.

Érték	Description
Disabled
Enabled

CloudError

Objektum

Hibaválasz a szolgáltatástól.

Name	Típus	Description
error	CloudErrorBody	Felhőbeli hibatörzs.

CloudErrorBody

Objektum

Hibaválasz a szolgáltatástól.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.