Network Rule Sets - Create Or Update Network Rule Set

Hizmet:: Event Hubs

API Sürümü:: 2021-11-01

Ad Alanı için NetworkRuleSet oluşturun veya güncelleştirin.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
namespaceName	path	True	string minLength: 6 maxLength: 50 pattern: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$	Ad Alanı adı
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Azure aboneliğindeki kaynak grubunun adı.
subscriptionId	path	True	string	Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.
api-version	query	True	string	İstemci API Sürümü.

İstek Gövdesi

Name	Tür	Description
properties.defaultAction	DefaultAction	Ağ Kuralı Kümesi için Varsayılan Eylem
properties.ipRules	NWRuleSetIpRules[]	IpRules Listesi
properties.publicNetworkAccess	PublicNetworkAccessFlag	Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir.
properties.trustedServiceAccessEnabled	boolean	Güvenilen Hizmet Erişiminin Etkin olup olmadığını gösteren değer.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]	VirtualNetwork Kurallarını Listeleme

Yanıtlar

Name	Tür	Description
200 OK	NetworkRuleSet	Ad Alanı NetworkRuleSet başarıyla döndürüldü.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan ServiceBus hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

NameSpaceNetworkRuleSetCreate

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.EventHub/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2021-11-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"
      }
    ]
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "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",
    "publicNetworkAccess": "Enabled",
    "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"
      }
    ]
  }
}

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
DefaultAction	Ağ Kuralı Kümesi için Varsayılan Eylem
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı, Olay Hub'ı hizmetinin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde sağlanır.
NetworkRuleIPAction	IP Filtresi Eylemi
NetworkRuleSet	Konu kaynağının açıklaması.
NWRuleSetIpRules	Liste ad alanı işleminden gelen yanıt.
NWRuleSetVirtualNetworkRules	Liste ad alanı işleminden gelen yanıt.
PublicNetworkAccessFlag	Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir.
Subnet	Alt Ağ için sağlanan özellikler
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

createdByType

Listeleme

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DefaultAction

Listeleme

Ağ Kuralı Kümesi için Varsayılan Eylem

Değer	Description
Allow
Deny

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı, Olay Hub'ı hizmetinin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde sağlanır.

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

NetworkRuleIPAction

Listeleme

IP Filtresi Eylemi

Değer	Description
Allow

NetworkRuleSet

Object

Konu kaynağının açıklaması.

Name	Tür	Default value	Description
id	string		Kaynağın tam kaynak kimliği. Örn - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		Kaynağın bulunduğu coğrafi konum
name	string		Kaynağın adı
properties.defaultAction	DefaultAction		Ağ Kuralı Kümesi için Varsayılan Eylem
properties.ipRules	NWRuleSetIpRules[]		IpRules Listesi
properties.publicNetworkAccess	PublicNetworkAccessFlag	Enabled	Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir.
properties.trustedServiceAccessEnabled	boolean		Güvenilen Hizmet Erişiminin Etkin olup olmadığını gösteren değer.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]		VirtualNetwork Kurallarını Listeleme
systemData	systemData		Bu kaynakla ilgili sistem meta verileri.
type	string		Kaynağın türü. Örneğin, "Microsoft.EventHub/Namespaces" veya "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

Object

Liste ad alanı işleminden gelen yanıt.

Name	Tür	Description
action	NetworkRuleIPAction	IP Filtresi Eylemi
ipMask	string	IP Maskesi

NWRuleSetVirtualNetworkRules

Object

Liste ad alanı işleminden gelen yanıt.

Name	Tür	Description
ignoreMissingVnetServiceEndpoint	boolean	Eksik sanal ağ hizmet uç noktasının yoksayılıp yoksayılmayacağını gösteren değer
subnet	Subnet	Alt ağ özellikleri

PublicNetworkAccessFlag

Listeleme

Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir.

Değer	Description
Enabled
Disabled

Subnet

Object

Alt Ağ için sağlanan özellikler

Name	Tür	Description
id	string	Sanal Ağ Alt Ağının Kaynak Kimliği

systemData

Object

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağı en son değiştiren kimlik türü.
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Network Rule Sets - Create Or Update Network Rule Set

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

NameSpaceNetworkRuleSetCreate

Örnek isteği

Örnek yanıt

Tanımlar

createdByType

DefaultAction

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NetworkRuleIPAction

NetworkRuleSet

NWRuleSetIpRules

NWRuleSetVirtualNetworkRules

PublicNetworkAccessFlag

Subnet

systemData