Namespaces - Create Or Update Network Rule Set
Vytvořte nebo aktualizujte NetworkRuleSet pro obor názvů.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/networkRuleSets/default?api-version=2024-01-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
Název oboru názvů Vzor regulárního výrazu: |
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného Azure. |
subscription
|
path | True |
string |
Přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného je součástí identifikátoru URI pro každé volání služby. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
Text požadavku
Name | Typ | Description |
---|---|---|
properties.defaultAction |
Výchozí akce pro sadu pravidel sítě |
|
properties.ipRules |
Seznam pravidel IP adres |
|
properties.publicNetworkAccess |
Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená. Pokud je hodnota SecuredByPerimeter, pak příchozí a odchozí komunikace se řídí pravidly přístupu k hraniční síti zabezpečení sítě a profilu. |
|
properties.trustedServiceAccessEnabled |
boolean |
Hodnota označující, jestli je přístup k důvěryhodné službě povolený nebo ne. |
properties.virtualNetworkRules |
Vypsat pravidla virtuální sítě |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Obor názvů NetworkRuleSet se úspěšně vrátil. |
|
Other Status Codes |
Odpověď na chybu ServiceBus popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
NameSpaceNetworkRuleSetCreate
Ukázkový požadavek
PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.EventHub/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2024-01-01
{
"properties": {
"defaultAction": "Deny",
"virtualNetworkRules": [
{
"subnet": {
"id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
},
"ignoreMissingVnetServiceEndpoint": true
},
{
"subnet": {
"id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
},
"ignoreMissingVnetServiceEndpoint": false
},
{
"subnet": {
"id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/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"
}
]
}
}
Ukázková odpověď
{
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/resourcegroupid/providers/Microsoft.EventHub/namespaces/sdk-Namespace-9659/networkruleset/default",
"name": "default",
"type": "Microsoft.EventHub/Namespaces/NetworkRuleSet",
"properties": {
"defaultAction": "Deny",
"virtualNetworkRules": [
{
"subnet": {
"id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
},
"ignoreMissingVnetServiceEndpoint": true
},
{
"subnet": {
"id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
},
"ignoreMissingVnetServiceEndpoint": false
},
{
"subnet": {
"id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/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"
}
]
}
}
Definice
Name | Description |
---|---|
created |
Typ identity, která prostředek vytvořila. |
Default |
Výchozí akce pro sadu pravidel sítě |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď značí, že služba centra událostí nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě. |
Network |
Akce filtru IP adres |
Network |
Popis zdroje témat. |
NWRule |
Odpověď z operace List oboru názvů. |
NWRule |
Odpověď z operace List oboru názvů. |
Public |
Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená. Pokud je hodnota SecuredByPerimeter, pak příchozí a odchozí komunikace se řídí pravidly přístupu k hraniční síti zabezpečení sítě a profilu. |
Subnet |
Vlastnosti zadané pro podsíť |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Výchozí akce pro sadu pravidel sítě
Name | Typ | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď značí, že služba centra událostí nemůže zpracovat příchozí požadavek. Důvod je uvedený v chybové zprávě.
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
NetworkRuleIPAction
Akce filtru IP adres
Name | Typ | Description |
---|---|---|
Allow |
string |
NetworkRuleSet
Popis zdroje témat.
Name | Typ | Default value | Description |
---|---|---|---|
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
|
location |
string |
Geografické umístění, kde se prostředek nachází |
|
name |
string |
Název prostředku |
|
properties.defaultAction |
Výchozí akce pro sadu pravidel sítě |
||
properties.ipRules |
Seznam pravidel IP adres |
||
properties.publicNetworkAccess | Enabled |
Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená. Pokud je hodnota SecuredByPerimeter, pak příchozí a odchozí komunikace se řídí pravidly přístupu k hraniční síti zabezpečení sítě a profilu. |
|
properties.trustedServiceAccessEnabled |
boolean |
Hodnota označující, jestli je přístup k důvěryhodné službě povolený nebo ne. |
|
properties.virtualNetworkRules |
Vypsat pravidla virtuální sítě |
||
systemData |
Metadata systému vztahující se k tomuto prostředku. |
||
type |
string |
Typ prostředku. Například Microsoft.EventHub/Namespaces nebo Microsoft.EventHub/Namespaces |
NWRuleSetIpRules
Odpověď z operace List oboru názvů.
Name | Typ | Description |
---|---|---|
action |
Akce filtru IP adres |
|
ipMask |
string |
Maska IP adresy |
NWRuleSetVirtualNetworkRules
Odpověď z operace List oboru názvů.
Name | Typ | Description |
---|---|---|
ignoreMissingVnetServiceEndpoint |
boolean |
Hodnota označující, jestli se má ignorovat chybějící koncový bod služby virtuální sítě |
subnet |
Vlastnosti podsítě |
PublicNetworkAccessFlag
Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená. Pokud je hodnota SecuredByPerimeter, pak příchozí a odchozí komunikace se řídí pravidly přístupu k hraniční síti zabezpečení sítě a profilu.
Name | Typ | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
SecuredByPerimeter |
string |
Subnet
Vlastnosti zadané pro podsíť
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku podsítě Virtual Network |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Typ identity, která naposledy změnila prostředek. |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |