Network Security Perimeter Configurations - List

Servicio:: Event Grid

Versión de la API:: 2025-04-01-preview

Obtenga todas las configuraciones perimetrales de seguridad de red para el recurso.
Obtenga todas las configuraciones perimetrales de seguridad de red asociadas a un tema o dominio.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/{resourceType}/{resourceName}/networkSecurityPerimeterConfigurations?api-version=2025-04-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción del usuario.
resourceName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-zA-Z0-9-]*$	Nombre del recurso (es decir, el nombre del tema o el nombre de dominio).
resourceType	path	True	NetworkSecurityPerimeterResourceType	Tipo de recurso. Puede ser "temas" o "dominios".
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI de cada llamada de servicio.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	NetworkSecurityPerimeterConfigurationList	De acuerdo
Other Status Codes	ErrorResponse	Respuesta de error devuelta si la solicitud no se realizó correctamente.

Ejemplos

NetworkSecurityPerimeterConfigurations_List

GET https://management.azure.com/subscriptions/8f6b6269-84f2-4d09-9e31-1127efcd1e40/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampleResourceName/networkSecurityPerimeterConfigurations?api-version=2025-04-01-preview

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.EventGrid;

// Generated from example definition: specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2025-04-01-preview/examples/NetworkSecurityPerimeterConfigurations_List.json
// this example is just showing the usage of "NetworkSecurityPerimeterConfigurations_List" 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 EventGridTopicResource created on azure
// for more information of creating EventGridTopicResource, please refer to the document of EventGridTopicResource
string subscriptionId = "8f6b6269-84f2-4d09-9e31-1127efcd1e40";
string resourceGroupName = "examplerg";
string resourceName = "exampleResourceName";
ResourceIdentifier eventGridTopicResourceId = EventGridTopicResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceName);
EventGridTopicResource eventGridTopic = client.GetEventGridTopicResource(eventGridTopicResourceId);

// get the collection of this TopicNetworkSecurityPerimeterConfigurationResource
TopicNetworkSecurityPerimeterConfigurationCollection collection = eventGridTopic.GetTopicNetworkSecurityPerimeterConfigurations();

// invoke the operation and iterate over the result
await foreach (NetworkSecurityPerimeterConfigurationData item in collection.GetAllAsync())
{
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {item.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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "properties": {
        "provisioningState": "Succeeded",
        "networkSecurityPerimeter": {
          "id": "/subscriptions/8f6b6269-84f2-4d09-9e31-1127efcd1e40/resourceGroups/perimeterrg/providers/Microsoft.Network/networkSecurityPerimeters/somePerimeter",
          "perimeterGuid": "8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter",
          "location": "West US"
        },
        "resourceAssociation": {
          "name": "someAssociation",
          "accessMode": "Enforced"
        },
        "profile": {
          "name": "someProfile",
          "accessRulesVersion": "1",
          "accessRules": [
            {
              "name": "ipRule",
              "properties": {
                "direction": "Inbound",
                "addressPrefixes": [
                  "148.0.0.0/8"
                ]
              }
            }
          ],
          "diagnosticSettingsVersion": "1",
          "enabledLogCategories": [
            "NspOutbound"
          ]
        }
      },
      "id": "/subscriptions//resourceGroups/paasrg/providers/Microsoft.EventGrid/topics/egtopic/networkSecurityPerimeterConfigurations/8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter.someAssociation",
      "name": "8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter.someAssociation",
      "type": "Microsoft.EventGrid/topics/networkSecurityPerimeterConfigurations"
    }
  ]
}

Definiciones

Nombre	Description
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
NetworkSecurityPerimeterAssociationAccessMode	Modo de acceso perimetral de seguridad de red.
NetworkSecurityPerimeterConfigProvisioningState	Estado de aprovisionamiento para reflejar el estado de configuración e indicar el estado de recuperación de la configuración del perfil nsp.
NetworkSecurityPerimeterConfiguration	Configuración del perímetro de seguridad de red.
NetworkSecurityPerimeterConfigurationIssues	Problemas de configuración del perímetro de seguridad de red.
NetworkSecurityPerimeterConfigurationIssueSeverity	Gravedad del problema de aprovisionamiento.
NetworkSecurityPerimeterConfigurationIssueType	Tipo de problema de aprovisionamiento.
NetworkSecurityPerimeterConfigurationList	Lista de configuración perimetral de seguridad de red.
NetworkSecurityPerimeterConfigurationProfile	Configuración de Nsp con información de perfil.
NetworkSecurityPerimeterInfo	Información del perímetro de seguridad de red.
NetworkSecurityPerimeterProfileAccessRule	Regla de acceso de perfil perimetral de seguridad de red.
NetworkSecurityPerimeterProfileAccessRuleDirection	Dirección de la regla de acceso de NSP.
NetworkSecurityPerimeterResourceType	Tipo de recurso. Puede ser "temas" o "dominios".
NetworkSecurityPerimeterSubscription	Regla de acceso entrante de la suscripción perimetral de seguridad de red.
ResourceAssociation	Asociación de recursos Nsp

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

NetworkSecurityPerimeterAssociationAccessMode

Enumeración

Modo de acceso perimetral de seguridad de red.

Valor	Description
Audit
Enforced
Learning

NetworkSecurityPerimeterConfigProvisioningState

Enumeración

Estado de aprovisionamiento para reflejar el estado de configuración e indicar el estado de recuperación de la configuración del perfil nsp.

Valor	Description
Accepted
Canceled
Creating
Deleted
Deleting
Failed
Succeeded
Updating

NetworkSecurityPerimeterConfiguration

Object

Configuración del perímetro de seguridad de red.

Nombre	Tipo	Description
id	string	Identificador completo del recurso.
name	string	Nombre del recurso.
properties.networkSecurityPerimeter	NetworkSecurityPerimeterInfo	Información del perímetro para la asociación nsp.
properties.profile	NetworkSecurityPerimeterConfigurationProfile	Configuración del perfil Nsp, reglas de acceso y configuración de diagnóstico.
properties.provisioningIssues	NetworkSecurityPerimeterConfigurationIssues[]	Problemas de aprovisionamiento para reflejar el estado al intentar recuperar la configuración del perfil nsp.
properties.provisioningState	NetworkSecurityPerimeterConfigProvisioningState	Estado de aprovisionamiento para reflejar el estado de configuración e indicar el estado de recuperación de la configuración del perfil nsp.
properties.resourceAssociation	ResourceAssociation	Nombre de asociación Nsp y modo de acceso de asociación.
type	string	Tipo del recurso.

NetworkSecurityPerimeterConfigurationIssues

Object

Problemas de configuración del perímetro de seguridad de red.

Nombre	Tipo	Description
name	string	Nombre del problema de aprovisionamiento.
properties.description	string	Descripción del problema de aprovisionamiento.
properties.issueType	NetworkSecurityPerimeterConfigurationIssueType	Tipo de problema de aprovisionamiento.
properties.severity	NetworkSecurityPerimeterConfigurationIssueSeverity	Gravedad del problema de aprovisionamiento.
properties.suggestedAccessRules	string[]	Reglas de acceso que se pueden agregar al mismo perfil para corregir el problema.
properties.suggestedResourceIds	string[]	Identificadores de ARM de recursos que se pueden asociar al mismo perímetro para corregir el problema.

NetworkSecurityPerimeterConfigurationIssueSeverity

Enumeración

Gravedad del problema de aprovisionamiento.

Valor	Description
Error
Warning

NetworkSecurityPerimeterConfigurationIssueType

Enumeración

Tipo de problema de aprovisionamiento.

Valor	Description
ConfigurationPropagationFailure
MissingIdentityConfiguration
MissingPerimeterConfiguration
Other

NetworkSecurityPerimeterConfigurationList

Object

Lista de configuración perimetral de seguridad de red.

Nombre	Tipo	Description
nextLink	string	Vínculo a la página siguiente de Configuración perimetral de seguridad de red.
value	NetworkSecurityPerimeterConfiguration[]	Lista de todas las configuraciones de parámetros de seguridad de red.

NetworkSecurityPerimeterConfigurationProfile

Object

Configuración de Nsp con información de perfil.

Nombre	Tipo	Description
accessRules	NetworkSecurityPerimeterProfileAccessRule[]	Lista de la configuración de reglas de acceso entrante o saliente en el perfil de nsp.
accessRulesVersion	string	Número de versión de las reglas de acceso para el perfil de nsp.
diagnosticSettingsVersion	string	Número de versión de configuración de diagnóstico para el perfil nsp.
enabledLogCategories	string[]	Categorías de registro habilitadas para el perfil nsp.
name	string	Nombre del perfil de configuración de Nsp.

NetworkSecurityPerimeterInfo

Object

Información del perímetro de seguridad de red.

Nombre	Tipo	Description
id	string	Id. de arm para el perímetro de seguridad de red.
location	string	Ubicación perimetral de seguridad de red.
perimeterGuid	string	Guid perimetral de seguridad de red.

NetworkSecurityPerimeterProfileAccessRule

Object

Regla de acceso de perfil perimetral de seguridad de red.

Nombre	Tipo	Description
fullyQualifiedArmId	string	Id. de arm completo para la regla de acceso de perfil perimetral de seguridad de red.
name	string	Nombre de la regla de acceso nsp.
properties.addressPrefixes	string[]	Prefijos de dirección.
properties.direction	NetworkSecurityPerimeterProfileAccessRuleDirection	Dirección de la regla de acceso de NSP.
properties.emailAddresses	string[]	Lista de direcciones de correo electrónico.
properties.fullyQualifiedDomainNames	string[]	Nombres de dominio completos.
properties.networkSecurityPerimeters	NetworkSecurityPerimeterInfo[]	Perímetros de seguridad de red.
properties.phoneNumbers	string[]	Lista de números de teléfono.
properties.subscriptions	NetworkSecurityPerimeterSubscription[]	Lista de suscripciones.
type	string	Tipo de regla de acceso nsp.

NetworkSecurityPerimeterProfileAccessRuleDirection

Enumeración

Dirección de la regla de acceso de NSP.

Valor	Description
Inbound
Outbound

NetworkSecurityPerimeterResourceType

Enumeración

Tipo de recurso. Puede ser "temas" o "dominios".

Valor	Description
domains
topics

NetworkSecurityPerimeterSubscription

Object

Regla de acceso entrante de la suscripción perimetral de seguridad de red.

Nombre	Tipo	Description
id	string	Identificador de suscripción.

ResourceAssociation

Object

Asociación de recursos Nsp

Nombre	Tipo	Description
accessMode	NetworkSecurityPerimeterAssociationAccessMode	Modo de acceso perimetral de seguridad de red.
name	string	Nombre de asociación

Compartir a través de

Network Security Perimeter Configurations - List

Parámetros de identificador URI

Respuestas

Ejemplos

NetworkSecurityPerimeterConfigurations_List

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NetworkSecurityPerimeterAssociationAccessMode

NetworkSecurityPerimeterConfigProvisioningState

NetworkSecurityPerimeterConfiguration

NetworkSecurityPerimeterConfigurationIssues

NetworkSecurityPerimeterConfigurationIssueSeverity

NetworkSecurityPerimeterConfigurationIssueType

NetworkSecurityPerimeterConfigurationList

NetworkSecurityPerimeterConfigurationProfile

NetworkSecurityPerimeterInfo

NetworkSecurityPerimeterProfileAccessRule

NetworkSecurityPerimeterProfileAccessRuleDirection

NetworkSecurityPerimeterResourceType

NetworkSecurityPerimeterSubscription

ResourceAssociation