Security User Rules - List

Služba:: Network Manager

Verze rozhraní API:: 2025-05-01

Zobrazí seznam všech uživatelských pravidel zabezpečení v kolekci pravidel.

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

S volitelnými parametry:

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}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
configurationName	path	True	string pattern: ^[a-zA-Z0-9_.-]*$	Název konfigurace zabezpečení správce sítě.
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Název správce sítě.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
ruleCollectionName	path	True	string pattern: ^[a-zA-Z0-9_.-]*$	Název kolekce pravidel konfigurace zabezpečení správce sítě.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
$skipToken	query		string	SkipToken se používá pouze v případě, že předchozí operace vrátila částečný výsledek. Pokud předchozí odpověď obsahuje nextLink element, hodnota nextLink elementu bude obsahovat skipToken parametr, který určuje výchozí bod, který se má použít pro následné volání.
$top	query		integer (int32) minimum: 1 maximum: 20	Volitelný parametr dotazu, který určuje maximální počet záznamů, které má server vrátit.

Odpovědi

Name	Typ	Description
200 OK	SecurityUserRuleListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

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

Ukázková odpověď

Stavový kó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"
      }
    }
  ]
}

Definice

Name	Description
AddressPrefixItem	Položka předpony adresy
AddressPrefixType	Typ předpony adresy.
CloudError	Chybová odpověď ze služby.
CloudErrorBody	Chybová odpověď ze služby.
createdByType	Typ identity, která prostředek vytvořila.
ProvisioningState	Zřizování stavů zdroje.
SecurityConfigurationRuleDirection	Směr pravidla. Směr určuje, zda bude pravidlo vyhodnoceno při příchozí nebo odchozí komunikaci.
SecurityConfigurationRuleProtocol	Síťový protokol, na který se toto pravidlo vztahuje.
SecurityUserRule	Pravidlo uživatele zabezpečení sítě
SecurityUserRuleListResult	Odpověď operace seznamu SecurityUserRule.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

AddressPrefixItem

Objekt

Položka předpony adresy

Name	Typ	Description
addressPrefix	string	Předpona adresy.
addressPrefixType	AddressPrefixType	Typ předpony adresy.

AddressPrefixType

Výčet

Typ předpony adresy.

Hodnota	Description
IPPrefix	IPPrefix
ServiceTag	ServiceTag
NetworkGroup	NetworkGroup

CloudError

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
error	CloudErrorBody	Tělo chyby cloudu.

CloudErrorBody

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
details	CloudErrorBody[]	Seznam dalších podrobností o chybě.
message	string	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target	string	Cíl konkrétní chyby. Například název vlastnosti v chybě.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ProvisioningState

Výčet

Zřizování stavů zdroje.

Hodnota	Description
Failed	Nezdařilo se
Succeeded	Úspěch
Canceled	Zrušeno
Creating	Vytváření
Updating	Aktualizace
Deleting	Odstranit

SecurityConfigurationRuleDirection

Výčet

Směr pravidla. Směr určuje, zda bude pravidlo vyhodnoceno při příchozí nebo odchozí komunikaci.

Hodnota	Description
Inbound	Příchozí
Outbound	Odchozí

SecurityConfigurationRuleProtocol

Výčet

Síťový protokol, na který se toto pravidlo vztahuje.

Hodnota	Description
Tcp	Protokol tcp
Udp	Protokol udp
Icmp	Icmp
Esp	Esp
Any	Jakýkoliv
Ah	Ach