Admin Rule Collections - List

Service:: Network Manager

API-versie:: 2025-05-01

Geeft een overzicht van alle regelverzamelingen in een beveiligingsbeheerconfiguratie, in een gepagineerde indeling.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections?api-version=2025-05-01

Met optionele parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/securityAdminConfigurations/{configurationName}/ruleCollections?api-version=2025-05-01&$top={$top}&$skipToken={$skipToken}

URI-parameters

Name	In	Vereist	Type	Description
configurationName	path	True	string	De naam van de netwerkbeheerbeveiligingsconfiguratie.
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	De naam van de netwerkbeheerder.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
$skipToken	query		string	SkipToken wordt alleen gebruikt als een vorige bewerking een gedeeltelijk resultaat heeft geretourneerd. Als een eerder antwoord een nextLink-element bevat, bevat de waarde van het nextLink-element een skipToken-parameter die een beginpunt aangeeft dat moet worden gebruikt voor volgende aanroepen.
$top	query		integer (int32) minimum: 1 maximum: 20	Een optionele queryparameter waarmee het maximum aantal records wordt opgegeven dat door de server moet worden geretourneerd.

Antwoorden

Name	Type	Description
200 OK	AdminRuleCollectionListResult	Azure-operatie succesvol voltooid.
Other Status Codes	CommonErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

List security admin rule collections

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig/ruleCollections?api-version=2025-05-01

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

/**
 * This sample demonstrates how to Lists all the rule collections in a security admin configuration, in a paginated format.
 *
 * @summary Lists all the rule collections in a security admin configuration, in a paginated format.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkManagerAdminRuleCollectionList.json
 */
async function listSecurityAdminRuleCollections() {
  const subscriptionId =
    process.env["NETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const networkManagerName = "testNetworkManager";
  const configurationName = "myTestSecurityConfig";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.adminRuleCollections.list(
    resourceGroupName,
    networkManagerName,
    configurationName,
  )) {
    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

Voorbeeldrespons

Statuscode:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig/ruleCollections?api-version=2025-05-01&$skipToken=10",
  "value": [
    {
      "name": "testRuleCollection",
      "type": "Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityAdminConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection",
      "properties": {
        "description": "A sample rule collection",
        "appliesToGroups": [
          {
            "networkGroupId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/networkGroups/testGroup"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "00000000-0000-0000-0000-000000000000"
      },
      "systemData": {
        "createdAt": "2021-01-11T18:52:27Z",
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
        "createdByType": "User",
        "lastModifiedAt": "2021-01-11T18:52:27Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
        "lastModifiedByType": "User"
      }
    }
  ]
}

Definities

Name	Description
AdminRuleCollection	Hiermee definieert u de beheerregelverzameling.
AdminRuleCollectionListResult	De reactie van een AdminRuleCollection-lijstoperatie.
CommonErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
CommonErrorDetail	De foutdetails.
CommonErrorResponse	Foutreactie
createdByType	Het type identiteit waarmee de resource is gemaakt.
NetworkManagerSecurityGroupItem	Netwerkbeheerder-beveiligingsgroepitem.
ProvisioningState	Inrichtingsstatussen van een resource.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

AdminRuleCollection

Object

Hiermee definieert u de beheerregelverzameling.

Name	Type	Description
etag	string	Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.
id	string	Resource-id.
name	string	Resourcenaam.
properties.appliesToGroups	NetworkManagerSecurityGroupItem[]	Groepen voor configuratie
properties.description	string	Een beschrijving van de beheerregelverzameling.
properties.provisioningState	ProvisioningState	De inrichtingsstatus van de resource.
properties.resourceGuid	string	Unieke id voor deze resource.
systemData	systemData	De systeemmetagegevens die betrekking hebben op deze resource.
type	string	Type bron

AdminRuleCollectionListResult

Object

De reactie van een AdminRuleCollection-lijstoperatie.

Name	Type	Description
nextLink	string (uri)	De koppeling naar de volgende pagina met items
value	AdminRuleCollection[]	De AdminRuleCollection-items op deze pagina

CommonErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info		De aanvullende informatie.
type	string	Het extra informatietype.

CommonErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	CommonErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	CommonErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

CommonErrorResponse

Object

Foutreactie

Name	Type	Description
error	CommonErrorDetail	Het foutobject.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

NetworkManagerSecurityGroupItem

Object

Netwerkbeheerder-beveiligingsgroepitem.

Name	Type	Description
networkGroupId	string	Groeps-id van netwerkbeheerder.

ProvisioningState

Opsomming

Inrichtingsstatussen van een resource.

Waarde	Description
Failed	Mislukt
Succeeded	Geslaagd
Canceled	Geannuleerd
Creating	Creëren
Updating	Bijwerken
Deleting	Verwijderen

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Delen via

Admin Rule Collections - List

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

List security admin rule collections

Voorbeeldaanvraag

Voorbeeldrespons

Definities

AdminRuleCollection

AdminRuleCollectionListResult

CommonErrorAdditionalInfo

CommonErrorDetail

CommonErrorResponse

createdByType

NetworkManagerSecurityGroupItem

ProvisioningState

systemData