Namespaces - Create Or Update Network Rule Set
Skapa eller uppdatera NetworkRuleSet för ett namnområde.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/networkRuleSets/default?api-version=2024-01-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
namespace
|
path | True |
string minLength: 6maxLength: 50 pattern: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$ |
Namnområdesnamnet |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen i Azure-prenumerationen. |
|
subscription
|
path | True |
string |
Prenumerationsautentiseringsuppgifter som unikt identifierar en Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
|
api-version
|
query | True |
string |
Klient-API-version. |
Begärandetext
| Name | Typ | Description |
|---|---|---|
| properties.defaultAction |
Standardåtgärd för nätverksregeluppsättning |
|
| properties.ipRules |
Lista över IpRules |
|
| properties.publicNetworkAccess |
Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Om värdet är SecuredByPerimeter styrs inkommande och utgående kommunikation av nätverkssäkerhetsperimetern och profilens åtkomstregler. |
|
| properties.trustedServiceAccessEnabled |
boolean |
Värde som anger om åtkomst till betrodd tjänst är aktiverad eller inte. |
| properties.virtualNetworkRules |
Lista VirtualNetwork-regler |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Namespace NetworkRuleSet returnerades. |
|
| Other Status Codes |
ServiceBus-felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2-flöde
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
NameSpaceNetworkRuleSetCreate
Exempelbegäran
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"
}
]
}
}
Exempelsvar
{
"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"
}
]
}
}
Definitioner
| Name | Description |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Default |
Standardåtgärd för nätverksregeluppsättning |
|
Error |
Ytterligare information om resurshanteringsfelet. |
|
Error |
Felinformationen. |
|
Error |
Felsvaret anger att Event Hub-tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet. |
|
Network |
IP-filteråtgärden |
|
Network |
Beskrivning av ämnesresurs. |
|
NWRule |
Svaret från listnamnområdesåtgärden. |
|
NWRule |
Svaret från listnamnområdesåtgärden. |
|
Public |
Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Om värdet är SecuredByPerimeter styrs inkommande och utgående kommunikation av nätverkssäkerhetsperimetern och profilens åtkomstregler. |
| Subnet |
Egenskaper som anges för undernätet |
|
system |
Metadata som rör skapande och senaste ändring av resursen. |
createdByType
Den typ av identitet som skapade resursen.
| Värde | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DefaultAction
Standardåtgärd för nätverksregeluppsättning
| Värde | Description |
|---|---|
| Allow | |
| Deny |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
| Name | Typ | Description |
|---|---|---|
| info |
object |
Ytterligare information. |
| type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Ytterligare information om felet. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvaret anger att Event Hub-tjänsten inte kan bearbeta den inkommande begäran. Orsaken anges i felmeddelandet.
| Name | Typ | Description |
|---|---|---|
| error |
Felobjektet. |
NetworkRuleIPAction
IP-filteråtgärden
| Värde | Description |
|---|---|
| Allow |
NetworkRuleSet
Beskrivning av ämnesresurs.
| Name | Typ | Standardvärde | Description |
|---|---|---|---|
| id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
| location |
string |
Den geo-plats där resursen finns |
|
| name |
string |
Namnet på resursen |
|
| properties.defaultAction |
Standardåtgärd för nätverksregeluppsättning |
||
| properties.ipRules |
Lista över IpRules |
||
| properties.publicNetworkAccess | Enabled |
Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Om värdet är SecuredByPerimeter styrs inkommande och utgående kommunikation av nätverkssäkerhetsperimetern och profilens åtkomstregler. |
|
| properties.trustedServiceAccessEnabled |
boolean |
Värde som anger om åtkomst till betrodd tjänst är aktiverad eller inte. |
|
| properties.virtualNetworkRules |
Lista VirtualNetwork-regler |
||
| systemData |
Systemmetadata som är relaterade till den här resursen. |
||
| type |
string |
Resurstypen. Till exempel "Microsoft.EventHub/Namespaces" eller "Microsoft.EventHub/Namespaces/EventHubs" |
NWRuleSetIpRules
Svaret från listnamnområdesåtgärden.
| Name | Typ | Description |
|---|---|---|
| action |
IP-filteråtgärden |
|
| ipMask |
string |
IP-mask |
NWRuleSetVirtualNetworkRules
Svaret från listnamnområdesåtgärden.
| Name | Typ | Description |
|---|---|---|
| ignoreMissingVnetServiceEndpoint |
boolean |
Värde som anger om Vnet-tjänstslutpunkten ska ignoreras |
| subnet |
Undernätsegenskaper |
PublicNetworkAccessFlag
Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Om värdet är SecuredByPerimeter styrs inkommande och utgående kommunikation av nätverkssäkerhetsperimetern och profilens åtkomstregler.
| Värde | Description |
|---|---|
| Enabled | |
| Disabled | |
| SecuredByPerimeter |
Subnet
Egenskaper som anges för undernätet
| Name | Typ | Description |
|---|---|---|
| id |
string |
Resurs-ID för undernät för virtuellt nätverk |
systemData
Metadata som rör skapande och senaste ändring av resursen.
| Name | Typ | Description |
|---|---|---|
| createdAt |
string (date-time) |
Tidsstämpeln för resursskapande (UTC). |
| createdBy |
string |
Identiteten som skapade resursen. |
| createdByType |
Den typ av identitet som skapade resursen. |
|
| lastModifiedAt |
string (date-time) |
Den typ av identitet som senast ändrade resursen. |
| lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
| lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |