Nsp Access Rules - Create Or Update

Referenz

Dienst:: Network Manager

API-Version:: 2023-07-01-preview

Erstellt oder aktualisiert eine Netzwerkzugriffsregel.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accessRuleName	path	True	string	Der Name der NSP-Zugriffsregel.
networkSecurityPerimeterName	path	True	string	Der Name des Netzwerksicherheitsperimeters.
profileName	path	True	string	Der Name des NSP-Profils.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string	Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Typ	Beschreibung
location	string	Ressourcenspeicherort
name	string	Der Name der Zugriffsregel, die innerhalb eines Profils eindeutig ist. Dieser Name kann für den Zugriff auf die Ressource verwendet werden.
properties.addressPrefixes	string[]	Präfixe für eingehende Adressen (IPv4/IPv6)
properties.direction	AccessRuleDirection	Richtung, die angibt, ob die Zugriffsregeln ein-/ausgehend sind.
properties.emailAddresses	string[]	E-Mail-Adressformat für ausgehende Regeln.
properties.fullyQualifiedDomainNames	string[]	Vollqualifiziertes Domänennamenformat für ausgehende Regeln.
properties.phoneNumbers	string[]	Telefonnummernformat für ausgehende Regeln.
properties.subscriptions	SubscriptionId[]	Liste der Abonnement-IDs
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	NspAccessRule	Aktualisiert: Die vorhandene Zugriffsregel wird aktualisiert. Gibt die Ressource zurück.
201 Created	NspAccessRule	Erstellen: Gibt die erstellte NspAccessRule-Ressource zurück.
Other Status Codes	CloudError	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

NspAccessRulePut

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "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": []
  }
}

Statuscode:: 201

{
  "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": []
  }
}

Definitionen

Name	Beschreibung
AccessRuleDirection	Richtung, die angibt, ob die Zugriffsregeln ein-/ausgehend sind.
CloudError	Eine Fehlerantwort vom Dienst.
CloudErrorBody	Eine Fehlerantwort vom Dienst.
NspAccessRule	Die NSP-Zugriffsregelressource
nspProvisioningState	Der Bereitstellungsstatus der Bereichszuweisungsressource.
PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

Richtung, die angibt, ob die Zugriffsregeln ein-/ausgehend sind.

Name	Typ	Beschreibung
Inbound	string
Outbound	string

CloudError

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
error	CloudErrorBody	Cloudfehlertext.

CloudErrorBody