Network Security Perimeter Configurations - Get

Usługa:

Storage Resource Provider

Wersja interfejsu API:

2025-08-01

Pobiera efektywną konfigurację NetworkSecurityPerimeterConfiguration dla skojarzenia

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nazwa konta magazynu w określonej grupie zasobów. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać wyłącznie cyfry oraz małe litery.
networkSecurityPerimeterConfigurationName	path	True	string pattern: ^.*$	Nazwa konfiguracji obwodu zabezpieczeń sieci
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	NetworkSecurityPerimeterConfiguration	Operacja Azure zakończyła się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

NetworkSecurityPerimeterConfigurationGet

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/networkSecurityPerimeterConfigurations/dbedb4e0-40e6-4145-81f3-f1314c150774.resourceAssociation1?api-version=2025-08-01

Przykładowa odpowiedź

Kod stanu:

200

{
  "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": "allowedSubscriptions",
          "properties": {
            "direction": "Inbound",
            "subscriptions": [
              {
                "id": "/subscriptions/dbedb4e0-40e6-4145-81f3-f1314c150774"
              }
            ]
          }
        }
      ],
      "accessRulesVersion": 10,
      "diagnosticSettingsVersion": 5,
      "enabledLogCategories": [
        "NspPublicInboundPerimeterRulesAllowed",
        "NspPublicInboundPerimeterRulesDenied"
      ]
    },
    "provisioningIssues": [
      {
        "name": "ConfigurationPropagationFailure",
        "properties": {
          "description": "Failed to update Network Security Perimeter association.",
          "issueType": "ConfigurationPropagationFailure",
          "severity": "Error"
        }
      }
    ],
    "provisioningState": "Succeeded",
    "resourceAssociation": {
      "name": "resourceAssociation1",
      "accessMode": "Enforced"
    }
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorResponse	Odpowiedź dostawcy zasobów magazynu na błąd.
ErrorResponseBody	Kontrakt treści odpowiedzi na błąd.
IssueType	Typ problemu
NetworkSecurityPerimeter	Informacje dotyczące parametru NetworkSecurityPerimeter
NetworkSecurityPerimeterConfiguration	Zasób konfiguracji obwodowej zabezpieczeń sieci.
NetworkSecurityPerimeterConfigurationPropertiesProfile	Profil obwodowy zabezpieczeń sieci
NetworkSecurityPerimeterConfigurationPropertiesResourceAssociation	Informacje o skojarzeniu zasobów
NetworkSecurityPerimeterConfigurationProvisioningState	Stan aprowizacji propagacji konfiguracji obwodu zabezpieczeń sieci
NspAccessRule	Informacje o regule dostępu w profilu obwodowym zabezpieczeń sieci
NspAccessRuleDirection	Kierunek reguły dostępu
NspAccessRuleProperties	Właściwości reguły dostępu
NspAccessRulePropertiesSubscriptionsItem	Subskrypcja dla reguły ruchu przychodzącego
ProvisioningIssue	Opisuje problem z aprowizacją dla danej konfiguracji NetworkSecurityPerimeterConfiguration
ProvisioningIssueProperties	Właściwości problemu z aprowizowaniem
ResourceAssociationAccessMode	Tryb dostępu skojarzenia zasobu
Severity	Ważność problemu.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Odpowiedź dostawcy zasobów magazynu na błąd.

Nazwa	Typ	Opis
error	ErrorResponseBody	Azure Storage Resource Provider Error response body.

ErrorResponseBody

Objekt

Kontrakt treści odpowiedzi na błąd.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

IssueType

Wyliczenie

Typ problemu

Wartość	Opis
Unknown
ConfigurationPropagationFailure

NetworkSecurityPerimeter

Objekt

Informacje dotyczące parametru NetworkSecurityPerimeter

Nazwa	Typ	Opis
id	string	Identyfikator usługi ARM zasobu
location	string	Lokalizacja zasobu
perimeterGuid	string	Identyfikator GUID zasobu

NetworkSecurityPerimeterConfiguration

Objekt

Zasób konfiguracji obwodowej zabezpieczeń sieci.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties.networkSecurityPerimeter	NetworkSecurityPerimeter	Informacje dotyczące parametru NetworkSecurityPerimeter
properties.profile	NetworkSecurityPerimeterConfigurationPropertiesProfile	Profil obwodowy zabezpieczeń sieci
properties.provisioningIssues	ProvisioningIssue[]	Lista problemów z aprowizowaniem, jeśli istnieją
properties.provisioningState	NetworkSecurityPerimeterConfigurationProvisioningState	Stan aprowizacji propagacji konfiguracji obwodu zabezpieczeń sieci
properties.resourceAssociation	NetworkSecurityPerimeterConfigurationPropertiesResourceAssociation	Informacje o skojarzeniu zasobów
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

NetworkSecurityPerimeterConfigurationPropertiesProfile

Objekt

Profil obwodowy zabezpieczeń sieci

Nazwa	Typ	Opis
accessRules	NspAccessRule[]	Lista reguł dostępu
accessRulesVersion	number (float)	Bieżąca wersja reguł dostępu
diagnosticSettingsVersion	number (float)	Wersja ustawień diagnostycznych
enabledLogCategories	string[]	Włączone kategorie rejestrowania
name	string	Nazwa zasobu

NetworkSecurityPerimeterConfigurationPropertiesResourceAssociation

Objekt

Informacje o skojarzeniu zasobów

Nazwa	Typ	Opis
accessMode	ResourceAssociationAccessMode	Tryb dostępu skojarzenia zasobu
name	string	Nazwa skojarzenia zasobu

NetworkSecurityPerimeterConfigurationProvisioningState

Wyliczenie

Stan aprowizacji propagacji konfiguracji obwodu zabezpieczeń sieci

Wartość	Opis
Accepted
Succeeded
Failed
Deleting
Canceled

NspAccessRule

Objekt

Informacje o regule dostępu w profilu obwodowym zabezpieczeń sieci

Nazwa	Typ	Opis
name	string	Nazwa zasobu
properties	NspAccessRuleProperties	Właściwości reguły dostępu

NspAccessRuleDirection

Wyliczenie

Kierunek reguły dostępu

Wartość	Opis
Inbound
Outbound

NspAccessRuleProperties

Objekt

Właściwości reguły dostępu

Nazwa	Typ	Opis
addressPrefixes	string[]	Prefiksy adresów w formacie CIDR dla reguł ruchu przychodzącego
direction	NspAccessRuleDirection	Kierunek reguły dostępu
fullyQualifiedDomainNames	string[]	Nazwa FQDN dla reguł ruchu wychodzącego
networkSecurityPerimeters	NetworkSecurityPerimeter[]	NetworkSecurityPerimeters dla reguł ruchu przychodzącego
subscriptions	NspAccessRulePropertiesSubscriptionsItem[]	Subskrypcje dla reguł ruchu przychodzącego

NspAccessRulePropertiesSubscriptionsItem

Objekt

Subskrypcja dla reguły ruchu przychodzącego

Nazwa	Typ	Opis
id	string	Identyfikator ARM subskrypcji

ProvisioningIssue

Objekt

Opisuje problem z aprowizacją dla danej konfiguracji NetworkSecurityPerimeterConfiguration

Nazwa	Typ	Opis
name	string	Nazwa problemu
properties	ProvisioningIssueProperties	Właściwości problemu z aprowizowaniem

ProvisioningIssueProperties

Objekt

Właściwości problemu z aprowizowaniem

Nazwa	Typ	Opis
description	string	Opis problemu
issueType	IssueType	Typ problemu
severity	Severity	Ważność problemu.

ResourceAssociationAccessMode

Wyliczenie

Tryb dostępu skojarzenia zasobu

Wartość	Opis
Enforced
Learning
Audit

Severity

Wyliczenie

Ważność problemu.

Wartość	Opis
Warning
Error

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.