Share via

Namespaces - Network Rule Set - Create Or Update Network Rule Set

  • Reference
Service:
Service Bus
API Version:
2022-10-01-preview

Vytvořte nebo aktualizujte NetworkRuleSet pro obor názvů.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/networkRuleSets/default?api-version=2022-10-01-preview

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
namespaceName
 path True

string

Název oboru názvů
resourceGroupName
 path True

string

Název skupiny prostředků v rámci předplatného Azure
subscriptionId
 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 klientského rozhraní API

Text požadavku

Name Typ Description
properties.defaultAction

DefaultAction

Výchozí akce pro sadu pravidel sítě
properties.ipRules

NWRuleSetIpRules[]

Seznam pravidel IpRules
properties.publicNetworkAccess

PublicNetworkAccessFlag

Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená.
properties.trustedServiceAccessEnabled

boolean

Hodnota označující, jestli je přístup k důvěryhodné službě povolený nebo ne.
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Výpis pravidel virtuální sítě

Odpovědi

Name Typ Description
200 OK

NetworkRuleSet

Obor názvů NetworkRuleSet se úspěšně vrátil.
Other Status Codes

ErrorResponse

Odpověď na chybu ServiceBus popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

Status code:
200 
{
  "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"
      }
    ]
  }
}

Definice

Name Description
createdByType

Typ identity, která vytvořila prostředek.
DefaultAction

Výchozí akce pro sadu pravidel sítě
Error

Objekt chyby.
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorResponse

Odpověď na chybu správy prostředků
NetworkRuleIPAction

Akce filtru IP adres
NetworkRuleSet

Popis prostředku NetworkRuleSet
NWRuleSetIpRules

Popis prostředku NetWorkRuleSet – IpRules.
NWRuleSetVirtualNetworkRules

Popis prostředku VirtualNetworkRules – NetworkRules
PublicNetworkAccessFlag

Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená.
Subnet

Vlastnosti zadané pro podsíť
systemData

Metadata týkající se vytvoření a poslední změny prostředku

createdByType

Typ identity, která vytvořila prostředek.

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

Error

Objekt chyby.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě
code

string

Kód chyby
details

ErrorResponse[]

Podrobnosti o chybě
message

string

Chybová zpráva
target

string

Cíl chyby.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorResponse

Odpověď na chybu správy prostředků

Name Typ Description
error

Error

Objekt chyby.

NetworkRuleIPAction

Akce filtru IP adres

Name Typ Description
Allow

string

NetworkRuleSet

Popis prostředku NetworkRuleSet

Name Typ Výchozí hodnota Description
id

string

Plně kvalifikované ID prostředku. Příklad – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Geografické umístění, ve kterém se nachází prostředek
name

string

Název prostředku
properties.defaultAction

DefaultAction

Výchozí akce pro sadu pravidel sítě
properties.ipRules

NWRuleSetIpRules[]

Seznam pravidel IpRules
properties.publicNetworkAccess

PublicNetworkAccessFlag

Enabled

Tím se určí, jestli je povolený provoz přes veřejnou síť. Ve výchozím nastavení je povolená.
properties.trustedServiceAccessEnabled

boolean

Hodnota označující, jestli je přístup k důvěryhodné službě povolený nebo ne.
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

Výpis pravidel virtuální sítě
systemData

systemData

Systémová metadata týkající se tohoto prostředku.
type

string

Typ prostředku. Například Microsoft.EventHub/Namespaces nebo Microsoft.EventHub/Namespaces

NWRuleSetIpRules

Popis prostředku NetWorkRuleSet – IpRules.

Name Typ Výchozí hodnota Description
action

NetworkRuleIPAction

Allow

Akce filtru IP adres
ipMask

string

Maska IP adresy

NWRuleSetVirtualNetworkRules

Popis prostředku VirtualNetworkRules – NetworkRules

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

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á.

Name Typ Description
Disabled

string

Enabled

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á prostředek vytvořila.
createdByType

createdByType

Typ identity, která vytvořila prostředek.
lastModifiedAt

string

Typ identity, která naposledy změnila prostředek.
lastModifiedBy

string

Identita, která naposledy změnila prostředek.
lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.