Compartir a través de


Network Security Perimeter Access Rules - Create Or Update

Crea o actualiza una regla de acceso a la red.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2025-03-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accessRuleName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

Nombre de la regla de acceso de NSP.

networkSecurityPerimeterName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

Nombre del perímetro de seguridad de red.

profileName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

Nombre del perfil de NSP.

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Credenciales de suscripción que identifican de forma única la 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 de cliente.

Cuerpo de la solicitud

Nombre Tipo Description
properties.addressPrefixes

string[]

Prefijos de dirección de entrada (IPv4/IPv6)

properties.direction

AccessRuleDirection

Dirección que especifica si las reglas de acceso son entrantes o salientes.

properties.emailAddresses

string[]

Reglas de salida en formato de dirección de correo electrónico. Este tipo de regla de acceso no está disponible actualmente para su uso.

properties.fullyQualifiedDomainNames

string[]

Reglas de salida en formato de nombre de dominio completo.

properties.phoneNumbers

string[]

Reglas de salida en formato de número de teléfono. Este tipo de regla de acceso no está disponible actualmente para su uso.

properties.serviceTags

string[]

Reglas de entrada de tipo etiqueta de servicio. Este tipo de regla de acceso no está disponible actualmente para su uso.

properties.subscriptions

SubscriptionId[]

Lista de identificadores de suscripción

Respuestas

Nombre Tipo Description
200 OK

NspAccessRule

Actualizado: se actualiza la regla de acceso existente. Devuelve el recurso.

201 Created

NspAccessRule

Crear: devuelve el recurso NspAccessRule creado.

Other Status Codes

CloudError

Respuesta de error que describe por qué falló la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

NspAccessRulePut

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2025-03-01

{
  "properties": {
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ]
  }
}

Respuesta de muestra

{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": [],
    "serviceTags": []
  },
  "systemData": {
    "createdBy": "user",
    "createdByType": "User",
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
  }
}
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": [],
    "serviceTags": []
  },
  "systemData": {
    "createdBy": "user",
    "createdByType": "User",
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
  }
}

Definiciones

Nombre Description
AccessRuleDirection

Dirección que especifica si las reglas de acceso son entrantes o salientes.

CloudError

Respuesta de error del servicio.

CloudErrorBody

Respuesta de error del servicio.

createdByType

Tipo de identidad que creó el recurso.

NspAccessRule

El recurso de regla de acceso de NSP

nspProvisioningState

El estado de aprovisionamiento del recurso de asignación de ámbito.

PerimeterBasedAccessRule
SubscriptionId
systemData

Metadatos relativos a la creación y última modificación del recurso.

AccessRuleDirection

Dirección que especifica si las reglas de acceso son entrantes o salientes.

Valor Description
Inbound
Outbound

CloudError

Respuesta de error del servicio.

Nombre Tipo Description
error

CloudErrorBody

Cuerpo de error de nube.

CloudErrorBody

Respuesta de error del servicio.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

CloudErrorBody[]

Una lista de detalles adicionales sobre el error.

message

string

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

target

string

Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

createdByType

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

NspAccessRule

El recurso de regla de acceso de NSP

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nombre del recurso

properties.addressPrefixes

string[]

Prefijos de dirección de entrada (IPv4/IPv6)

properties.direction

AccessRuleDirection

Dirección que especifica si las reglas de acceso son entrantes o salientes.

properties.emailAddresses

string[]

Reglas de salida en formato de dirección de correo electrónico. Este tipo de regla de acceso no está disponible actualmente para su uso.

properties.fullyQualifiedDomainNames

string[]

Reglas de salida en formato de nombre de dominio completo.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Regla especificada por el identificador de perímetro.

properties.phoneNumbers

string[]

Reglas de salida en formato de número de teléfono. Este tipo de regla de acceso no está disponible actualmente para su uso.

properties.provisioningState

nspProvisioningState

El estado de aprovisionamiento del recurso de asignación de ámbito.

properties.serviceTags

string[]

Reglas de entrada de tipo etiqueta de servicio. Este tipo de regla de acceso no está disponible actualmente para su uso.

properties.subscriptions

SubscriptionId[]

Lista de identificadores de suscripción

systemData

systemData

Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

nspProvisioningState

El estado de aprovisionamiento del recurso de asignación de ámbito.

Valor Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed

PerimeterBasedAccessRule

Nombre Tipo Description
id

string (arm-id)

NSP id en el formato de ID de ARM.

location

string

Ubicación del NSP suministrado.

perimeterGuid

string

Se proporciona el guid de recursos del NSP.

SubscriptionId

Nombre Tipo Description
id

string (arm-id)

Identificador de suscripción en el formato de identificador de ARM.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.