Network Security Perimeter Configurations - List

服務:: Storage Resource Provider

API 版本:: 2025-08-01

取得儲存體帳戶的有效 NetworkSecurityPerimeterConfiguration 清單

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/networkSecurityPerimeterConfigurations?api-version=2025-08-01

URI 參數

名稱	位於	必要	類型	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	指定資源群組內的記憶體帳戶名稱。儲存體帳戶名稱長度必須介於 3 到 24 個字元之間，且只能使用數位和小寫字母。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string (uuid)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

回應

名稱	類型	Description
200 OK	NetworkSecurityPerimeterConfigurationList	Azure 運作順利完成。
Other Status Codes	ErrorResponse	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

NetworkSecurityPerimeterConfigurationList

範例要求

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/networkSecurityPerimeterConfigurations?api-version=2025-08-01

範例回覆

狀態碼:: 200

{
  "value": [
    {
      "name": "dbedb4e0-40e6-4145-81f3-f1314c150774.resourceAssociation1",
      "type": "Microsoft.Storage/storageAccounts/networkSecurityPerimeterConfigurations",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/networkSecurityPerimeterConfigurations/dbedb4e0-40e6-4145-81f3-f1314c150774.resourceAssociation1",
      "properties": {
        "networkSecurityPerimeter": {
          "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774/resourceGroups/res4794/providers/Microsoft.Network/networkSecurityPerimeters/nsp1",
          "location": "East US",
          "perimeterGuid": "ce2d5953-5c15-40ca-9d51-cc3f4a63b0f5"
        },
        "profile": {
          "name": "profile1",
          "accessRules": [
            {
              "name": "inVpnRule",
              "properties": {
                "addressPrefixes": [
                  "148.0.0.0/8",
                  "152.4.6.0/24"
                ],
                "direction": "Inbound"
              }
            }
          ],
          "accessRulesVersion": 10,
          "diagnosticSettingsVersion": 5,
          "enabledLogCategories": [
            "NspPublicInboundPerimeterRulesAllowed",
            "NspPublicInboundPerimeterRulesDenied"
          ]
        },
        "provisioningState": "Succeeded",
        "resourceAssociation": {
          "name": "association1",
          "accessMode": "Enforced"
        }
      }
    }
  ]
}

定義

名稱	Description
createdByType	建立資源的身分識別類型。
ErrorResponse	記憶體資源提供者的錯誤回應。
ErrorResponseBody	錯誤回應本文合約。
IssueType	問題類型
NetworkSecurityPerimeter	NetworkSecurityPerimeter 相關信息
NetworkSecurityPerimeterConfiguration	網路安全性周邊設定資源。
NetworkSecurityPerimeterConfigurationList	列出網路安全性周邊設定作業的結果。
NetworkSecurityPerimeterConfigurationPropertiesProfile	網路安全性周邊配置檔
NetworkSecurityPerimeterConfigurationPropertiesResourceAssociation	資源關聯的相關信息
NetworkSecurityPerimeterConfigurationProvisioningState	網路安全性周邊設定傳播的佈建狀態
NspAccessRule	網路安全性周邊配置檔中的存取規則資訊
NspAccessRuleDirection	存取規則的方向
NspAccessRuleProperties	存取規則的屬性
NspAccessRulePropertiesSubscriptionsItem	輸入規則的訂用帳戶
ProvisioningIssue	說明指定 NetworkSecurityPerimeterConfiguration 的布建問題
ProvisioningIssueProperties	布建問題的屬性
ResourceAssociationAccessMode	資源關聯的存取模式
Severity	問題的嚴重性。
systemData	與建立和上次修改資源相關的元數據。

createdByType

列舉型別

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

值	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Object

記憶體資源提供者的錯誤回應。

名稱	類型	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

錯誤回應本文合約。

名稱	類型	Description
code	string	錯誤的識別碼。程序代碼是不變的，而且是要以程序設計方式取用。
message	string	描述錯誤的訊息，適用於在使用者介面中顯示。

IssueType

列舉型別

問題類型

值	Description
Unknown
ConfigurationPropagationFailure

NetworkSecurityPerimeter

Object

NetworkSecurityPerimeter 相關信息

名稱	類型	Description
id	string	資源的 ARM 識別碼
location	string	資源的位置
perimeterGuid	string	資源的 Guid

NetworkSecurityPerimeterConfiguration

Object

網路安全性周邊設定資源。

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties.networkSecurityPerimeter	NetworkSecurityPerimeter	NetworkSecurityPerimeter 相關信息
properties.profile	NetworkSecurityPerimeterConfigurationPropertiesProfile	網路安全性周邊配置檔
properties.provisioningIssues	ProvisioningIssue[]	如果有的話，布建問題清單
properties.provisioningState	NetworkSecurityPerimeterConfigurationProvisioningState	網路安全性周邊設定傳播的佈建狀態
properties.resourceAssociation	NetworkSecurityPerimeterConfigurationPropertiesResourceAssociation	資源關聯的相關信息
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 中繼資料。
type	string	資源的類型。例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

NetworkSecurityPerimeterConfigurationList

Object

列出網路安全性周邊設定作業的結果。

名稱	類型	Description
nextLink	string (uri)	專案下一頁的連結
value	NetworkSecurityPerimeterConfiguration[]	此頁面上的 NetworkSecurityPerimeterConfiguration 專案

NetworkSecurityPerimeterConfigurationPropertiesProfile

Object

網路安全性周邊配置檔

名稱	類型	Description
accessRules	NspAccessRule[]	存取規則清單
accessRulesVersion	number (float)	目前的存取規則版本
diagnosticSettingsVersion	number (float)	診斷設定版本
enabledLogCategories	string[]	已啟用的記錄類別
name	string	資源的名稱

NetworkSecurityPerimeterConfigurationPropertiesResourceAssociation

Object

資源關聯的相關信息

名稱	類型	Description
accessMode	ResourceAssociationAccessMode	資源關聯的存取模式
name	string	資源關聯的名稱

NetworkSecurityPerimeterConfigurationProvisioningState

列舉型別

網路安全性周邊設定傳播的佈建狀態

值	Description
Accepted
Succeeded
Failed
Deleting
Canceled

NspAccessRule

Object

網路安全性周邊配置檔中的存取規則資訊

名稱	類型	Description
name	string	資源的名稱
properties	NspAccessRuleProperties	存取規則的屬性

NspAccessRuleDirection

列舉型別

存取規則的方向

值	Description
Inbound
Outbound

NspAccessRuleProperties

Object

存取規則的屬性

名稱	類型	Description
addressPrefixes	string[]	輸入規則 CIDR 格式的位址前置詞
direction	NspAccessRuleDirection	存取規則的方向
fullyQualifiedDomainNames	string[]	輸出規則的 FQDN
networkSecurityPerimeters	NetworkSecurityPerimeter[]	NetworkSecurityPerimeters 的輸入規則
subscriptions	NspAccessRulePropertiesSubscriptionsItem[]	輸入規則的訂用帳戶

NspAccessRulePropertiesSubscriptionsItem

Object

輸入規則的訂用帳戶

名稱	類型	Description
id	string	訂閱的 ARM 識別碼

ProvisioningIssue

Object

說明指定 NetworkSecurityPerimeterConfiguration 的布建問題

名稱	類型	Description
name	string	問題的名稱
properties	ProvisioningIssueProperties	布建問題的屬性

ProvisioningIssueProperties

Object

布建問題的屬性

名稱	類型	Description
description	string	問題的描述
issueType	IssueType	問題類型
severity	Severity	問題的嚴重性。

ResourceAssociationAccessMode

列舉型別

資源關聯的存取模式

值	Description
Enforced
Learning
Audit

Severity

列舉型別

問題的嚴重性。

值	Description
Warning
Error

systemData

Object

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

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	資源上次修改的時間戳記（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。