Network Security Perimeter Configurations - List

Layanan:: Event Grid

Versi API:: 2025-07-15-preview

Dapatkan semua konfigurasi perimeter keamanan jaringan untuk sumber daya.
Dapatkan semua konfigurasi perimeter keamanan jaringan yang terkait dengan topik atau domain.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
resourceName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-zA-Z0-9-]*$	Nama grup sumber daya dalam langganan pengguna.
resourceType	path	True	NetworkSecurityPerimeterResourceType	Jenis sumber daya. Ini bisa berupa \'topics\', atau \'domains\'.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	NetworkSecurityPerimeterConfigurationList	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

NetworkSecurityPerimeterConfigurations_List

Permintaan sampel

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.eventgrid import EventGridManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-eventgrid
# USAGE
    python network_security_perimeter_configurations_list.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = EventGridManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.network_security_perimeter_configurations.list(
        resource_group_name="examplerg",
        resource_type="topics",
        resource_name="exampleResourceName",
    )
    for item in response:
        print(item)


# x-ms-original-file: 2025-07-15-preview/NetworkSecurityPerimeterConfigurations_List.json
if __name__ == "__main__":
    main()

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

package armeventgrid_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/eventgrid/armeventgrid/v2"
)

// Generated from example definition: 2025-07-15-preview/NetworkSecurityPerimeterConfigurations_List.json
func ExampleNetworkSecurityPerimeterConfigurationsClient_NewListPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armeventgrid.NewClientFactory("8f6b6269-84f2-4d09-9e31-1127efcd1e40", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewNetworkSecurityPerimeterConfigurationsClient().NewListPager("examplerg", armeventgrid.NetworkSecurityPerimeterResourceTypeTopics, "exampleResourceName", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armeventgrid.NetworkSecurityPerimeterConfigurationsClientListResponse{
		// 	NetworkSecurityPerimeterConfigurationList: armeventgrid.NetworkSecurityPerimeterConfigurationList{
		// 		Value: []*armeventgrid.NetworkSecurityPerimeterConfiguration{
		// 			{
		// 				Name: to.Ptr("8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter.someAssociation"),
		// 				Type: to.Ptr("Microsoft.EventGrid/topics/networkSecurityPerimeterConfigurations"),
		// 				ID: to.Ptr("/subscriptions/8f6b6269-84f2-4d09-9e31-1127efcd1e40/resourceGroups/paasrg/providers/Microsoft.EventGrid/topics/egtopic/networkSecurityPerimeterConfigurations/8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter.someAssociation"),
		// 				Properties: &armeventgrid.NetworkSecurityPerimeterConfigurationProperties{
		// 					NetworkSecurityPerimeter: &armeventgrid.NetworkSecurityPerimeterInfo{
		// 						ID: to.Ptr("/subscriptions/8f6b6269-84f2-4d09-9e31-1127efcd1e40/resourceGroups/perimeterrg/providers/Microsoft.Network/networkSecurityPerimeters/somePerimeter"),
		// 						Location: to.Ptr("West US"),
		// 						PerimeterGUID: to.Ptr("8f6b6269-84f2-4d09-9e31-1127efcd1e40perimeter"),
		// 					},
		// 					Profile: &armeventgrid.NetworkSecurityPerimeterConfigurationProfile{
		// 						Name: to.Ptr("someProfile"),
		// 						AccessRules: []*armeventgrid.NetworkSecurityPerimeterProfileAccessRule{
		// 							{
		// 								Name: to.Ptr("ipRule"),
		// 								Properties: &armeventgrid.NetworkSecurityPerimeterProfileAccessRuleProperties{
		// 									AddressPrefixes: []*string{
		// 										to.Ptr("148.0.0.0/8"),
		// 									},
		// 									Direction: to.Ptr(armeventgrid.NetworkSecurityPerimeterProfileAccessRuleDirectionInbound),
		// 								},
		// 							},
		// 						},
		// 						AccessRulesVersion: to.Ptr("1"),
		// 						DiagnosticSettingsVersion: to.Ptr("1"),
		// 						EnabledLogCategories: []*string{
		// 							to.Ptr("NspOutbound"),
		// 						},
		// 					},
		// 					ProvisioningState: to.Ptr(armeventgrid.NetworkSecurityPerimeterConfigProvisioningStateSucceeded),
		// 					ResourceAssociation: &armeventgrid.ResourceAssociation{
		// 						Name: to.Ptr("someAssociation"),
		// 						AccessMode: to.Ptr(armeventgrid.NetworkSecurityPerimeterAssociationAccessModeEnforced),
		// 					},
		// 				},
		// 			},
		// 		},
		// 	},
		// }
	}
}

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

const { EventGridManagementClient } = require("@azure/arm-eventgrid");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to get all network security perimeter configurations associated with a topic or domain.
 *
 * @summary get all network security perimeter configurations associated with a topic or domain.
 * x-ms-original-file: 2025-07-15-preview/NetworkSecurityPerimeterConfigurations_List.json
 */
async function networkSecurityPerimeterConfigurationsList() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "8f6b6269-84f2-4d09-9e31-1127efcd1e40";
  const client = new EventGridManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.networkSecurityPerimeterConfigurations.list(
    "examplerg",
    "topics",
    "exampleResourceName",
  )) {
    resArray.push(item);
  }

  console.log(resArray);
}

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

Respon sampel

Kode status:: 200

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

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
NetworkSecurityPerimeterAssociationAccessMode	Mode akses perimeter keamanan jaringan.
NetworkSecurityPerimeterConfigProvisioningState	Status provisi untuk mencerminkan status konfigurasi dan menunjukkan status pengambilan konfigurasi profil nsp.
NetworkSecurityPerimeterConfiguration	Konfigurasi perimeter keamanan jaringan.
NetworkSecurityPerimeterConfigurationIssues	Masalah konfigurasi perimeter keamanan jaringan.
NetworkSecurityPerimeterConfigurationIssueSeverity	Tingkat keparahan masalah penyediaan.
NetworkSecurityPerimeterConfigurationIssueType	Jenis masalah penyediaan.
NetworkSecurityPerimeterConfigurationList	Daftar konfigurasi perimeter keamanan jaringan.
NetworkSecurityPerimeterConfigurationProfile	Konfigurasi Nsp dengan informasi profil.
NetworkSecurityPerimeterInfo	Info perimeter keamanan jaringan.
NetworkSecurityPerimeterProfileAccessRule	Aturan akses profil perimeter keamanan jaringan.
NetworkSecurityPerimeterProfileAccessRuleDirection	Arah aturan akses NSP.
NetworkSecurityPerimeterResourceType	Jenis sumber daya. Ini bisa berupa \'topics\', atau \'domains\'.
NetworkSecurityPerimeterSubscription	Aturan akses masuk langganan perimeter keamanan jaringan.
ResourceAssociation	Asosiasi sumber daya NSP
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

NetworkSecurityPerimeterAssociationAccessMode

Enumerasi

Mode akses perimeter keamanan jaringan.

Nilai	Deskripsi
Learning	Belajar
Enforced	Ditegakkan
Audit	Audit

NetworkSecurityPerimeterConfigProvisioningState

Enumerasi

Status provisi untuk mencerminkan status konfigurasi dan menunjukkan status pengambilan konfigurasi profil nsp.

Nilai	Deskripsi
Creating	Membuat
Updating	Memperbarui
Deleting	Menghapus
Succeeded	Berhasil
Canceled	Dibatalkan
Failed	Kegagalan
Deleted	Dihapus
Accepted	Diterima

NetworkSecurityPerimeterConfiguration

Objek

Konfigurasi perimeter keamanan jaringan.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties.networkSecurityPerimeter	NetworkSecurityPerimeterInfo	Info perimeter untuk asosiasi nsp.
properties.profile	NetworkSecurityPerimeterConfigurationProfile	Konfigurasi profil NSP, aturan akses, dan pengaturan diagnostik.
properties.provisioningIssues	NetworkSecurityPerimeterConfigurationIssues[]	Masalah provisi untuk mencerminkan status saat mencoba mengambil konfigurasi profil nsp.
properties.provisioningState	NetworkSecurityPerimeterConfigProvisioningState	Status provisi untuk mencerminkan status konfigurasi dan menunjukkan status pengambilan konfigurasi profil nsp.
properties.resourceAssociation	ResourceAssociation	Nama asosiasi NSP dan mode akses asosiasi.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

NetworkSecurityPerimeterConfigurationIssues

Objek

Masalah konfigurasi perimeter keamanan jaringan.

Nama	Jenis	Deskripsi
name	string	Nama masalah penyediaan.
properties.description	string	Deskripsi masalah penyediaan.
properties.issueType	NetworkSecurityPerimeterConfigurationIssueType	Jenis masalah penyediaan.
properties.severity	NetworkSecurityPerimeterConfigurationIssueSeverity	Tingkat keparahan masalah penyediaan.
properties.suggestedAccessRules	string[]	Aturan akses yang dapat ditambahkan ke profil yang sama untuk memperbaiki masalah.
properties.suggestedResourceIds	string[]	ID ARM sumber daya yang dapat dikaitkan ke perimeter yang sama untuk memulihkan masalah.

NetworkSecurityPerimeterConfigurationIssueSeverity

Enumerasi

Tingkat keparahan masalah penyediaan.

Nilai	Deskripsi
Warning	Peringatan
Error	Kesalahan

NetworkSecurityPerimeterConfigurationIssueType

Enumerasi

Jenis masalah penyediaan.

Nilai	Deskripsi
MissingPerimeterConfiguration	Konfigurasi Perimeter yang Hilang
MissingIdentityConfiguration	Konfigurasi Identitas yang Hilang
ConfigurationPropagationFailure	KonfigurasiPropagasiKegagalan
Other	Other

NetworkSecurityPerimeterConfigurationList

Objek

Daftar konfigurasi perimeter keamanan jaringan.

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	NetworkSecurityPerimeterConfiguration[]	Item NetworkSecurityPerimeterConfiguration di halaman ini

NetworkSecurityPerimeterConfigurationProfile

Objek

Konfigurasi Nsp dengan informasi profil.

Nama	Jenis	Deskripsi
accessRules	NetworkSecurityPerimeterProfileAccessRule[]	Daftar penyiapan aturan akses masuk atau keluar pada profil nsp.
accessRulesVersion	string	Aturan akses nomor versi untuk profil nsp.
diagnosticSettingsVersion	string	Nomor versi pengaturan diagnostik untuk profil nsp.
enabledLogCategories	string[]	Kategori log yang diaktifkan untuk profil nsp.
name	string	Nama profil konfigurasi NSP.

NetworkSecurityPerimeterInfo

Objek

Info perimeter keamanan jaringan.

Nama	Jenis	Deskripsi
id	string	ID lengan untuk perimeter keamanan jaringan.
location	string	Lokasi perimeter keamanan jaringan.
perimeterGuid	string	Panduan perimeter keamanan jaringan.

NetworkSecurityPerimeterProfileAccessRule

Objek

Aturan akses profil perimeter keamanan jaringan.

Nama	Jenis	Deskripsi
fullyQualifiedArmId	string	ID Arm yang Sepenuhnya Memenuhi Syarat untuk aturan akses profil perimeter keamanan jaringan.
name	string	Nama untuk aturan akses nsp.
properties.addressPrefixes	string[]	Awalan alamat.
properties.direction	NetworkSecurityPerimeterProfileAccessRuleDirection	Arah aturan akses NSP.
properties.emailAddresses	string[]	Daftar alamat email.
properties.fullyQualifiedDomainNames	string[]	Nama domain yang memenuhi syarat penuh.
properties.networkSecurityPerimeters	NetworkSecurityPerimeterInfo[]	Perimeter keamanan jaringan.
properties.phoneNumbers	string[]	Daftar nomor telepon.
properties.subscriptions	NetworkSecurityPerimeterSubscription[]	Daftar langganan.
type	string	Jenis aturan akses NSP.

NetworkSecurityPerimeterProfileAccessRuleDirection

Enumerasi

Arah aturan akses NSP.

Nilai	Deskripsi
Inbound	Masukan
Outbound	Outbound

NetworkSecurityPerimeterResourceType

Enumerasi

Jenis sumber daya. Ini bisa berupa \'topics\', atau \'domains\'.

Nilai	Deskripsi
topics	topics
domains	Domain

NetworkSecurityPerimeterSubscription

Objek

Aturan akses masuk langganan perimeter keamanan jaringan.

Nama	Jenis	Deskripsi
id	string	ID langganan.

ResourceAssociation

Objek

Asosiasi sumber daya NSP

Nama	Jenis	Deskripsi
accessMode	NetworkSecurityPerimeterAssociationAccessMode	Mode akses perimeter keamanan jaringan.
name	string	Nama asosiasi

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.