Network Security Perimeter Access Rules - Create Or Update

Tjänst:: Network security perimeter

API-version:: 2025-05-01

Skapar eller uppdaterar en regel för nätverksåtkomst.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accessRuleName	path	True	string maxLength: 80 pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)\|(^[a-zA-Z0-9]$)	Namnet på NSP-åtkomstregeln.
networkSecurityPerimeterName	path	True	string maxLength: 80 pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)\|(^[a-zA-Z0-9]$)	Namnet på nätverkssäkerhetsperimetern.
profileName	path	True	string maxLength: 80 pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)\|(^[a-zA-Z0-9]$)	Namnet på NSP-profilen.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.addressPrefixes	string[]	Inkommande adressprefix (IPv4/IPv6)
properties.direction	AccessRuleDirection	Riktning som anger om åtkomstreglerna är inkommande/utgående.
properties.emailAddresses	string[]	Regler för utgående trafik i e-postadressformat. Den här åtkomstregeltypen är för närvarande inte tillgänglig för användning.
properties.fullyQualifiedDomainNames	string[]	Regler för utgående trafik i fullständigt kvalificerat domännamnsformat.
properties.phoneNumbers	string[]	Regler för utgående trafik i telefonnummerformat. Den här åtkomstregeltypen är för närvarande inte tillgänglig för användning.
properties.serviceTags	string[]	Inkommande regler av typen tjänsttagg. Den här åtkomstregeltypen är för närvarande inte tillgänglig för användning.
properties.subscriptions.id	string (arm-id)	Prenumerations-ID i ARM-ID-format.

Svar

Name	Typ	Description
200 OK	NspAccessRule	Resursens 'NspAccessRule'-uppdateringsoperation lyckades
201 Created	NspAccessRule	Resursen 'NspAccessRule' skapade operationen lyckades
Other Status Codes	Common.CloudError	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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

Exempelsvar

Statuskod:: 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"
  }
}

Statuskod:: 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"
  }
}

Definitioner

Name	Description
AccessRuleDirection	Riktning som anger om åtkomstreglerna är inkommande/utgående.
Common.CloudError	Ett felsvar från tjänsten.
Common.CloudErrorBody	Ett felsvar från tjänsten.
CreatedByType	Den typ av identitet som skapade resursen.
NspAccessRule	NSP-åtkomstregelresursen
NspProvisioningState	Det aktuella etableringstillståndet.
SecurityPerimeterSystemData	Metadata som rör skapande och senaste ändring av resursen.

AccessRuleDirection

Uppräkning

Riktning som anger om åtkomstreglerna är inkommande/utgående.

Värde	Description
Inbound	Inkommande
Outbound	Utgående

Common.CloudError

Objekt

Ett felsvar från tjänsten.

Name	Typ	Description
error	Common.CloudErrorBody	Brödtext för molnfel.

Common.CloudErrorBody

Objekt

Ett felsvar från tjänsten.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
details	Common.CloudErrorBody[]	En lista med ytterligare information om felet.
message	string	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.
target	string	Målet för det specifika felet. Till exempel namnet på egenskapen i fel.

CreatedByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User	User
Application	Ansökan
ManagedIdentity	ManagedIdentity
Key	Nyckel

NspAccessRule

Objekt

NSP-åtkomstregelresursen

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Namnet på resursen
properties.addressPrefixes	string[]	Inkommande adressprefix (IPv4/IPv6)
properties.direction	AccessRuleDirection	Riktning som anger om åtkomstreglerna är inkommande/utgående.
properties.emailAddresses	string[]	Regler för utgående trafik i e-postadressformat. Den här åtkomstregeltypen är för närvarande inte tillgänglig för användning.
properties.fullyQualifiedDomainNames	string[]	Regler för utgående trafik i fullständigt kvalificerat domännamnsformat.
properties.networkSecurityPerimeters.id	string (arm-id)	NSP-id i ARM-ID-format.
properties.networkSecurityPerimeters.location	string	Plats för den NSP som levereras.
properties.networkSecurityPerimeters.perimeterGuid	string	Resurs-guid för den NSP som tillhandahålls.
properties.phoneNumbers	string[]	Regler för utgående trafik i telefonnummerformat. Den här åtkomstregeltypen är för närvarande inte tillgänglig för användning.
properties.provisioningState	NspProvisioningState	Etableringstillståndet för omfångstilldelningsresursen.
properties.serviceTags	string[]	Inkommande regler av typen tjänsttagg. Den här åtkomstregeltypen är för närvarande inte tillgänglig för användning.
properties.subscriptions.id	string (arm-id)	Prenumerations-ID i ARM-ID-format.
systemData	SecurityPerimeterSystemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

NspProvisioningState

Uppräkning

Det aktuella etableringstillståndet.

Värde	Description
Succeeded	lyckades
Creating	Skapar
Updating	Uppdatera
Deleting	Tas bort
Accepted	Accepted
Failed	Misslyckades

SecurityPerimeterSystemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	CreatedByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	CreatedByType	Den typ av identitet som senast ändrade resursen.