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 參數

名稱	位於	必要	類型	Description
accessRuleName	path	True	string	NSP 存取規則的名稱。
networkSecurityPerimeterName	path	True	string	網路安全性周邊的名稱。
profileName	path	True	string	NSP 設定檔的名稱。
resourceGroupName	path	True	string	資源群組的名稱。
subscriptionId	path	True	string	可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	類型	Description
location	string	資源位置。
name	string	配置檔中唯一的存取規則名稱。 此名稱可用來存取資源。
properties.addressPrefixes	string[]	輸入地址前綴 (IPv4/IPv6)
properties.direction	AccessRuleDirection	指定存取規則是否為輸入/輸出的方向。
properties.emailAddresses	string[]	輸出規則電子郵件地址格式。
properties.fullyQualifiedDomainNames	string[]	輸出規則完整功能變數名稱格式。
properties.phoneNumbers	string[]	輸出規則電話號碼格式。
properties.subscriptions	SubscriptionId[]	訂用帳戶標識碼清單
tags	object	資源標籤。

回應

名稱	類型	Description
200 OK	NspAccessRule	已更新 - 已更新現有的存取規則。 傳回資源。
201 Created	NspAccessRule	建立 - 傳回建立的 NspAccessRule 資源。
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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": []
  }
}

定義

名稱	Description
AccessRuleDirection	指定存取規則是否為輸入/輸出的方向。
CloudError	來自服務的錯誤回應。
CloudErrorBody	來自服務的錯誤回應。
NspAccessRule	NSP 存取規則資源
nspProvisioningState	範圍指派資源的布建狀態。
PerimeterBasedAccessRule
SubscriptionId

AccessRuleDirection

指定存取規則是否為輸入/輸出的方向。

名稱	類型	Description
Inbound	string
Outbound	string

CloudError

來自服務的錯誤回應。

名稱	類型	Description
error	CloudErrorBody	雲端錯誤本文。

CloudErrorBody

來自服務的錯誤回應。

名稱	類型	Description
code	string	錯誤的識別碼。 程式碼不變，且要以程式設計方式使用。
details	CloudErrorBody[]	錯誤的其他詳細數據清單。
message	string	描述錯誤的訊息，適用於在使用者介面中顯示。
target	string	特定錯誤的目標。 例如，錯誤中屬性的名稱。

NspAccessRule

NSP 存取規則資源

名稱	類型	Description
id	string	NSP 存取規則標識碼。
location	string	資源位置。
name	string	配置檔中唯一的存取規則名稱。 此名稱可用來存取資源。
properties.addressPrefixes	string[]	輸入地址前綴 (IPv4/IPv6)
properties.direction	AccessRuleDirection	指定存取規則是否為輸入/輸出的方向。
properties.emailAddresses	string[]	輸出規則電子郵件地址格式。
properties.fullyQualifiedDomainNames	string[]	輸出規則完整功能變數名稱格式。
properties.networkSecurityPerimeters	PerimeterBasedAccessRule[]	周邊標識碼所指定的規則。
properties.phoneNumbers	string[]	輸出規則電話號碼格式。
properties.provisioningState	nspProvisioningState	範圍指派資源的布建狀態。
properties.subscriptions	SubscriptionId[]	訂用帳戶標識碼清單
tags	object	資源標籤。
type	string	資源類型。

nspProvisioningState

範圍指派資源的布建狀態。

名稱	類型	Description
Accepted	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

PerimeterBasedAccessRule

名稱	類型	Description
id	string	ARM 識別碼格式的 NSP 識別碼。
location	string	提供的 NSP 位置。
perimeterGuid	string	提供的 NSP 資源 GUID。

SubscriptionId

名稱	類型	Description
id	string	ARM識別碼格式的訂用帳戶標識碼。