Partager via


Nsp Access Rules - Create Or Update

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

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

Paramètres URI

Nom Dans Obligatoire Type Description
accessRuleName
path True

string

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

networkSecurityPerimeterName
path True

string

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

profileName
path True

string

Nom du profil NSP.

resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de façon unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True

string

Version d’API client.

Corps de la demande

Nom Type Description
location

string

Emplacement de la ressource.

name

string

Nom de la règle d’accès unique au sein d’un profil. Ce nom peut être utilisé pour accéder à 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[]

Format d’adresse e-mail des règles de trafic sortant.

properties.fullyQualifiedDomainNames

string[]

Format de nom de domaine complet des règles de trafic sortant.

properties.phoneNumbers

string[]

Format de numéro de téléphone des règles de trafic sortant.

properties.subscriptions

SubscriptionId[]

Liste des ID d’abonnement

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

NspAccessRule

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

201 Created

NspAccessRule

Create : retourne la ressource NspAccessRule créée.

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

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=2023-07-01-preview

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

Exemple de réponse

{
  "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": []
  }
}

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.

NspAccessRule

Ressource de règle d’accès NSP

nspProvisioningState

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

PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

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

Nom Type Description
Inbound

string

Outbound

string

CloudError

Réponse d’erreur du service.

Nom Type Description
error

CloudErrorBody

Corps d’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 programmation.

details

CloudErrorBody[]

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.

NspAccessRule

Ressource de règle d’accès NSP

Nom Type Description
id

string

Identificateur de règle d’accès NSP.

location

string

Emplacement de la ressource.

name

string

Nom de la règle d’accès unique au sein d’un profil. Ce nom peut être utilisé pour accéder à 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[]

Format d’adresse e-mail des règles de trafic sortant.

properties.fullyQualifiedDomainNames

string[]

Format de nom de domaine complet des règles de trafic sortant.

properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

Règle spécifiée par l’ID de périmètre.

properties.phoneNumbers

string[]

Format de numéro de téléphone des règles de trafic sortant.

properties.provisioningState

nspProvisioningState

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

properties.subscriptions

SubscriptionId[]

Liste des ID d’abonnement

tags

object

Balises de ressource.

type

string

Type de ressource.

nspProvisioningState

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

Nom Type Description
Accepted

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

PerimeterBasedAccessRule

Nom Type Description
id

string

ID NSP au format d’ID ARM.

location

string

Emplacement du fournisseur de services réseau fourni.

perimeterGuid

string

Guid de ressource du fournisseur de services réseau fourni.

SubscriptionId

Nom Type Description
id

string

ID d’abonnement au format d’ID ARM.