你当前正在访问 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	可以唯一标识 Microsoft Azure 订阅的订阅凭据。此订阅 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

示例请求

HTTP

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	string
Outbound	string

CloudError

来自服务的错误响应。

名称	类型	说明
error	CloudErrorBody	云错误正文。

CloudErrorBody

来自服务的错误响应。

名称	类型	说明
code	string	错误的标识符。代码是固定的，旨在以编程方式使用。
details	CloudErrorBody[]	有关错误的其他详细信息的列表。
message	string	描述错误的消息，该消息适用于在用户界面中显示。
target	string	特定错误的目标。例如，属性的名称出错。

NspAccessRule

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	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

PerimeterBasedAccessRule

名称	类型	说明
id	string	采用 ARM ID 格式的 NSP ID。
location	string	提供的 NSP 的位置。
perimeterGuid	string	提供的 NSP 的资源 guid。

SubscriptionId

名称	类型	说明
id	string	ARM ID 格式的订阅 ID。

通过