Security User Rules - List

Szolgáltatás:: Network Manager

API-verzió:: 2025-05-01

Felsorolja a szabálygyűjtemény összes biztonsági felhasználói szabályát.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
configurationName	path	True	string pattern: ^[a-zA-Z0-9_.-]*$	A hálózatkezelő biztonsági konfigurációjának neve.
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	A hálózatkezelő neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
ruleCollectionName	path	True	string pattern: ^[a-zA-Z0-9_.-]*$	A network manager biztonsági konfigurációs szabálygyűjteményének neve.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
$skipToken	query		string	A SkipToken csak akkor használatos, ha egy korábbi művelet részleges eredményt adott vissza. Ha egy előző válasz tartalmaz nextLink elemet, a nextLink elem értéke tartalmaz egy skipToken paramétert, amely megadja a kezdőpontot a későbbi hívásokhoz.
$top	query		integer (int32) minimum: 1 maximum: 20	Választható lekérdezési paraméter, amely meghatározza a kiszolgáló által visszaadandó rekordok maximális számát.

Válaszok

Name	Típus	Description
200 OK	SecurityUserRuleListResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	CloudError	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

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

List security user rules

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules?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 Security User Rules in a rule collection.
 *
 * @summary Lists all Security User Rules in a rule collection.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkManagerSecurityUserRuleList.json
 */
async function listSecurityUserRules() {
  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 ruleCollectionName = "testRuleCollection";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.securityUserRules.list(
    resourceGroupName,
    networkManagerName,
    configurationName,
    ruleCollectionName,
  )) {
    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

Mintaválasz

Állapotkód:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/22222222-2222-2222-2222-222222222222/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules?api-version=2025-05-01&$skipToken=10",
  "value": [
    {
      "name": "SampleUserRule",
      "type": "Microsoft.Network/networkManagers/securityConfigurations/ruleCollections/rules",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkmanagers/testNetworkManager/securityUserConfigurations/myTestSecurityConfig/ruleCollections/testRuleCollection/rules/SampleUserRule",
      "properties": {
        "description": "Sample User Rule",
        "destinationPortRanges": [
          "22"
        ],
        "destinations": [
          {
            "addressPrefix": "*",
            "addressPrefixType": "IPPrefix"
          }
        ],
        "direction": "Inbound",
        "provisioningState": "Succeeded",
        "resourceGuid": "f930553b-f78d-48c5-9445-6cf86b85e615",
        "sourcePortRanges": [
          "0-65535"
        ],
        "sources": [
          {
            "addressPrefix": "*",
            "addressPrefixType": "IPPrefix"
          }
        ],
        "protocol": "Tcp"
      },
      "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"
      }
    }
  ]
}

Definíciók

Name	Description
AddressPrefixItem	Címelőtag elem.
AddressPrefixType	Címelőtag típusa.
CloudError	Hibaválasz a szolgáltatástól.
CloudErrorBody	Hibaválasz a szolgáltatástól.
createdByType	Az erőforrást létrehozó identitás típusa.
ProvisioningState	Erőforrás kiépítési állapotai.
SecurityConfigurationRuleDirection	A szabály iránya. Az irány határozza meg, hogy a szabály kiértékelése a bejövő vagy a kimenő forgalom esetén történik-e.
SecurityConfigurationRuleProtocol	Ez a szabály a hálózati protokollra vonatkozik.
SecurityUserRule	Hálózati biztonsági felhasználói szabály.
SecurityUserRuleListResult	Ez a válasz egy SecurityUserRule lista művelet esetén.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AddressPrefixItem

Tárgy

Címelőtag elem.

Name	Típus	Description
addressPrefix	string	Címelőtag.
addressPrefixType	AddressPrefixType	Címelőtag típusa.

AddressPrefixType

Felsorolás

Címelőtag típusa.

Érték	Description
IPPrefix	IPPrefix
ServiceTag	ServiceTag
NetworkGroup	NetworkGroup

CloudError

Tárgy

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

Name	Típus	Description
error	CloudErrorBody	Felhőhiba törzse.

CloudErrorBody

Tárgy

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.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

ProvisioningState

Felsorolás

Erőforrás kiépítési állapotai.

Érték	Description
Failed	Meghiúsult
Succeeded	Sikerült
Canceled	Érvénytelenített
Creating	Létrehozás
Updating	Frissítés
Deleting	Törlés

SecurityConfigurationRuleDirection

Felsorolás

A szabály iránya. Az irány határozza meg, hogy a szabály kiértékelése a bejövő vagy a kimenő forgalom esetén történik-e.

Érték	Description
Inbound	Bejövő
Outbound	Kimenő

SecurityConfigurationRuleProtocol

Felsorolás

Ez a szabály a hálózati protokollra vonatkozik.

Érték	Description
Tcp	Tcp
Udp	Udp
Icmp	Icmp
Esp	Esp
Any	Bármely
Ah	Ah