Megosztás:


Network Security Perimeter Configurations - List By Private Link Scope

A privát kapcsolat hatókörének hálózati biztonsági szegélykonfigurációit sorolja fel.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/privateLinkScopes/{scopeName}/networkSecurityPerimeterConfigurations?api-version=2025-01-13

URI-paraméterek

Name In Kötelező Típus Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

scopeName
path True

string

pattern: [a-zA-Z0-9-_\.]+

Az Azure Arc PrivateLinkScope-erőforrás neve.

subscriptionId
path True

string

minLength: 1

A cél-előfizetés azonosítója.

api-version
query True

string

minLength: 1

A művelethez használni kívánt API-verzió.

Válaszok

Name Típus Description
200 OK

NetworkSecurityPerimeterConfigurationListResult

Sikeresen lekérte a hálózati biztonsági szegély konfigurációjának részleteit.

Other Status Codes

ErrorResponse

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

Mintakérelem

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/my-resource-group/providers/Microsoft.HybridCompute/privateLinkScopes/my-privatelinkscope/networkSecurityPerimeterConfigurations?api-version=2025-01-13

Mintaválasz

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/my-resource-group/providers/Microsoft.HybridCompute/privateLinkScopes/my-privatelinkscope/networkSecurityPerimeterConfigurations/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.myAssociation",
      "name": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee.myAssociation",
      "type": "Microsoft.HybridCompute/privateLinkScopes/networkSecurityPerimeterConfigurations",
      "properties": {
        "provisioningState": "Accepted",
        "provisioningIssues": [],
        "networkSecurityPerimeter": {
          "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/networkSecurityPerimeters/myPerimeter",
          "perimeterGuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
          "location": "westus"
        },
        "resourceAssociation": {
          "name": "myAssociation",
          "accessMode": "enforced"
        },
        "profile": {
          "name": "myProfile",
          "accessRulesVersion": 1,
          "accessRules": [
            {
              "name": "myAccessRule",
              "properties": {
                "direction": "Inbound",
                "addressPrefixes": [
                  "148.0.0.0/8",
                  "152.4.6.0/24",
                  "..."
                ]
              }
            }
          ],
          "diagnosticSettingsVersion": 1,
          "enabledLogCategories": []
        }
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/my-resource-group/providers/Microsoft.HybridCompute/privateLinkScopes/my-privatelinkscope/networkSecurityPerimeterConfigurations/37364608-77ea-4c2a-bdc3-4b0b1cdfab15.myAssociation2",
      "name": "aaaaaaaa-0000-cccc-1111-eeeeeeeeeeee.myAssociation2",
      "type": "Microsoft.HybridCompute/privateLinkScopes/networkSecurityPerimeterConfigurations",
      "properties": {
        "provisioningState": "Accepted",
        "provisioningIssues": [],
        "networkSecurityPerimeter": {
          "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/networkSecurityPerimeters/myOtherPerimeter",
          "perimeterGuid": "aaaaaaaa-0000-cccc-1111-eeeeeeeeeeee",
          "location": "westus"
        },
        "resourceAssociation": {
          "name": "myAssociation",
          "accessMode": "learning"
        },
        "profile": {
          "name": "myProfile",
          "accessRulesVersion": 1,
          "accessRules": [
            {
              "name": "myAccessRule",
              "properties": {
                "direction": "Inbound",
                "addressPrefixes": [
                  "122.0.0.0/8",
                  "144.4.6.0/24",
                  "..."
                ]
              }
            }
          ],
          "diagnosticSettingsVersion": 1,
          "enabledLogCategories": []
        }
      }
    }
  ]
}

Definíciók

Name Description
AccessMode

Az erőforrás naplózási viselkedését és más erőforrásokkal és nyilvános hálózatokkal való kapcsolatát befolyásoló tulajdonság.

AccessRule

Hozzáférési szabály.

AccessRuleDirection

Egy hozzáférési szabály irányát jelzi.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

NetworkSecurityPerimeter

Hálózati biztonsági szegélyerőforrást meghatározó tulajdonságok.

NetworkSecurityPerimeterConfiguration

Hálózati biztonsági szegélyerőforrást meghatározó tulajdonságok.

NetworkSecurityPerimeterConfigurationListResult

A hálózati biztonsági szegélykonfigurációk listája.

NetworkSecurityPerimeterProfile

Hálózati biztonsági szegélyprofil

ProvisioningIssue

A kiépítés során felmerülő problémák részletei.

ProvisioningIssueSeverity

A kiépítési probléma súlyossága.

ProvisioningIssueType

A kiépítési probléma típusa.

ResourceAssociation

Erőforrástársítást meghatározó tulajdonságok.

AccessMode

Az erőforrás naplózási viselkedését és más erőforrásokkal és nyilvános hálózatokkal való kapcsolatát befolyásoló tulajdonság.

Érték Description
enforced

Azt jelzi, hogy az erőforrás-hozzáférést az NSP definíciója szabályozza.

audit

Száraz futtatási mód, ahol a forgalom kiértékelése NSP-szabályok szerint történik, naplózva, de nem kényszerítve.

learning

Lehetővé teszi a forgalom kiértékelését az erőforrás-specifikus tűzfalkonfigurációkra való visszalépéshez.

AccessRule

Hozzáférési szabály.

Name Típus Description
name

string

A hozzáférési szabály neve.

properties.addressPrefixes

string[]

Címelőtagok, amelyek engedélyezettek.

properties.direction

AccessRuleDirection

A hozzáférési szabály iránya.

AccessRuleDirection

Egy hozzáférési szabály irányát jelzi.

Érték Description
Inbound

A forgalom a hálózaton kívülről származik.

Outbound

A forgalom a hálózaton belülről származik

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

NetworkSecurityPerimeter

Hálózati biztonsági szegélyerőforrást meghatározó tulajdonságok.

Name Típus Description
id

string

Azure-erőforrás azonosítója

location

string

A szegély regionális elhelyezkedése

perimeterGuid

string

A hálózati biztonsági szegély guid azonosítója

NetworkSecurityPerimeterConfiguration

Hálózati biztonsági szegélyerőforrást meghatározó tulajdonságok.

Name Típus Description
id

string

Azure-erőforrás azonosítója

name

string

Azure-erőforrás neve

properties.networkSecurityPerimeter

NetworkSecurityPerimeter

A konfigurációhoz társított hálózati biztonsági szegély.

properties.profile

NetworkSecurityPerimeterProfile

Hálózati biztonsági szegélyprofil

properties.provisioningIssues

ProvisioningIssue[]

Kiépítési problémák.

properties.provisioningState

string

A NetworkSecurityPerimeter jelenlegi állapota: azt jelzi, hogy ki van-e építve a definiált erőforráscsoporton belül. A felhasználók nem módosíthatják ezt az értéket, de olvashatnak belőle. Az értékek közé tartozik a kiépítés, a sikeres, a megszakított és a sikertelen.

properties.resourceAssociation

ResourceAssociation

Az erőforrás-társítás.

type

string

Azure-erőforrástípus

NetworkSecurityPerimeterConfigurationListResult

A hálózati biztonsági szegélykonfigurációk listája.

Name Típus Description
nextLink

string

Hivatkozás az eredmények következő oldalának lekéréséhez.

value

NetworkSecurityPerimeterConfiguration[]

Eredménytömb.

NetworkSecurityPerimeterProfile

Hálózati biztonsági szegélyprofil

Name Típus Description
accessRules

AccessRule[]

A profil hozzáférési szabályainak gyűjteménye

accessRulesVersion

integer (int32)

Hozzáférési szabályok verziószáma

diagnosticSettingsVersion

integer (int32)

Diagnosztikai beállítások verziószáma

enabledLogCategories

string[]

A profil engedélyezett naplókategóriáinak gyűjteménye

name

string

Az erőforrás neve

ProvisioningIssue

A kiépítés során felmerülő problémák részletei.

Name Típus Description
name

string

A kiépítési probléma neve.

properties.description

string

A kiépítési probléma leírása.

properties.issueType

ProvisioningIssueType

Probléma típusa

properties.severity

ProvisioningIssueSeverity

A kiépítési probléma súlyossága.

properties.suggestedAccessRules

AccessRule[]

Hozzáférési szabályok, amelyek hozzáadhatók a szegélyhez a probléma megoldásához

properties.suggestedResourceIds

string[]

Az ugyanahhoz a szegélyhez társítható erőforrások ARM-azonosítói a probléma megoldásához

ProvisioningIssueSeverity

A kiépítési probléma súlyossága.

Érték Description
Warning

A figyelmeztetések csatlakozási problémákat okozhatnak a sikeres üzembe helyezés után.

Error

A hibák miatt a társítás kiépítése meghiúsul.

ProvisioningIssueType

A kiépítési probléma típusa.

Érték Description
MissingPerimeterConfiguration

A szegélykonfiguráció hiányzik.

MissingIdentityConfiguration

Hiányzik az identitáskonfiguráció.

ConfigurationPropagationFailure

A konfiguráció propagálása nem sikerült.

Other

Egyéb hiba.

ResourceAssociation

Erőforrástársítást meghatározó tulajdonságok.

Name Típus Description
accessMode

AccessMode

A hozzáférési mód

name

string

Az erőforrástársítás neve