Partager via


Network Security Perimeter Access Rules - Create Or Update

Crée ou met à jour une règle d’accès au réseau.

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

Paramètres URI

Nom Dans Obligatoire Type Description
accessRuleName
path True

string

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

Nom de la règle d’accès NSP.

networkSecurityPerimeterName
path True

string

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

Nom du périmètre de sécurité réseau.

profileName
path True

string

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

Nom du profil NSP.

resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification de l’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.

api-version
query True

string

Version de l’API client.

Corps de la demande

Nom Type Description
properties.addressPrefixes

string[]

Préfixes d’adresses entrantes (IPv4/IPv6)

properties.direction

AccessRuleDirection

Direction qui spécifie si les règles d’accès sont entrantes/sortantes.

properties.emailAddresses

string[]

Règles de trafic sortant au format d’adresse e-mail. Ce type de règle d’accès n’est actuellement pas disponible pour une utilisation.

properties.fullyQualifiedDomainNames

string[]

Règles de trafic sortant au format de nom de domaine complet.

properties.phoneNumbers

string[]

Règles de trafic sortant au format numéro de téléphone. Ce type de règle d’accès n’est actuellement pas disponible pour une utilisation.

properties.serviceTags

string[]

Règles de trafic entrant de type balise de service. Ce type de règle d’accès n’est actuellement pas disponible pour une utilisation.

properties.subscriptions

SubscriptionId[]

Liste des ID d’abonnement

Réponses

Nom Type Description
200 OK

NspAccessRule

Mise à jour : la règle d’accès existante est mise à jour. Renvoie la ressource.

201 Created

NspAccessRule

Create : renvoie la ressource NspAccessRule créée.

Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

NspAccessRulePut

Exemple de requête

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"
    ]
  }
}

Exemple de réponse

{
  "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"
  }
}

Définitions

Nom Description
AccessRuleDirection

Direction qui spécifie si les règles d’accès sont entrantes/sortantes.

CloudError

Réponse d’erreur du service.

CloudErrorBody

Réponse d’erreur du service.

createdByType

Type d’identité qui a créé la ressource.

NspAccessRule

Ressource de règle d’accès NSP

nspProvisioningState

État de provisionnement de la ressource d’attribution d’étendue.

PerimeterBasedAccessRule
SubscriptionId
systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

AccessRuleDirection

Direction qui spécifie si les règles d’accès sont entrantes/sortantes.

Valeur Description
Inbound
Outbound

CloudError

Réponse d’erreur du service.

Nom Type Description
error

CloudErrorBody

Corps de l’erreur Cloud.

CloudErrorBody

Réponse d’erreur du service.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.

details

CloudErrorBody[]

Une liste de détails supplémentaires sur l’erreur.

message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.

target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

NspAccessRule

Ressource de règle d’accès NSP

Nom Type Description
id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

name

string

Nom de la ressource

properties.addressPrefixes

string[]

Préfixes d’adresses entrantes (IPv4/IPv6)

properties.direction

AccessRuleDirection

Direction qui spécifie si les règles d’accès sont entrantes/sortantes.

properties.emailAddresses

string[]

Règles de trafic sortant au format d’adresse e-mail. Ce type de règle d’accès n’est actuellement pas disponible pour une utilisation.

properties.fullyQualifiedDomainNames

string[]

Règles de trafic sortant au format de nom de domaine complet.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Règle spécifiée par l’identifiant du périmètre.

properties.phoneNumbers

string[]

Règles de trafic sortant au format numéro de téléphone. Ce type de règle d’accès n’est actuellement pas disponible pour une utilisation.

properties.provisioningState

nspProvisioningState

État de provisionnement de la ressource d’attribution d’étendue.

properties.serviceTags

string[]

Règles de trafic entrant de type balise de service. Ce type de règle d’accès n’est actuellement pas disponible pour une utilisation.

properties.subscriptions

SubscriptionId[]

Liste des ID d’abonnement

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

nspProvisioningState

État de provisionnement de la ressource d’attribution d’étendue.

Valeur Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed

PerimeterBasedAccessRule

Nom Type Description
id

string (arm-id)

Identifiant NSP au format ID ARM.

location

string

Emplacement du NSP fourni.

perimeterGuid

string

Guide de ressource du NSP fourni.

SubscriptionId

Nom Type Description
id

string (arm-id)

ID d’abonnement au format d’ID ARM.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.