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 |
|---|---|---|---|---|
|
access
|
path | True |
string maxLength: 80pattern: (^[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. |
|
network
|
path | True |
string maxLength: 80pattern: (^[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. |
|
profile
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
Nom du profil NSP. |
|
resource
|
path | True |
string |
Nom du groupe de ressources. |
|
subscription
|
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 |
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 |
Liste des ID d’abonnement |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Mise à jour : la règle d’accès existante est mise à jour. Renvoie la ressource. |
|
| 201 Created |
Create : renvoie la ressource NspAccessRule créée. |
|
| Other Status Codes |
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 |
|---|---|
|
Access |
Direction qui spécifie si les règles d’accès sont entrantes/sortantes. |
|
Cloud |
Réponse d’erreur du service. |
|
Cloud |
Réponse d’erreur du service. |
|
created |
Type d’identité qui a créé la ressource. |
|
Nsp |
Ressource de règle d’accès NSP |
|
nsp |
État de provisionnement de la ressource d’attribution d’étendue. |
|
Perimeter |
|
|
Subscription |
|
|
system |
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 |
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 |
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 |
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 |
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 |
É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 |
Liste des ID d’abonnement |
|
| 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 |
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 |
Type d’identité qui a modifié la ressource pour la dernière fois. |