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 |
|---|---|---|---|---|
|
access
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
Nombre de la regla de acceso de NSP. |
|
network
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
Nombre del perímetro de seguridad de red. |
|
profile
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
Nombre del perfil de NSP. |
|
resource
|
path | True |
string |
Nombre del grupo de recursos. |
|
subscription
|
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 |
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 |
Lista de identificadores de suscripción |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Actualizado: se actualiza la regla de acceso existente. Devuelve el recurso. |
|
| 201 Created |
Crear: devuelve el recurso NspAccessRule creado. |
|
| Other Status Codes |
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 |
|---|---|
|
Access |
Dirección que especifica si las reglas de acceso son entrantes o salientes. |
|
Cloud |
Respuesta de error del servicio. |
|
Cloud |
Respuesta de error del servicio. |
|
created |
Tipo de identidad que creó el recurso. |
|
Nsp |
El recurso de regla de acceso de NSP |
|
nsp |
El estado de aprovisionamiento del recurso de asignación de ámbito. |
|
Perimeter |
|
|
Subscription |
|
|
system |
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 |
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 |
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 |
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 |
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 |
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 |
Lista de identificadores de suscripción |
|
| 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 |
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 |
Tipo de identidad que modificó por última vez el recurso. |