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 |
|---|---|---|---|---|
|
access
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
De naam van de NSP-toegangsregel. |
|
network
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
De naam van de netwerkbeveiligingsperimeter. |
|
profile
|
path | True |
string maxLength: 80pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$) |
De naam van het NSP-profiel. |
|
resource
|
path | True |
string |
De naam van de resourcegroep. |
|
subscription
|
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 |
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 |
Lijst met abonnements-id's |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
Bijgewerkt: de bestaande toegangsregel wordt bijgewerkt. Retourneert de resource. |
|
| 201 Created |
Maken - Retourneert de NspAccessRule-resource die is gemaakt. |
|
| Other Status Codes |
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 |
|---|---|
|
Access |
Richting die aangeeft of de toegangsregels binnenkomend/uitgaand zijn. |
|
Cloud |
Een foutreactie van de service. |
|
Cloud |
Een foutreactie van de service. |
|
created |
Het type identiteit waarmee de resource is gemaakt. |
|
Nsp |
De NSP-toegangsregelresource |
|
nsp |
De inrichtingsstatus van de resource voor bereiktoewijzing. |
|
Perimeter |
|
|
Subscription |
|
|
system |
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 |
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 |
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 |
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 |
Regel gespecificeerd door de perimeter-ID. |
|
| properties.phoneNumbers |
string[] |
Uitgaande regels in telefoonnummernotatie. Dit type toegangsregel is momenteel niet beschikbaar voor gebruik. |
| properties.provisioningState |
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 |
Lijst met abonnements-id's |
|
| 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 |
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 |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |