Network Security Perimeter Access Rules - Create Or Update

Service:: Network security perimeter

API-versie:: 2025-05-01

Hiermee maakt of werkt u een regel voor netwerktoegang bij.

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

URI-parameters

Name	In	Vereist	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]$)	De naam van de NSP-toegangsregel.
networkSecurityPerimeterName	path	True	string maxLength: 80 pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)\|(^[a-zA-Z0-9]$)	De naam van de netwerkbeveiligingsperimeter.
profileName	path	True	string maxLength: 80 pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)\|(^[a-zA-Z0-9]$)	De naam van het NSP-profiel.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
properties.addressPrefixes	string[]	Inkomende adresvoorvoegsels (IPv4/IPv6)
properties.direction	AccessRuleDirection	Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn.
properties.emailAddresses	string[]	Uitgaande regels in e-mailadresindeling. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik.
properties.fullyQualifiedDomainNames	string[]	Uitgaande regels in volledig gekwalificeerde domeinnaamindeling.
properties.phoneNumbers	string[]	Uitgaande regels in telefoonnummernotatie. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik.
properties.serviceTags	string[]	Inkomende regels van het type servicetag. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik.
properties.subscriptions.id	string (arm-id)	Abonnements-id in de ARM-id-indeling.

Antwoorden

Name	Type	Description
200 OK	NspAccessRule	De updateoperatie van de bron 'NspAccessRule' is geslaagd
201 Created	NspAccessRule	De aanmaakoperatie van de bron 'NspAccessRule' is geslaagd
Other Status Codes	Common.CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

NspAccessRulePut

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2025-05-01

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

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Creates or updates a network access rule.
 *
 * @summary Creates or updates a network access rule.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NspAccessRulePut.json
 */
async function nspAccessRulePut() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subId";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const networkSecurityPerimeterName = "nsp1";
  const profileName = "profile1";
  const accessRuleName = "accessRule1";
  const parameters = {
    addressPrefixes: ["10.11.0.0/16", "10.10.1.0/24"],
    direction: "Inbound",
  };
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.networkSecurityPerimeterAccessRules.createOrUpdate(
    resourceGroupName,
    networkSecurityPerimeterName,
    profileName,
    accessRuleName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

{
  "name": "accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "properties": {
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "direction": "Inbound",
    "emailAddresses": [],
    "fullyQualifiedDomainNames": [],
    "networkSecurityPerimeters": [],
    "phoneNumbers": [],
    "provisioningState": "Succeeded",
    "serviceTags": [],
    "subscriptions": []
  },
  "systemData": {
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "createdBy": "user",
    "createdByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User"
  }
}

Statuscode:: 201

{
  "name": "accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "properties": {
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "direction": "Inbound",
    "emailAddresses": [],
    "fullyQualifiedDomainNames": [],
    "networkSecurityPerimeters": [],
    "phoneNumbers": [],
    "provisioningState": "Succeeded",
    "serviceTags": [],
    "subscriptions": []
  },
  "systemData": {
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "createdBy": "user",
    "createdByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User"
  }
}

Definities

Name	Description
AccessRuleDirection	Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn.
Common.CloudError	Een foutreactie van de service.
Common.CloudErrorBody	Een foutreactie van de service.
CreatedByType	Het type identiteit waarmee de resource is gemaakt.
NspAccessRule	De NSP-toegangsregelresource
NspProvisioningState	De huidige inrichtingsstatus.
SecurityPerimeterSystemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

AccessRuleDirection

Opsomming

Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn.

Waarde	Description
Inbound	Inkomend Verkeer
Outbound	Vertrekkend

Common.CloudError

Object

Een foutreactie van de service.

Name	Type	Description
error	Common.CloudErrorBody	Wolk fout lichaam.

Common.CloudErrorBody

Object

Een foutreactie van de service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	Common.CloudErrorBody[]	Een lijst met aanvullende details over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

CreatedByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User	Gebruiker
Application	Application
ManagedIdentity	ManagedIdentity
Key	Key

NspAccessRule

Object

De NSP-toegangsregelresource

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties.addressPrefixes	string[]	Inkomende adresvoorvoegsels (IPv4/IPv6)
properties.direction	AccessRuleDirection	Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn.
properties.emailAddresses	string[]	Uitgaande regels in e-mailadresindeling. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik.
properties.fullyQualifiedDomainNames	string[]	Uitgaande regels in volledig gekwalificeerde domeinnaamindeling.
properties.networkSecurityPerimeters.id	string (arm-id)	NSP-id in de ARM-id-indeling.
properties.networkSecurityPerimeters.location	string	Locatie van de geleverde NSP.
properties.networkSecurityPerimeters.perimeterGuid	string	Resource guid van de meegeleverde NSP.
properties.phoneNumbers	string[]	Uitgaande regels in telefoonnummernotatie. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik.
properties.provisioningState	NspProvisioningState	De inrichtingsstatus van de resource voor bereiktoewijzing.
properties.serviceTags	string[]	Inkomende regels van het type servicetag. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik.
properties.subscriptions.id	string (arm-id)	Abonnements-id in de ARM-id-indeling.
systemData	SecurityPerimeterSystemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

NspProvisioningState

Opsomming

De huidige inrichtingsstatus.

Waarde	Description
Succeeded	Geslaagd
Creating	Creëren
Updating	Bijwerken
Deleting	Verwijderen
Accepted	Accepted
Failed	Mislukt

SecurityPerimeterSystemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	CreatedByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	CreatedByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.