通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Nsp Access Rules - Create Or Update

  • 参考
服务:
Network Manager
API 版本:
2023-07-01-preview

创建或更新网络访问规则。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkSecurityPerimeters/{networkSecurityPerimeterName}/profiles/{profileName}/accessRules/{accessRuleName}?api-version=2023-07-01-preview

URI 参数

名称 在 必需 类型 说明
accessRuleName
 path True

string

NSP 访问规则的名称。
networkSecurityPerimeterName
 path True

string

网络安全外围的名称。
profileName
 path True

string

NSP 配置文件的名称。
resourceGroupName
 path True

string

资源组的名称。
subscriptionId
 path True

string

唯一标识 Azure 订阅Microsoft的订阅凭据。 订阅 ID 构成了每个服务调用的 URI 的一部分。
api-version
 query True

string

客户端 API 版本。

请求正文

名称 类型 说明
___location

string

资源位置。
name

string

配置文件中唯一的访问规则的名称。 此名称可用于访问资源。
properties.addressPrefixes

string[]

入站地址前缀（IPv4/IPv6）
properties.direction

AccessRuleDirection

指定访问规则是否为入站/出站的方向。
properties.emailAddresses

string[]

出站规则电子邮件地址格式。
properties.fullyQualifiedDomainNames

string[]

出站规则完全限定的域名格式。
properties.phoneNumbers

string[]

出站规则电话号码格式。
properties.subscriptions

SubscriptionId[]

订阅 ID 列表
tags

object

资源标记。

响应

名称 类型 说明
200 OK

NspAccessRule

已更新 - 已更新现有访问规则。 返回资源。
201 Created

NspAccessRule

创建 - 返回创建的 NspAccessRule 资源。
Other Status Codes

CloudError

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

NspAccessRulePut

示例请求

PUT https://management.azure.com/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1?api-version=2023-07-01-preview

{
  "properties": {
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ]
  }
}

示例响应

状态代码:
200 
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": []
  }
}
状态代码:
201 
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroup/rg1/providers/Microsoft.Network/networkSecurityPerimeters/nsp1/profiles/profile1/accessRules/accessRule1",
  "type": "Microsoft.Network/networkSecurityPerimeters/profiles/accessRules",
  "properties": {
    "provisioningState": "Succeeded",
    "direction": "Inbound",
    "addressPrefixes": [
      "10.11.0.0/16",
      "10.10.1.0/24"
    ],
    "fullyQualifiedDomainNames": [],
    "subscriptions": [],
    "networkSecurityPerimeters": [],
    "emailAddresses": [],
    "phoneNumbers": []
  }
}

定义

名称 说明
AccessRuleDirection

指定访问规则是否为入站/出站的方向。
CloudError

服务的错误响应。
CloudErrorBody

服务的错误响应。
NspAccessRule

NSP 访问规则资源
nspProvisioningState

范围分配资源的预配状态。
PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

枚举

指定访问规则是否为入站/出站的方向。

值 说明
Inbound
Outbound

CloudError

Object

服务的错误响应。

名称 类型 说明
error

CloudErrorBody

云错误正文。

CloudErrorBody

Object

服务的错误响应。

名称 类型 说明
code

string

错误的标识符。 代码是固定的，旨在以编程方式使用。
details

CloudErrorBody[]

有关错误的其他详细信息的列表。
message

string

描述错误的消息，旨在适合在用户界面中显示。
target

string

特定错误的目标。 例如，错误属性的名称。

NspAccessRule

Object

NSP 访问规则资源

名称 类型 说明
id

string

NSP 访问规则标识符。
___location

string

资源位置。
name

string

配置文件中唯一的访问规则的名称。 此名称可用于访问资源。
properties.addressPrefixes

string[]

入站地址前缀（IPv4/IPv6）
properties.direction

AccessRuleDirection

指定访问规则是否为入站/出站的方向。
properties.emailAddresses

string[]

出站规则电子邮件地址格式。
properties.fullyQualifiedDomainNames

string[]

出站规则完全限定的域名格式。
properties.networkSecurityPerimeters

PerimeterBasedAccessRule[]

由外围 ID 指定的规则。
properties.phoneNumbers

string[]

出站规则电话号码格式。
properties.provisioningState

nspProvisioningState

范围分配资源的预配状态。
properties.subscriptions

SubscriptionId[]

订阅 ID 列表
tags

object

资源标记。
type

string

资源类型。

nspProvisioningState

枚举

范围分配资源的预配状态。

值 说明
Accepted
Creating
Deleting
Failed
Succeeded
Updating

PerimeterBasedAccessRule

Object
名称 类型 说明
id

string

ARM ID 格式的 NSP ID。
___location

string

提供的 NSP 的位置。
perimeterGuid

string

提供的 NSP 的资源 GUID。

SubscriptionId

Object
名称 类型 说明
id

string

ARM ID 格式的订阅 ID。