Namespaces - Get Network Rule Set

Dienst:

Relay

API-Version:

2026-01-01

Ruft NetworkRuleSet für einen Namespace ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Relay/namespaces/{namespaceName}/networkRuleSets/default?api-version=2026-01-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
namespaceName	path	True	string minLength: 6 maxLength: 50	Der Namespacename
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	NetworkRuleSet	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

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	Sich als Ihr Benutzerkonto ausgeben

Beispiele

NameSpaceNetworkRuleSetGet

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.Relay/namespaces/example-RelayNamespace-6019/networkRuleSets/default?api-version=2026-01-01

Beispiel für eine Antwort

Statuscode:

200

{
  "name": "default",
  "type": "Microsoft.Relay/Namespaces/NetworkRuleSet",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/resourcegroupid/providers/Microsoft.Relay/namespaces/example-RelayNamespace-9659/networkruleset/default",
  "properties": {
    "defaultAction": "Deny",
    "ipRules": [
      {
        "action": "Allow",
        "ipMask": "1.1.1.1"
      },
      {
        "action": "Allow",
        "ipMask": "1.1.1.2"
      },
      {
        "action": "Allow",
        "ipMask": "1.1.1.3"
      },
      {
        "action": "Allow",
        "ipMask": "1.1.1.4"
      },
      {
        "action": "Allow",
        "ipMask": "1.1.1.5"
      }
    ],
    "trustedServiceAccessEnabled": false
  }
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DefaultAction	Standardaktion für netzwerkregelsatz
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
NetworkRuleIPAction	Die IP-Filteraktion
NetworkRuleSet	Beschreibung der Themenressource.
NWRuleSetIpRules	Die Antwort des Listennamespace-Vorgangs.
PublicNetworkAccess	Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DefaultAction

Enumeration

Standardaktion für netzwerkregelsatz

Wert	Beschreibung
Allow
Deny

ErrorAdditionalInfo

Objekt

Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der Zusatzinformationen.

ErrorDetail

Objekt

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die Zusatzinformationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Der Fehlerzielwert.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

NetworkRuleIPAction

Enumeration

Die IP-Filteraktion

Wert	Beschreibung
Allow

NetworkRuleSet

Objekt

Beschreibung der Themenressource.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.defaultAction	DefaultAction	Standardaktion für netzwerkregelsatz
properties.ipRules	NWRuleSetIpRules[]	Liste der IpRules
properties.publicNetworkAccess	PublicNetworkAccess	Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert.
properties.trustedServiceAccessEnabled	boolean	Wert, der angibt, ob der vertrauenswürdige Dienstzugriff aktiviert ist oder nicht.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

NWRuleSetIpRules

Objekt

Die Antwort des Listennamespace-Vorgangs.

Name	Typ	Beschreibung
action	NetworkRuleIPAction	Die IP-Filteraktion
ipMask	string	IP-Maske

PublicNetworkAccess

Enumeration

Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert.

Wert	Beschreibung
Enabled
Disabled
SecuredByPerimeter

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.