你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Namespaces - Network Rule Set - Create Or Update Network Rule Set
为Namespace创建或更新 NetworkRuleSet。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/networkRuleSets/default?api-version=2023-01-01-preview
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
namespace
|
path | True |
string |
命名空间名称 |
resource
|
path | True |
string |
Azure 订阅中的资源组的名称。 |
subscription
|
path | True |
string |
唯一标识Microsoft Azure 订阅的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
properties.defaultAction |
网络规则集的默认操作 |
|
properties.ipRules |
IpRules 列表 |
|
properties.publicNetworkAccess |
这决定了是否允许通过公用网络流量。 默认情况下,它处于启用状态。 |
|
properties.trustedServiceAccessEnabled |
boolean |
指示是否启用受信任的服务访问的值。 |
properties.virtualNetworkRules |
列出 VirtualNetwork 规则 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
Namespace NetworkRuleSet 已成功返回。 |
|
Other Status Codes |
描述操作失败的原因的 ServiceBus 错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
NameSpaceNetworkRuleSetCreate
示例请求
PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2023-01-01-preview
{
"properties": {
"defaultAction": "Deny",
"virtualNetworkRules": [
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
},
"ignoreMissingVnetServiceEndpoint": true
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
},
"ignoreMissingVnetServiceEndpoint": false
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/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"
}
]
}
}
示例响应
{
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-AustraliaEast/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-9659/networkruleset/default",
"name": "default",
"type": "Microsoft.ServiceBus/Namespaces/NetworkRuleSet",
"properties": {
"defaultAction": "Deny",
"publicNetworkAccess": "Enabled",
"virtualNetworkRules": [
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
},
"ignoreMissingVnetServiceEndpoint": true
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
},
"ignoreMissingVnetServiceEndpoint": false
},
{
"subnet": {
"id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/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"
}
]
}
}
定义
名称 | 说明 |
---|---|
created |
创建资源的标识的类型。 |
Default |
网络规则集的默认操作 |
Error |
错误对象。 |
Error |
资源管理错误附加信息。 |
Error |
资源管理错误响应。 |
Network |
IP 筛选器操作 |
Network |
NetworkRuleSet 资源的说明。 |
NWRule |
NetWorkRuleSet - IpRules 资源的说明。 |
NWRule |
VirtualNetworkRules - NetworkRules 资源的说明。 |
Public |
这决定了是否允许通过公用网络流量。 默认情况下,它处于启用状态。 |
Subnet |
为子网提供的属性 |
system |
与创建和上次修改资源相关的元数据。 |
createdByType
创建资源的标识的类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DefaultAction
网络规则集的默认操作
名称 | 类型 | 说明 |
---|---|---|
Allow |
string |
|
Deny |
string |
Error
错误对象。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorResponse
资源管理错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
NetworkRuleIPAction
IP 筛选器操作
名称 | 类型 | 说明 |
---|---|---|
Allow |
string |
NetworkRuleSet
NetworkRuleSet 资源的说明。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
id |
string |
资源的完全限定资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
|
location |
string |
资源所在的地理位置 |
|
name |
string |
资源的名称 |
|
properties.defaultAction |
网络规则集的默认操作 |
||
properties.ipRules |
IpRules 列表 |
||
properties.publicNetworkAccess | Enabled |
这决定了是否允许通过公用网络流量。 默认情况下,它处于启用状态。 |
|
properties.trustedServiceAccessEnabled |
boolean |
指示是否启用受信任的服务访问的值。 |
|
properties.virtualNetworkRules |
列出 VirtualNetwork 规则 |
||
systemData |
与此资源相关的系统元数据。 |
||
type |
string |
资源的类型。 例如“Microsoft.EventHub/Namespaces”或“Microsoft.EventHub/Namespaces/EventHubs” |
NWRuleSetIpRules
NetWorkRuleSet - IpRules 资源的说明。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
action | Allow |
IP 筛选器操作 |
|
ipMask |
string |
IP 掩码 |
NWRuleSetVirtualNetworkRules
VirtualNetworkRules - NetworkRules 资源的说明。
名称 | 类型 | 说明 |
---|---|---|
ignoreMissingVnetServiceEndpoint |
boolean |
指示是否忽略缺少的 VNet 服务终结点的值 |
subnet |
子网属性 |
PublicNetworkAccessFlag
这决定了是否允许通过公用网络流量。 默认情况下,它处于启用状态。
名称 | 类型 | 说明 |
---|---|---|
Disabled |
string |
|
Enabled |
string |
Subnet
为子网提供的属性
名称 | 类型 | 说明 |
---|---|---|
id |
string |
虚拟网络子网的资源 ID |
systemData
与创建和上次修改资源相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源创建时间戳(UTC)。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识的类型。 |
|
lastModifiedAt |
string |
上次修改资源的标识的类型。 |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识的类型。 |