Delen via


Network Security Perimeter Access Rules - Create Or Update

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-03-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

De naam van de resourcegroep.

subscriptionId
path True

string

De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

api-version
query True

string

Client-API-versie.

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

SubscriptionId[]

Lijst met abonnements-id's

Antwoorden

Name Type Description
200 OK

NspAccessRule

Bijgewerkt: de bestaande toegangsregel wordt bijgewerkt. Retourneert de resource.

201 Created

NspAccessRule

Maken - Retourneert de NspAccessRule-resource die is gemaakt.

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
AccessRuleDirection

Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn.

CloudError

Een foutreactie van de service.

CloudErrorBody

Een foutreactie van de service.

createdByType

Het type identiteit waarmee de resource is gemaakt.

NspAccessRule

De NSP-toegangsregelresource

nspProvisioningState

De inrichtingsstatus van de resource voor bereiktoewijzing.

PerimeterBasedAccessRule
SubscriptionId
systemData

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

AccessRuleDirection

Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn.

Waarde Description
Inbound
Outbound

CloudError

Een foutreactie van de service.

Name Type Description
error

CloudErrorBody

Wolk fout lichaam.

CloudErrorBody

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

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

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

NspAccessRule

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

PerimeterBasedAccessRule[]

Regel gespecificeerd door de perimeter-ID.

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

SubscriptionId[]

Lijst met abonnements-id's

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

type

string

Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

nspProvisioningState

De inrichtingsstatus van de resource voor bereiktoewijzing.

Waarde Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed

PerimeterBasedAccessRule

Name Type Description
id

string (arm-id)

NSP-id in de ARM-id-indeling.

location

string

Locatie van de geleverde NSP.

perimeterGuid

string

Resource guid van de meegeleverde NSP.

SubscriptionId

Name Type Description
id

string (arm-id)

Abonnements-id in de ARM-id-indeling.

systemData

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.