Compartir a través de


Nsp Access Rules - Create Or Update

Crea o actualiza una regla de acceso de red.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accessRuleName
path True

string

Nombre de la regla de acceso de NSP.

networkSecurityPerimeterName
path True

string

Nombre del perímetro de seguridad de red.

profileName
path True

string

Nombre del perfil de NSP.

resourceGroupName
path True

string

Nombre del grupo de recursos.

subscriptionId
path True

string

Las credenciales de suscripción que identifican de forma exclusiva la suscripción a Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.

api-version
query True

string

Versión de API del cliente.

Cuerpo de la solicitud

Nombre Tipo Description
location

string

Ubicación del recurso

name

string

Nombre de la regla de acceso que es única dentro de un perfil. Este nombre se puede usar para acceder al 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[]

Formato de dirección de correo electrónico de las reglas de salida.

properties.fullyQualifiedDomainNames

string[]

Formato de nombre de dominio completo de las reglas de salida.

properties.phoneNumbers

string[]

Formato de número de teléfono de reglas de salida.

properties.subscriptions

SubscriptionId[]

Lista de identificadores de suscripción

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

NspAccessRule

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

201 Created

NspAccessRule

Create: devuelve el recurso NspAccessRule creado.

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de 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 suplantación de su 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=2023-07-01-preview

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

Respuesta de muestra

{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/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": []
  }
}
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/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": []
  }
}

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.

NspAccessRule

Recurso de regla de acceso de NSP

nspProvisioningState

Estado de aprovisionamiento del recurso de asignación de ámbito.

PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

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

Nombre Tipo Description
Inbound

string

Outbound

string

CloudError

Respuesta de error del servicio.

Nombre Tipo Description
error

CloudErrorBody

Cuerpo del error en la 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[]

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.

NspAccessRule

Recurso de regla de acceso de NSP

Nombre Tipo Description
id

string

Identificador de regla de acceso de NSP.

location

string

Ubicación del recurso

name

string

Nombre de la regla de acceso que es única dentro de un perfil. Este nombre se puede usar para acceder al 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[]

Formato de dirección de correo electrónico de las reglas de salida.

properties.fullyQualifiedDomainNames

string[]

Formato de nombre de dominio completo de las reglas de salida.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Regla especificada por el identificador perimetral.

properties.phoneNumbers

string[]

Formato de número de teléfono de reglas de salida.

properties.provisioningState

nspProvisioningState

Estado de aprovisionamiento del recurso de asignación de ámbito.

properties.subscriptions

SubscriptionId[]

Lista de identificadores de suscripción

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

nspProvisioningState

Estado de aprovisionamiento del recurso de asignación de ámbito.

Nombre Tipo Description
Accepted

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

PerimeterBasedAccessRule

Nombre Tipo Description
id

string

Id. de NSP en el formato de id. de ARM.

location

string

Ubicación del NSP proporcionado.

perimeterGuid

string

Guid de recurso del NSP proporcionado.

SubscriptionId

Nombre Tipo Description
id

string

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