共用方式為


Network Security Perimeter Access Rules - Create Or Update

建立或更新網路存取規則。

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

URI 參數

名稱 位於 必要 類型 Description
accessRuleName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

NSP 存取規則的名稱。

networkSecurityPerimeterName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

網路安全性周邊的名稱。

profileName
path True

string

maxLength: 80
pattern: (^[a-zA-Z0-9]+[a-zA-Z0-9_.-]*[a-zA-Z0-9_]+$)|(^[a-zA-Z0-9]$)

NSP 設定檔的名稱。

resourceGroupName
path True

string

資源群組的名稱。

subscriptionId
path True

string

可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。

api-version
query True

string

用戶端 API 版本。

要求本文

名稱 類型 Description
properties.addressPrefixes

string[]

輸入地址前置文字 (IPv4/IPv6)

properties.direction

AccessRuleDirection

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

properties.emailAddresses

string[]

電子郵件地址格式的輸出規則。 此存取規則類型目前無法使用。

properties.fullyQualifiedDomainNames

string[]

完整功能變數名稱格式的輸出規則。

properties.phoneNumbers

string[]

電話號碼格式的輸出規則。 此存取規則類型目前無法使用。

properties.serviceTags

string[]

服務標籤類型的輸入規則。 此存取規則類型目前無法使用。

properties.subscriptions

SubscriptionId[]

訂用帳戶標識碼清單

回應

名稱 類型 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

範例要求

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

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

範例回覆

{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroups/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": [],
    "serviceTags": []
  },
  "systemData": {
    "createdBy": "user",
    "createdByType": "User",
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
  }
}
{
  "name": "accessRule1",
  "id": "/subscriptions/subId/resourceGroups/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": [],
    "serviceTags": []
  },
  "systemData": {
    "createdBy": "user",
    "createdByType": "User",
    "createdAt": "2024-02-07T18:07:36.3446713Z",
    "lastModifiedBy": "user",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-02-07T18:07:36.3446713Z"
  }
}

定義

名稱 Description
AccessRuleDirection

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

CloudError

來自服務的錯誤回應。

CloudErrorBody

來自服務的錯誤回應。

createdByType

建立資源的身分識別類型。

NspAccessRule

NSP 存取規則資源

nspProvisioningState

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

PerimeterBasedAccessRule
SubscriptionId
systemData

與建立和上次修改資源相關的元數據。

AccessRuleDirection

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

Description
Inbound
Outbound

CloudError

來自服務的錯誤回應。

名稱 類型 Description
error

CloudErrorBody

雲端錯誤內文。

CloudErrorBody

來自服務的錯誤回應。

名稱 類型 Description
code

string

錯誤的識別碼。 程序代碼是不變的,而且是要以程序設計方式取用。

details

CloudErrorBody[]

有關錯誤的其他詳細資料清單。

message

string

描述錯誤的訊息,適用於在使用者介面中顯示。

target

string

特定錯誤的目標。 例如,錯誤中的屬性名稱。

createdByType

建立資源的身分識別類型。

Description
User
Application
ManagedIdentity
Key

NspAccessRule

NSP 存取規則資源

名稱 類型 Description
id

string (arm-id)

資源的完整資源標識碼。 例如 “/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

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.serviceTags

string[]

服務標籤類型的輸入規則。 此存取規則類型目前無法使用。

properties.subscriptions

SubscriptionId[]

訂用帳戶標識碼清單

systemData

systemData

包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。

type

string

資源的類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

nspProvisioningState

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

Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed

PerimeterBasedAccessRule

名稱 類型 Description
id

string (arm-id)

NSP ID 以 ARM ID 格式表示。

location

string

提供的 NSP 的位置。

perimeterGuid

string

提供的 NSP 資源指南。

SubscriptionId

名稱 類型 Description
id

string (arm-id)

ARM識別碼格式的訂用帳戶標識碼。

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string (date-time)

資源建立的時間戳(UTC)。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string (date-time)

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。