Namespaces - Network Rule Set - Create Or Update Network Rule Set
Erstellen oder aktualisieren Sie NetworkRuleSet für einen Namespace.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/networkRuleSets/default?api-version=2022-10-01-preview
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
namespace
|
path | True |
string |
Der Namespacename |
resource
|
path | True |
string |
Name der Ressourcengruppe innerhalb des Azure-Abonnements. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die ein 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 |
---|---|---|
properties.defaultAction |
Standardaktion für Den Netzwerkregelsatz |
|
properties.ipRules |
Liste der IpRules |
|
properties.publicNetworkAccess |
Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. |
|
properties.trustedServiceAccessEnabled |
boolean |
Wert, der angibt, ob der vertrauenswürdige Dienstzugriff aktiviert ist oder nicht. |
properties.virtualNetworkRules |
Auflisten von VirtualNetwork-Regeln |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Namespace NetworkRuleSet wurde erfolgreich zurückgegeben. |
|
Other Status Codes |
ServiceBus-Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
NameSpaceNetworkRuleSetCreate
Sample Request
PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2022-10-01-preview
{
"properties": {
"defaultAction": "Deny",
"virtualNetworkRules": [
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
},
"ignoreMissingVnetServiceEndpoint": true
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
},
"ignoreMissingVnetServiceEndpoint": false
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
},
"ignoreMissingVnetServiceEndpoint": false
}
],
"ipRules": [
{
"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",
"action": "Allow"
}
]
}
}
Sample Response
{
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-AustraliaEast/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-9659/networkruleset/default",
"name": "default",
"type": "Microsoft.ServiceBus/Namespaces/NetworkRuleSet",
"properties": {
"defaultAction": "Deny",
"publicNetworkAccess": "Enabled",
"virtualNetworkRules": [
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
},
"ignoreMissingVnetServiceEndpoint": true
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
},
"ignoreMissingVnetServiceEndpoint": false
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
},
"ignoreMissingVnetServiceEndpoint": false
}
],
"ipRules": [
{
"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",
"action": "Allow"
}
]
}
}
Definitionen
Name | Beschreibung |
---|---|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Default |
Standardaktion für Den Netzwerkregelsatz |
Error |
Das Fehlerobjekt. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerantwort für die Ressourcenverwaltung. |
Network |
Die IP-Filteraktion |
Network |
Beschreibung der NetworkRuleSet-Ressource. |
NWRule |
Beschreibung der NetWorkRuleSet -IpRules-Ressource. |
NWRule |
Beschreibung der VirtualNetworkRules -NetworkRules-Ressource. |
Public |
Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. |
Subnet |
Für Subnetz bereitgestellte Eigenschaften |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Standardaktion für Den Netzwerkregelsatz
Name | Typ | Beschreibung |
---|---|---|
Allow |
string |
|
Deny |
string |
Error
Das Fehlerobjekt.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorResponse
Die Fehlerantwort für die Ressourcenverwaltung.
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
NetworkRuleIPAction
Die IP-Filteraktion
Name | Typ | Beschreibung |
---|---|---|
Allow |
string |
NetworkRuleSet
Beschreibung der NetworkRuleSet-Ressource.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
|
name |
string |
Der Name der Ressource |
|
properties.defaultAction |
Standardaktion für Den Netzwerkregelsatz |
||
properties.ipRules |
Liste der IpRules |
||
properties.publicNetworkAccess | Enabled |
Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. |
|
properties.trustedServiceAccessEnabled |
boolean |
Wert, der angibt, ob der vertrauenswürdige Dienstzugriff aktiviert ist oder nicht. |
|
properties.virtualNetworkRules |
Auflisten von VirtualNetwork-Regeln |
||
systemData |
Die Systemmetadaten, die sich auf diese Ressource beziehen. |
||
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.EventHub/Namespaces" oder "Microsoft.EventHub/Namespaces/EventHubs" |
NWRuleSetIpRules
Beschreibung der NetWorkRuleSet -IpRules-Ressource.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
action | Allow |
Die IP-Filteraktion |
|
ipMask |
string |
IP-Maske |
NWRuleSetVirtualNetworkRules
Beschreibung der VirtualNetworkRules -NetworkRules-Ressource.
Name | Typ | Beschreibung |
---|---|---|
ignoreMissingVnetServiceEndpoint |
boolean |
Wert, der angibt, ob fehlender VNET-Dienstendpunkt ignoriert werden soll |
subnet |
Subnetzeigenschaften |
PublicNetworkAccessFlag
Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnet
Für Subnetz bereitgestellte Eigenschaften
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID Virtual Network Subnetzes |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |