Namespaces - Create Or Update Network Rule Set
Hozzon létre vagy frissítse a NetworkRuleSet elemet egy névtérhez.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/networkRuleSets/default?api-version=2024-01-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
A névtér neve Reguláris kifejezési minta: |
resource
|
path | True |
string |
Az azure-előfizetésen belüli erőforráscsoport neve. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
properties.defaultAction |
Hálózati szabálykészlet alapértelmezett művelete |
|
properties.ipRules |
IpRules-rekordok listája |
|
properties.publicNetworkAccess |
Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. Ha az érték SecuredByPerimeter, akkor a bejövő és kimenő kommunikációt a hálózati biztonsági szegélyhálózat és a profil hozzáférési szabályai vezérlik. |
|
properties.trustedServiceAccessEnabled |
boolean |
Érték, amely azt jelzi, hogy a Megbízható szolgáltatás elérése engedélyezve van-e. |
properties.virtualNetworkRules |
VirtualNetwork-szabályok listázása |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A NetworkRuleSet névtér sikeresen visszaadva. |
|
Other Status Codes |
ServiceBus-hibaválasz, amely leírja, hogy miért hiúsult meg a művelet. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
NameSpaceNetworkRuleSetCreate
Mintakérelem
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"
}
]
}
}
Mintaválasz
{
"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"
}
]
}
}
Definíciók
Name | Description |
---|---|
created |
Az erőforrást létrehozó identitás típusa. |
Default |
Hálózati szabálykészlet alapértelmezett művelete |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
A hibaválasz azt jelzi, hogy az Event Hub szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg. |
Network |
Az IP-szűrési művelet |
Network |
A témakör erőforrásának leírása. |
NWRule |
A Lista névtér művelet válasza. |
NWRule |
A Lista névtér művelet válasza. |
Public |
Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. Ha az érték SecuredByPerimeter, akkor a bejövő és kimenő kommunikációt a hálózati biztonsági szegélyhálózat és a profil hozzáférési szabályai vezérlik. |
Subnet |
Az alhálózathoz megadott tulajdonságok |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Hálózati szabálykészlet alapértelmezett művelete
Name | Típus | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további adattípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hiba célja. |
ErrorResponse
A hibaválasz azt jelzi, hogy az Event Hub szolgáltatás nem tudja feldolgozni a bejövő kérést. Ennek okát a hibaüzenet adja meg.
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
NetworkRuleIPAction
Az IP-szűrési művelet
Name | Típus | Description |
---|---|---|
Allow |
string |
NetworkRuleSet
A témakör erőforrásának leírása.
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
location |
string |
A földrajzi hely, ahol az erőforrás él |
|
name |
string |
Az erőforrás neve |
|
properties.defaultAction |
Hálózati szabálykészlet alapértelmezett művelete |
||
properties.ipRules |
IpRules-rekordok listája |
||
properties.publicNetworkAccess | Enabled |
Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. Ha az érték SecuredByPerimeter, akkor a bejövő és kimenő kommunikációt a hálózati biztonsági szegélyhálózat és a profil hozzáférési szabályai vezérlik. |
|
properties.trustedServiceAccessEnabled |
boolean |
Érték, amely azt jelzi, hogy a Megbízható szolgáltatás elérése engedélyezve van-e. |
|
properties.virtualNetworkRules |
VirtualNetwork-szabályok listázása |
||
systemData |
Az erőforráshoz kapcsolódó rendszer metaadatai. |
||
type |
string |
Az erőforrás típusa. Pl. "Microsoft.EventHub/Namespaces" vagy "Microsoft.EventHub/Namespaces/EventHubs" |
NWRuleSetIpRules
A Lista névtér művelet válasza.
Name | Típus | Description |
---|---|---|
action |
Az IP-szűrési művelet |
|
ipMask |
string |
IP-maszk |
NWRuleSetVirtualNetworkRules
A Lista névtér művelet válasza.
Name | Típus | Description |
---|---|---|
ignoreMissingVnetServiceEndpoint |
boolean |
Érték, amely azt jelzi, hogy figyelmen kívül hagyja-e a hiányzó virtuális hálózati szolgáltatásvégpontot |
subnet |
Alhálózat tulajdonságai |
PublicNetworkAccessFlag
Ez határozza meg, hogy a forgalom engedélyezett-e a nyilvános hálózaton keresztül. Alapértelmezés szerint engedélyezve van. Ha az érték SecuredByPerimeter, akkor a bejövő és kimenő kommunikációt a hálózati biztonsági szegélyhálózat és a profil hozzáférési szabályai vezérlik.
Name | Típus | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
SecuredByPerimeter |
string |
Subnet
Az alhálózathoz megadott tulajdonságok
Name | Típus | Description |
---|---|---|
id |
string |
Virtual Network alhálózat erőforrás-azonosítója |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrást legutóbb módosító identitás típusa. |
lastModifiedBy |
string |
Az erőforrást utoljára módosító identitás. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |