Nsp Access Rules - Create Or Update
Tworzy lub aktualizuje regułę dostępu do sieci.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2023-07-01-preview
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
access
|
path | True |
string |
Nazwa reguły dostępu NSP. |
network
|
path | True |
string |
Nazwa obwodu zabezpieczeń sieci. |
profile
|
path | True |
string |
Nazwa profilu NSP. |
resource
|
path | True |
string |
Nazwa grupy zasobów. |
subscription
|
path | True |
string |
Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa reguły dostępu, która jest unikatowa w profilu. Ta nazwa może służyć do uzyskiwania dostępu do zasobu. |
properties.addressPrefixes |
string[] |
Prefiksy adresów przychodzących (IPv4/IPv6) |
properties.direction |
Kierunek określający, czy reguły dostępu są przychodzące/wychodzące. |
|
properties.emailAddresses |
string[] |
Format adresu e-mail reguł ruchu wychodzącego. |
properties.fullyQualifiedDomainNames |
string[] |
Reguły ruchu wychodzącego w pełni kwalifikowany format nazwy domeny. |
properties.phoneNumbers |
string[] |
Format numeru telefonu reguł ruchu wychodzącego. |
properties.subscriptions |
Lista identyfikatorów subskrypcji |
|
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Zaktualizowano — zaktualizowano istniejącą regułę dostępu. Zwraca zasób. |
|
201 Created |
Create — zwraca utworzony zasób NspAccessRule. |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
NspAccessRulePut
Przykładowe żądanie
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"
]
}
}
Przykładowa odpowiedź
{
"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": []
}
}
Definicje
Nazwa | Opis |
---|---|
Access |
Kierunek określający, czy reguły dostępu są przychodzące/wychodzące. |
Cloud |
Odpowiedź błędu z usługi. |
Cloud |
Odpowiedź błędu z usługi. |
Nsp |
Zasób reguły dostępu NSP |
nsp |
Stan aprowizacji zasobu przypisania zakresu. |
Perimeter |
|
Subscription |
AccessRuleDirection
Kierunek określający, czy reguły dostępu są przychodzące/wychodzące.
Nazwa | Typ | Opis |
---|---|---|
Inbound |
string |
|
Outbound |
string |
CloudError
Odpowiedź błędu z usługi.
Nazwa | Typ | Opis |
---|---|---|
error |
Treść błędu chmury. |
CloudErrorBody
Odpowiedź błędu z usługi.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Identyfikator błędu. Kody są niezmienne i mają być używane programowo. |
details |
Lista dodatkowych szczegółów dotyczących błędu. |
|
message |
string |
Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
target |
string |
Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie. |
NspAccessRule
Zasób reguły dostępu NSP
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator reguły dostępu NSP. |
location |
string |
Lokalizacja zasobu. |
name |
string |
Nazwa reguły dostępu, która jest unikatowa w profilu. Ta nazwa może służyć do uzyskiwania dostępu do zasobu. |
properties.addressPrefixes |
string[] |
Prefiksy adresów przychodzących (IPv4/IPv6) |
properties.direction |
Kierunek określający, czy reguły dostępu są przychodzące/wychodzące. |
|
properties.emailAddresses |
string[] |
Format adresu e-mail reguł ruchu wychodzącego. |
properties.fullyQualifiedDomainNames |
string[] |
Reguły ruchu wychodzącego w pełni kwalifikowany format nazwy domeny. |
properties.networkSecurityPerimeters |
Reguła określona przez identyfikator obwodowy. |
|
properties.phoneNumbers |
string[] |
Format numeru telefonu reguł ruchu wychodzącego. |
properties.provisioningState |
Stan aprowizacji zasobu przypisania zakresu. |
|
properties.subscriptions |
Lista identyfikatorów subskrypcji |
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. |
nspProvisioningState
Stan aprowizacji zasobu przypisania zakresu.
Nazwa | Typ | Opis |
---|---|---|
Accepted |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
PerimeterBasedAccessRule
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator NSP w formacie identyfikatora usługi ARM. |
location |
string |
Lokalizacja dostarczonego dostawcy NSP. |
perimeterGuid |
string |
Identyfikator GUID zasobu dostarczonego przez dostawcę NSP. |
SubscriptionId
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator subskrypcji w formacie identyfikatora usługi ARM. |