Namespaces - Create Or Update Network Rule Set
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=2024-01-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
Ad alanı adı Normal ifade deseni: |
resource
|
path | True |
string |
Azure aboneliğindeki kaynak grubunun adı. |
subscription
|
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 |
Ağ Kuralı Kümesi için Varsayılan Eylem |
|
properties.ipRules |
IpRules Listesi |
|
properties.publicNetworkAccess |
Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir. Değer SecuredByPerimeter ise, Gelen ve Giden iletişim ağ güvenlik çevresi ve profilin erişim kuralları tarafından denetlenir. |
|
properties.trustedServiceAccessEnabled |
boolean |
Güvenilen Hizmet Erişiminin Etkin olup olmadığını gösteren değer. |
properties.virtualNetworkRules |
VirtualNetwork Kurallarını Listeleme |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Ad Alanı NetworkRuleSet başarıyla döndürüldü. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan ServiceBus hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow
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
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"
}
]
}
}
Örnek yanıt
{
"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"
}
]
}
}
Tanımlar
Name | Description |
---|---|
created |
Kaynağı oluşturan kimliğin türü. |
Default |
Ağ Kuralı Kümesi için Varsayılan Eylem |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı, Event Hub hizmetinin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir. |
Network |
IP Filtresi Eylemi |
Network |
Konu kaynağının açıklaması. |
NWRule |
Liste ad alanı işleminden gelen yanıt. |
NWRule |
Liste ad alanı işleminden gelen yanıt. |
Public |
Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir. Değer SecuredByPerimeter ise, Gelen ve Giden iletişim ağ güvenlik çevresi ve profilin erişim kuralları tarafından denetlenir. |
Subnet |
Alt ağ için sağlanan özellikler |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
createdByType
Kaynağı oluşturan kimliğin türü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Ağ Kuralı Kümesi için Varsayılan Eylem
Name | Tür | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı, Event Hub hizmetinin gelen isteği işleyemediğini gösterir. Nedeni hata iletisinde verilmiştir.
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
NetworkRuleIPAction
IP Filtresi Eylemi
Name | Tür | Description |
---|---|---|
Allow |
string |
NetworkRuleSet
Konu kaynağının açıklaması.
Name | Tür | Default value | Description |
---|---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
location |
string |
Kaynağın bulunduğu coğrafi konum |
|
name |
string |
Kaynağın adı |
|
properties.defaultAction |
Ağ Kuralı Kümesi için Varsayılan Eylem |
||
properties.ipRules |
IpRules Listesi |
||
properties.publicNetworkAccess | Enabled |
Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir. Değer SecuredByPerimeter ise, Gelen ve Giden iletişim ağ güvenlik çevresi ve profilin erişim kuralları tarafından denetlenir. |
|
properties.trustedServiceAccessEnabled |
boolean |
Güvenilen Hizmet Erişiminin Etkin olup olmadığını gösteren değer. |
|
properties.virtualNetworkRules |
VirtualNetwork Kurallarını Listeleme |
||
systemData |
Bu kaynakla ilgili sistem meta verileri. |
||
type |
string |
Kaynağın türü. Örneğin, "Microsoft.EventHub/Namespaces" veya "Microsoft.EventHub/Namespaces/EventHubs" |
NWRuleSetIpRules
Liste ad alanı işleminden gelen yanıt.
Name | Tür | Description |
---|---|---|
action |
IP Filtresi Eylemi |
|
ipMask |
string |
IP Maskesi |
NWRuleSetVirtualNetworkRules
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 |
Alt ağ özellikleri |
PublicNetworkAccessFlag
Bu, genel ağ üzerinden trafiğe izin verilip verilmediğini belirler. Varsayılan olarak etkindir. Değer SecuredByPerimeter ise, Gelen ve Giden iletişim ağ güvenlik çevresi ve profilin erişim kuralları tarafından denetlenir.
Name | Tür | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
SecuredByPerimeter |
string |
Subnet
Alt ağ için sağlanan özellikler
Name | Tür | Description |
---|---|---|
id |
string |
Sanal Ağ Alt Ağın Kaynak Kimliği |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
Kaynağı en son değiştiren kimliğin türü. |
lastModifiedBy |
string |
Kaynağı son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimliğin türü. |