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

Vytvoří nebo aktualizuje NetworkRuleSet pro obor názvů.

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

Parametry identifikátoru URI

Name In Required Type 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 tvoří část identifikátoru URI pro každé volání služby.

api-version
query True
  • string

Verze rozhraní API klienta

Text požadavku

Name Type Description
properties.defaultAction

Výchozí akce pro sadu síťových pravidel

properties.ipRules

Seznam IpRules

properties.trustedServiceAccessEnabled
  • boolean

Hodnota, která označuje, zda je povolen přístup k důvěryhodné službě.

properties.virtualNetworkRules

Vypsat VirtualNetwork pravidla

Odpovědi

Name Type Description
200 OK

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

Other Status Codes

ServiceBus chybovou odpověď popisující, proč se operace nezdařila.

Zabezpečení

azure_auth

Azure Active Directory tok 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.EventHub/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2021-01-01-preview
{
  "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"
      }
    ]
  }
}

Sample Response

{
  "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

createdByType

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

DefaultAction

Výchozí akce pro sadu síťových pravidel

ErrorResponse

Chybová odezva indikuje, že služba centra událostí nemůže zpracovat příchozí požadavek. Důvod je uveden v chybové zprávě.

NetworkRuleIPAction

Akce filtru IP

NetworkRuleSet

Popis prostředku tématu

NWRuleSetIpRules

Odpověď z operace seznamu oborů názvů.

NWRuleSetVirtualNetworkRules

Odpověď z operace seznamu oborů názvů.

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 Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DefaultAction

Výchozí akce pro sadu síťových pravidel

Name Type Description
Allow
  • string
Deny
  • string

ErrorResponse

Chybová odezva indikuje, že služba centra událostí nemůže zpracovat příchozí požadavek. Důvod je uveden v chybové zprávě.

Name Type Description
code
  • string

Kód chyby

message
  • string

Chybová zpráva indikující, proč se operace nezdařila.

NetworkRuleIPAction

Akce filtru IP

Name Type Description
Allow
  • string

NetworkRuleSet

Popis prostředku tématu

Name Type Description
id
  • string

ID prostředku

name
  • string

Název prostředku

properties.defaultAction

Výchozí akce pro sadu síťových pravidel

properties.ipRules

Seznam IpRules

properties.trustedServiceAccessEnabled
  • boolean

Hodnota, která označuje, zda je povolen přístup k důvěryhodné službě.

properties.virtualNetworkRules

Vypsat VirtualNetwork pravidla

systemData

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

type
  • string

Typ prostředku.

NWRuleSetIpRules

Odpověď z operace seznamu oborů názvů.

Name Type Description
action

Akce filtru IP

ipMask
  • string

Maska IP

NWRuleSetVirtualNetworkRules

Odpověď z operace seznamu oborů názvů.

Name Type Description
ignoreMissingVnetServiceEndpoint
  • boolean

Hodnota, která označuje, jestli se má ignorovat chybějící koncový bod služby virtuální sítě

subnet

Vlastnosti podsítě

Subnet

Vlastnosti zadané pro podsíť

Name Type Description
id
  • string

ID prostředku Virtual Network podsítě

systemData

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

Name Type Description
createdAt
  • string

Časové razítko vytvoření prostředku (UTC).

createdBy
  • string

Identita, která vytvořila prostředek.

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

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