Network Security Perimeter Configurations - List

Szolgáltatás:: Event Grid

API-verzió:: 2025-04-01-preview

Szerezze be az erőforrás összes hálózati biztonsági szegélykonfigurációját.
Szerezze be a témakörhöz vagy tartományhoz társított összes hálózati biztonsági szegélykonfigurációt.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/{resourceType}/{resourceName}/networkSecurityPerimeterConfigurations?api-version=2025-04-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	A felhasználó előfizetésében lévő erőforráscsoport neve.
resourceName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-zA-Z0-9-]*$	Az erőforrás neve (vagyis a témakör neve vagy tartományneve).
resourceType	path	True	NetworkSecurityPerimeterResourceType	Az erőforrás típusa. Ez lehet "témakörök" vagy "tartományok".
subscriptionId	path	True	string	Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version	query	True	string	Az ügyfélkéréshez használandó API verziója.

Válaszok

Name	Típus	Description
200 OK	NetworkSecurityPerimeterConfigurationList	OKÉ
Other Status Codes	ErrorResponse	Sikertelen kérés esetén visszaadott hibaválasz.

Példák

NetworkSecurityPerimeterConfigurations_List

GET https://management.azure.com/subscriptions/8f6b6269-84f2-4d09-9e31-1127efcd1e40/resourceGroups/examplerg/providers/Microsoft.EventGrid/topics/exampleResourceName/networkSecurityPerimeterConfigurations?api-version=2025-04-01-preview

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.EventGrid;

// Generated from example definition: specification/eventgrid/resource-manager/Microsoft.EventGrid/preview/2025-04-01-preview/examples/NetworkSecurityPerimeterConfigurations_List.json
// this example is just showing the usage of "NetworkSecurityPerimeterConfigurations_List" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this EventGridTopicResource created on azure
// for more information of creating EventGridTopicResource, please refer to the document of EventGridTopicResource
string subscriptionId = "8f6b6269-84f2-4d09-9e31-1127efcd1e40";
string resourceGroupName = "examplerg";
string resourceName = "exampleResourceName";
ResourceIdentifier eventGridTopicResourceId = EventGridTopicResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, resourceName);
EventGridTopicResource eventGridTopic = client.GetEventGridTopicResource(eventGridTopicResourceId);

// get the collection of this TopicNetworkSecurityPerimeterConfigurationResource
TopicNetworkSecurityPerimeterConfigurationCollection collection = eventGridTopic.GetTopicNetworkSecurityPerimeterConfigurations();

// invoke the operation and iterate over the result
await foreach (NetworkSecurityPerimeterConfigurationData item in collection.GetAllAsync())
{
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {item.Id}");
}

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "properties": {
        "provisioningState": "Succeeded",
        "networkSecurityPerimeter": {
          "id": "/subscriptions/8f6b6269-84f2-4d09-9e31-1127efcd1e40/resourceGroups/perimeterrg/providers/Microsoft.Network/networkSecurityPerimeters/somePerimeter",
          "perimeterGuid": "8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter",
          "location": "West US"
        },
        "resourceAssociation": {
          "name": "someAssociation",
          "accessMode": "Enforced"
        },
        "profile": {
          "name": "someProfile",
          "accessRulesVersion": "1",
          "accessRules": [
            {
              "name": "ipRule",
              "properties": {
                "direction": "Inbound",
                "addressPrefixes": [
                  "148.0.0.0/8"
                ]
              }
            }
          ],
          "diagnosticSettingsVersion": "1",
          "enabledLogCategories": [
            "NspOutbound"
          ]
        }
      },
      "id": "/subscriptions//resourceGroups/paasrg/providers/Microsoft.EventGrid/topics/egtopic/networkSecurityPerimeterConfigurations/8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter.someAssociation",
      "name": "8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter.someAssociation",
      "type": "Microsoft.EventGrid/topics/networkSecurityPerimeterConfigurations"
    }
  ]
}

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
NetworkSecurityPerimeterAssociationAccessMode	Hálózati biztonsági szegélyelérési mód.
NetworkSecurityPerimeterConfigProvisioningState	Kiépítési állapot, amely tükrözi a konfiguráció állapotát, és jelzi az nsp-profil konfigurációlekérésének állapotát.
NetworkSecurityPerimeterConfiguration	Hálózati biztonsági szegélykonfiguráció.
NetworkSecurityPerimeterConfigurationIssues	Hálózati biztonsági szegélykonfigurációval kapcsolatos problémák.
NetworkSecurityPerimeterConfigurationIssueSeverity	A kiépítési probléma súlyossága.
NetworkSecurityPerimeterConfigurationIssueType	Kiépítési probléma típusa.
NetworkSecurityPerimeterConfigurationList	Hálózati biztonsági szegélykonfigurációs lista.
NetworkSecurityPerimeterConfigurationProfile	Nsp-konfiguráció profiladatokkal.
NetworkSecurityPerimeterInfo	Hálózati biztonsági szegélyadatok.
NetworkSecurityPerimeterProfileAccessRule	Hálózati biztonsági szegélyprofil hozzáférési szabálya.
NetworkSecurityPerimeterProfileAccessRuleDirection	NSP hozzáférési szabály iránya.
NetworkSecurityPerimeterResourceType	Az erőforrás típusa. Ez lehet "témakörök" vagy "tartományok".
NetworkSecurityPerimeterSubscription	Hálózati biztonsági peremhálózati előfizetés bejövő hozzáférési szabálya.
ResourceAssociation	Nsp-erőforrás társítás

ErrorAdditionalInfo

Objektum

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

Objektum

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

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

NetworkSecurityPerimeterAssociationAccessMode

Enumerálás

Hálózati biztonsági szegélyelérési mód.

Érték	Description
Audit
Enforced
Learning

NetworkSecurityPerimeterConfigProvisioningState

Enumerálás

Kiépítési állapot, amely tükrözi a konfiguráció állapotát, és jelzi az nsp-profil konfigurációlekérésének állapotát.

Érték	Description
Accepted
Canceled
Creating
Deleted
Deleting
Failed
Succeeded
Updating

NetworkSecurityPerimeterConfiguration

Objektum

Hálózati biztonsági szegélykonfiguráció.

Name	Típus	Description
id	string	Az erőforrás teljes azonosítója.
name	string	Az erőforrás neve.
properties.networkSecurityPerimeter	NetworkSecurityPerimeterInfo	Szegélyinformációk az nsp-társításhoz.
properties.profile	NetworkSecurityPerimeterConfigurationProfile	Nsp-profil konfigurációja, hozzáférési szabályok és diagnosztikai beállítások.
properties.provisioningIssues	NetworkSecurityPerimeterConfigurationIssues[]	Az nsp-profil konfigurációjának lekérésekor az állapotot tükröző kiépítési problémák.
properties.provisioningState	NetworkSecurityPerimeterConfigProvisioningState	Kiépítési állapot, amely tükrözi a konfiguráció állapotát, és jelzi az nsp-profil konfigurációlekérésének állapotát.
properties.resourceAssociation	ResourceAssociation	Nsp társítás neve és hozzáférési módja társítás.
type	string	Az erőforrás típusa.

NetworkSecurityPerimeterConfigurationIssues

Objektum

Hálózati biztonsági szegélykonfigurációval kapcsolatos problémák.

Name	Típus	Description
name	string	Kiépítési probléma neve.
properties.description	string	A kiépítési probléma leírása.
properties.issueType	NetworkSecurityPerimeterConfigurationIssueType	Kiépítési probléma típusa.
properties.severity	NetworkSecurityPerimeterConfigurationIssueSeverity	A kiépítési probléma súlyossága.
properties.suggestedAccessRules	string[]	Hozzáférési szabályok, amelyek hozzáadhatók ugyanahhoz a profilhoz a probléma megoldásához.
properties.suggestedResourceIds	string[]	Arm-azonosítók olyan erőforrásokhoz, amelyek ugyanahhoz a szegélyhez társíthatók a probléma megoldásához.

NetworkSecurityPerimeterConfigurationIssueSeverity

Enumerálás

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

Érték	Description
Error
Warning

NetworkSecurityPerimeterConfigurationIssueType

Enumerálás

Kiépítési probléma típusa.

Érték	Description
ConfigurationPropagationFailure
MissingIdentityConfiguration
MissingPerimeterConfiguration
Other

NetworkSecurityPerimeterConfigurationList

Objektum

Hálózati biztonsági szegélykonfigurációs lista.

Name	Típus	Description
nextLink	string	A hálózati biztonsági szegélykonfiguráció következő oldalának hivatkozása.
value	NetworkSecurityPerimeterConfiguration[]	Az összes hálózati biztonsági paraméter konfigurációjának listája.

NetworkSecurityPerimeterConfigurationProfile

Objektum

Nsp-konfiguráció profiladatokkal.

Name	Típus	Description
accessRules	NetworkSecurityPerimeterProfileAccessRule[]	Az nsp-profil bejövő vagy kimenő hozzáférési szabálybeállításainak listája.
accessRulesVersion	string	Hozzáférési szabályok verziószáma az nsp-profilhoz.
diagnosticSettingsVersion	string	Diagnosztikai beállítások verziószáma az nsp-profilhoz.
enabledLogCategories	string[]	Engedélyezett naplókategóriák az nsp-profilhoz.
name	string	Nsp konfigurációs profil neve.

NetworkSecurityPerimeterInfo

Objektum

Hálózati biztonsági szegélyadatok.

Name	Típus	Description
id	string	A hálózati biztonsági szegély arm azonosítója.
location	string	Hálózati biztonsági szegély helye.
perimeterGuid	string	Hálózati biztonsági szegély guid.

NetworkSecurityPerimeterProfileAccessRule

Objektum

Hálózati biztonsági szegélyprofil hozzáférési szabálya.

Name	Típus	Description
fullyQualifiedArmId	string	Teljes arm-azonosító a hálózati biztonsági szegélyprofil hozzáférési szabályához.
name	string	Az nsp hozzáférési szabály neve.
properties.addressPrefixes	string[]	Címelőtagok.
properties.direction	NetworkSecurityPerimeterProfileAccessRuleDirection	NSP hozzáférési szabály iránya.
properties.emailAddresses	string[]	Az e-mail-címek listája.
properties.fullyQualifiedDomainNames	string[]	Teljes tartománynevek.
properties.networkSecurityPerimeters	NetworkSecurityPerimeterInfo[]	Hálózati biztonsági szegélyek.
properties.phoneNumbers	string[]	Telefonszámok listája.
properties.subscriptions	NetworkSecurityPerimeterSubscription[]	Előfizetések listája.
type	string	nsp hozzáférési szabály típusa.

NetworkSecurityPerimeterProfileAccessRuleDirection

Enumerálás

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

Érték	Description
Inbound
Outbound

NetworkSecurityPerimeterResourceType

Enumerálás

Az erőforrás típusa. Ez lehet "témakörök" vagy "tartományok".

Érték	Description
domains
topics

NetworkSecurityPerimeterSubscription

Objektum

Hálózati biztonsági peremhálózati előfizetés bejövő hozzáférési szabálya.

Name	Típus	Description
id	string	Előfizetés azonosítója.

ResourceAssociation

Objektum

Nsp-erőforrás társítás

Name	Típus	Description
accessMode	NetworkSecurityPerimeterAssociationAccessMode	Hálózati biztonsági szegélyelérési mód.
name	string	Társítás neve

Megosztás a következőn keresztül:

Network Security Perimeter Configurations - List

URI-paraméterek

Válaszok

Példák

NetworkSecurityPerimeterConfigurations_List

Mintakérelem

Mintaválasz

Definíciók

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NetworkSecurityPerimeterAssociationAccessMode

NetworkSecurityPerimeterConfigProvisioningState

NetworkSecurityPerimeterConfiguration

NetworkSecurityPerimeterConfigurationIssues

NetworkSecurityPerimeterConfigurationIssueSeverity

NetworkSecurityPerimeterConfigurationIssueType

NetworkSecurityPerimeterConfigurationList

NetworkSecurityPerimeterConfigurationProfile

NetworkSecurityPerimeterInfo

NetworkSecurityPerimeterProfileAccessRule

NetworkSecurityPerimeterProfileAccessRuleDirection

NetworkSecurityPerimeterResourceType

NetworkSecurityPerimeterSubscription

ResourceAssociation