Namespaces - Create Or Update Network Rule Set
Utwórz lub zaktualizuj element NetworkRuleSet dla przestrzeni nazw.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/networkRuleSets/default?api-version=2024-01-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
namespace
|
path | True |
string |
Nazwa przestrzeni nazw Wzorzec wyrażenia regularnego: |
resource
|
path | True |
string |
Nazwa grupy zasobów w ramach subskrypcji platformy Azure. |
subscription
|
path | True |
string |
Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Treść żądania
Nazwa | Typ | Opis |
---|---|---|
properties.defaultAction |
Domyślna akcja dla zestawu reguł sieciowych |
|
properties.ipRules |
Lista adresów IpRules |
|
properties.publicNetworkAccess |
Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Jeśli wartość to SecuredByPerimeter, komunikacja ruchu przychodzącego i wychodzącego jest kontrolowana przez obwód zabezpieczeń sieci i reguły dostępu profilu. |
|
properties.trustedServiceAccessEnabled |
boolean |
Wartość wskazująca, czy dostęp do zaufanej usługi jest włączony, czy nie. |
properties.virtualNetworkRules |
Wyświetlanie listy reguł sieci wirtualnej |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Przestrzeń nazw NetworkRuleSet została pomyślnie zwrócona. |
|
Other Status Codes |
Odpowiedź błędu usługi ServiceBus opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
NameSpaceNetworkRuleSetCreate
Przykładowe żądanie
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"
}
]
}
}
Przykładowa odpowiedź
{
"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"
}
]
}
}
Definicje
Nazwa | Opis |
---|---|
created |
Typ tożsamości, która utworzyła zasób. |
Default |
Domyślna akcja dla zestawu reguł sieciowych |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd wskazuje, że usługa Event Hub nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie. |
Network |
Akcja filtru IP |
Network |
Opis zasobu tematu. |
NWRule |
Odpowiedź z operacji listy przestrzeni nazw. |
NWRule |
Odpowiedź z operacji listy przestrzeni nazw. |
Public |
Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Jeśli wartość to SecuredByPerimeter, komunikacja ruchu przychodzącego i wychodzącego jest kontrolowana przez obwód zabezpieczeń sieci i reguły dostępu profilu. |
Subnet |
Właściwości podane dla podsieci |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
Domyślna akcja dla zestawu reguł sieciowych
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
|
Deny |
string |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd wskazuje, że usługa Event Hub nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
NetworkRuleIPAction
Akcja filtru IP
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
NetworkRuleSet
Opis zasobu tematu.
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
|
name |
string |
Nazwa zasobu |
|
properties.defaultAction |
Domyślna akcja dla zestawu reguł sieciowych |
||
properties.ipRules |
Lista adresów IpRules |
||
properties.publicNetworkAccess | Enabled |
Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Jeśli wartość to SecuredByPerimeter, komunikacja ruchu przychodzącego i wychodzącego jest kontrolowana przez obwód zabezpieczeń sieci i reguły dostępu profilu. |
|
properties.trustedServiceAccessEnabled |
boolean |
Wartość wskazująca, czy dostęp do zaufanej usługi jest włączony, czy nie. |
|
properties.virtualNetworkRules |
Wyświetlanie listy reguł sieci wirtualnej |
||
systemData |
Dane metadane systemowe odnoszące się do tego zasobu. |
||
type |
string |
Typ zasobu. Np. "Microsoft.EventHub/Namespaces" lub "Microsoft.EventHub/Namespaces/EventHubs" |
NWRuleSetIpRules
Odpowiedź z operacji listy przestrzeni nazw.
Nazwa | Typ | Opis |
---|---|---|
action |
Akcja filtru IP |
|
ipMask |
string |
Maska adresów IP |
NWRuleSetVirtualNetworkRules
Odpowiedź z operacji listy przestrzeni nazw.
Nazwa | Typ | Opis |
---|---|---|
ignoreMissingVnetServiceEndpoint |
boolean |
Wartość wskazująca, czy ignorować brakujący punkt końcowy usługi sieci wirtualnej |
subnet |
Właściwości podsieci |
PublicNetworkAccessFlag
Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Jeśli wartość to SecuredByPerimeter, komunikacja ruchu przychodzącego i wychodzącego jest kontrolowana przez obwód zabezpieczeń sieci i reguły dostępu profilu.
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
|
Enabled |
string |
|
SecuredByPerimeter |
string |
Subnet
Właściwości podane dla podsieci
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu podsieci Virtual Network |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobu (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |