Security User Rules - List

Служба:: Network Manager

Версия API:: 2025-05-01

Список всех правил пользователей безопасности в коллекции правил.

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

С использованием необязательных параметров:

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

Имя	В	Обязательно	Тип	Описание
configurationName	path	True	string pattern: ^[a-zA-Z0-9_.-]*$	Имя конфигурации безопасности диспетчера сети.
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Имя сетевого диспетчера.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
ruleCollectionName	path	True	string pattern: ^[a-zA-Z0-9_.-]*$	Имя коллекции правил конфигурации безопасности диспетчера сети.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
$skipToken	query		string	SkipToken используется только в том случае, если предыдущая операция вернула частичный результат. Если предыдущий ответ содержит элемент nextLink, значение элемента nextLink будет включать параметр skipToken, указывающий начальную точку для последующих вызовов.
$top	query		integer (int32) minimum: 1 maximum: 20	Необязательный параметр запроса, указывающий максимальное количество записей, возвращаемых сервером.

Ответы

Имя	Тип	Описание
200 OK	SecurityUserRuleListResult	Операция Azure успешно завершена.
Other Status Codes	CloudError	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

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

Пример ответа

Код состояния:: 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"
      }
    }
  ]
}

Определения

Имя	Описание
AddressPrefixItem	Элемент префикса адреса.
AddressPrefixType	Тип префикса адреса.
CloudError	Ответ об ошибке от сервиса.
CloudErrorBody	Ответ об ошибке от сервиса.
createdByType	Тип удостоверения, создавшего ресурс.
ProvisioningState	Инициализация состояний ресурса.
SecurityConfigurationRuleDirection	Направление правила. Направление указывает, будет ли правило оцениваться для входящего или исходящего трафика.
SecurityConfigurationRuleProtocol	К этому правилу применяется сетевой протокол.
SecurityUserRule	Правило пользователя безопасности сети.
SecurityUserRuleListResult	Ответ на операцию списка SecurityUserRule.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

AddressPrefixItem

Объект

Элемент префикса адреса.

Имя	Тип	Описание
addressPrefix	string	Префикс адреса.
addressPrefixType	AddressPrefixType	Тип префикса адреса.

AddressPrefixType

Перечисление

Тип префикса адреса.

Значение	Описание
IPPrefix	IPPrefix
ServiceTag	ServiceTag
NetworkGroup	NetworkGroup

CloudError

Объект

Ответ об ошибке от сервиса.

Имя	Тип	Описание
error	CloudErrorBody	Тело ошибки облака.

CloudErrorBody

Объект

Ответ об ошибке от сервиса.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ProvisioningState

Перечисление

Инициализация состояний ресурса.

Значение	Описание
Failed	Неудача
Succeeded	Succeeded
Canceled	Отменено
Creating	Создавать
Updating	Обновление
Deleting	Удаление

SecurityConfigurationRuleDirection

Перечисление

Направление правила. Направление указывает, будет ли правило оцениваться для входящего или исходящего трафика.

Значение	Описание
Inbound	Входящий трафик
Outbound	исходящий

SecurityConfigurationRuleProtocol

Перечисление

К этому правилу применяется сетевой протокол.

Значение	Описание
Tcp	Протокол TCP
Udp	Udp
Icmp	ICMP
Esp	Особенно
Any	Любое
Ah	Ах