Udostępnij za pośrednictwem


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
accessRuleName
path True

string

Nazwa reguły dostępu NSP.

networkSecurityPerimeterName
path True

string

Nazwa obwodu zabezpieczeń sieci.

profileName
path True

string

Nazwa profilu NSP.

resourceGroupName
path True

string

Nazwa grupy zasobów.

subscriptionId
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

AccessRuleDirection

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

SubscriptionId[]

Lista identyfikatorów subskrypcji

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

NspAccessRule

Zaktualizowano — zaktualizowano istniejącą regułę dostępu. Zwraca zasób.

201 Created

NspAccessRule

Create — zwraca utworzony zasób NspAccessRule.

Other Status Codes

CloudError

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
AccessRuleDirection

Kierunek określający, czy reguły dostępu są przychodzące/wychodzące.

CloudError

Odpowiedź błędu z usługi.

CloudErrorBody

Odpowiedź błędu z usługi.

NspAccessRule

Zasób reguły dostępu NSP

nspProvisioningState

Stan aprowizacji zasobu przypisania zakresu.

PerimeterBasedAccessRule
SubscriptionId

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

CloudErrorBody

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

CloudErrorBody[]

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

AccessRuleDirection

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

PerimeterBasedAccessRule[]

Reguła określona przez identyfikator obwodowy.

properties.phoneNumbers

string[]

Format numeru telefonu reguł ruchu wychodzącego.

properties.provisioningState

nspProvisioningState

Stan aprowizacji zasobu przypisania zakresu.

properties.subscriptions

SubscriptionId[]

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.