Network Security Perimeter Configurations - Get

Hizmet:: Search Management

API Sürümü:: 2025-05-01

Ağ güvenlik çevresi yapılandırmasını alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/networkSecurityPerimeterConfigurations/{nspConfigName}?api-version=2025-05-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
nspConfigName	path	True	string minLength: 38 maxLength: 100 pattern: ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}\.[a-z][a-z0-9]*$	Ağ güvenlik çevre yapılandırma adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
searchServiceName	path	True	string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$	Belirtilen kaynak grubuyla ilişkili Azure AI Search hizmetinin adı.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	NetworkSecurityPerimeterConfiguration	Azure işlemi başarıyla tamamlandı.
Other Status Codes	CloudError	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Get an NSP config by name

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1?api-version=2025-05-01

package armsearch_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/search/armsearch/v2"
)

// Generated from example definition: 2025-05-01/NetworkSecurityPerimeterConfigurationsGet.json
func ExampleNetworkSecurityPerimeterConfigurationsClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armsearch.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewNetworkSecurityPerimeterConfigurationsClient().Get(ctx, "rg1", "mysearchservice", "00000001-2222-3333-4444-111144444444.assoc1", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armsearch.NetworkSecurityPerimeterConfigurationsClientGetResponse{
	// 	NetworkSecurityPerimeterConfiguration: &armsearch.NetworkSecurityPerimeterConfiguration{
	// 		Name: to.Ptr("00000001-2222-3333-4444-111144444444.assoc1"),
	// 		Type: to.Ptr("Microsoft.Search/searchServices/networkSecurityPerimeterConfigurations"),
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1"),
	// 		Properties: &armsearch.NetworkSecurityPerimeterConfigurationProperties{
	// 			NetworkSecurityPerimeter: &armsearch.NetworkSecurityPerimeter{
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/networkRG/providers/Microsoft.Network/networkSecurityPerimeters/perimeter1"),
	// 				Location: to.Ptr("westus"),
	// 			},
	// 			Profile: &armsearch.NetworkSecurityProfile{
	// 				Name: to.Ptr("profile1"),
	// 				AccessRules: []*armsearch.AccessRule{
	// 					{
	// 						Name: to.Ptr("rule1"),
	// 						Properties: &armsearch.AccessRuleProperties{
	// 							AddressPrefixes: []*string{
	// 								to.Ptr("148.0.0.0/8"),
	// 								to.Ptr("152.4.6.0/24"),
	// 							},
	// 							Direction: to.Ptr(armsearch.AccessRuleDirectionInbound),
	// 						},
	// 					},
	// 				},
	// 				AccessRulesVersion: to.Ptr[int32](0),
	// 			},
	// 			ProvisioningState: to.Ptr(armsearch.NetworkSecurityPerimeterConfigurationProvisioningStateAccepted),
	// 			ResourceAssociation: &armsearch.ResourceAssociation{
	// 				Name: to.Ptr("assoc1"),
	// 				AccessMode: to.Ptr(armsearch.ResourceAssociationAccessModeEnforced),
	// 			},
	// 		},
	// 	},
	// }
}

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

Örnek yanıt

Durum kodu:: 200

{
  "name": "00000001-2222-3333-4444-111144444444.assoc1",
  "type": "Microsoft.Search/searchServices/networkSecurityPerimeterConfigurations",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/networkSecurityPerimeterConfigurations/00000001-2222-3333-4444-111144444444.assoc1",
  "properties": {
    "networkSecurityPerimeter": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/networkRG/providers/Microsoft.Network/networkSecurityPerimeters/perimeter1",
      "location": "westus"
    },
    "profile": {
      "name": "profile1",
      "accessRules": [
        {
          "name": "rule1",
          "properties": {
            "addressPrefixes": [
              "148.0.0.0/8",
              "152.4.6.0/24"
            ],
            "direction": "Inbound"
          }
        }
      ],
      "accessRulesVersion": 0
    },
    "provisioningState": "Accepted",
    "resourceAssociation": {
      "name": "assoc1",
      "accessMode": "Enforced"
    }
  }
}

Tanımlar

Name	Description
AccessRule	Ağ güvenlik çevre yapılandırma profilinde erişim kuralı
AccessRuleDirection	Erişim Kuralının Yönü
AccessRuleProperties	Erişim Kuralının Özellikleri
CloudError	API hatası hakkında bilgi içerir.
CloudErrorBody	Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
createdByType	Kaynağı oluşturan kimliğin türü.
IssueType	Sorun türü
NetworkSecurityPerimeter	Ağ güvenlik çevresi (NSP) hakkında bilgi
NetworkSecurityPerimeterConfiguration	Ağ güvenlik çevresi (NSP) yapılandırma kaynağı
NetworkSecurityPerimeterConfigurationProperties	Ağ güvenliği yapılandırma özellikleri.
NetworkSecurityPerimeterConfigurationProvisioningState	Oluşturulan veya güncelleştirilen bir ağ güvenlik çevre yapılandırmasının sağlama durumu.
NetworkSecurityProfile	Ağ güvenliği çevre yapılandırma profili
ProvisioningIssue	Ağ güvenlik çevre yapılandırması için bir sağlama sorunu açıklanır
ProvisioningIssueProperties	Ağ güvenlik çevresi (NSP) yapılandırması için sağlama sorununun ayrıntıları. Kaynak sağlayıcıları, algılanan her ayrı sorun için ayrı sağlama sorunu öğeleri oluşturmalı ve anlamlı ve ayırt edici bir açıklamanın yanı sıra uygun önerilenResourceId'ler ve suggestedAccessRules içermelidir
ResourceAssociation	Kaynak ilişkilendirme hakkında bilgi
ResourceAssociationAccessMode	Kaynak ilişkisinin erişim modu
Severity	Sorunun önem derecesi.
Subscriptions	Gelen kuralları için abonelikler
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

AccessRule

Nesne

Ağ güvenlik çevre yapılandırma profilinde erişim kuralı

Name	Tür	Description
name	string	Erişim kuralının adı
properties	AccessRuleProperties	Erişim Kuralının Özellikleri

AccessRuleDirection

Numaralandırma

Erişim Kuralının Yönü

Değer	Description
Inbound	Güvenli kaynaklara gelen ağ trafiği için geçerlidir.
Outbound	Güvenli kaynaklardan giden ağ trafiği için geçerlidir

AccessRuleProperties

Nesne

Erişim Kuralının Özellikleri

Name	Tür	Description
addressPrefixes	string[]	Gelen kurallar için CIDR biçiminde ön ekleri adresle
direction	AccessRuleDirection	Erişim Kuralının Yönü
emailAddresses	string[]	Giden kuralları için e-posta adresleri
fullyQualifiedDomainNames	string[]	Giden kuralları için tam etki alanı adları (FQDN)
networkSecurityPerimeters	NetworkSecurityPerimeter[]	Gelen kurallar için ağ güvenlik çevreleri
phoneNumbers	string[]	Giden kuralları için telefon numaraları
subscriptions	Subscriptions[]	Gelen kuralları için abonelikler

CloudError

Nesne

API hatası hakkında bilgi içerir.

Name	Tür	Description
error	CloudErrorBody	Hata kodu ve ileti içeren belirli bir API hatası açıklanır.
message	string	Neyin yanlış gittiğini gösteren hatanın kısa bir açıklaması (ayrıntılar/hata ayıklama bilgileri için 'error.message' özelliğine bakın).

CloudErrorBody

Nesne

Hata kodu ve ileti içeren belirli bir API hatası açıklanır.

Name	Tür	Description
code	string	Http durum kodundan daha kesin bir şekilde hata koşulunu açıklayan bir hata kodu. Belirli hata durumlarını program aracılığıyla işlemek için kullanılabilir.
details	CloudErrorBody[]	Bu hatayla ilgili iç içe yerleştirilmiş hatalar içerir.
message	string	Hatayı ayrıntılı olarak açıklayan ve hata ayıklama bilgileri sağlayan bir ileti.
target	string	Belirli bir hatanın hedefi (örneğin, hatadaki özelliğin adı).

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

IssueType

Numaralandırma

Sorun türü

Değer	Description
Unknown	Bilinmeyen sorun türü
ConfigurationPropagationFailure	Ağ güvenlik çevresi (NSP) yapılandırması uygulanırken bir hata oluştu.
MissingPerimeterConfiguration	Kaynakta, ağ güvenlik çevresine (NSP) yeni kaynaklar eklenerek veya erişim kuralları değiştirilerek giderilebilen bir ağ bağlantısı sorunu yaşanıyor.
MissingIdentityConfiguration	Yönetilen kimlik kaynakla ilişkilendirilmemiş. Kaynak, ağ güvenlik çevresinden (NSP) gelen trafiği veya eşleşen gelen erişim kurallarını doğrulamaya devam eder, ancak NSP'nin bir üyesi olarak giden erişim gerçekleştiremez.

NetworkSecurityPerimeter

Nesne

Ağ güvenlik çevresi (NSP) hakkında bilgi

Name	Tür	Description
id	string (arm-id)	NSP kaynağının tam Azure kaynak kimliği
location	string	Ağ güvenlik çevresinin konumu
perimeterGuid	string (uuid)	Ağ güvenlik çevresinin evrensel benzersiz kimliği (UUID)

NetworkSecurityPerimeterConfiguration

Nesne

Ağ güvenlik çevresi (NSP) yapılandırma kaynağı

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties	NetworkSecurityPerimeterConfigurationProperties	Ağ güvenliği yapılandırma özellikleri.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

NetworkSecurityPerimeterConfigurationProperties

Nesne

Ağ güvenliği yapılandırma özellikleri.

Name	Tür	Description
networkSecurityPerimeter	NetworkSecurityPerimeter	Ağ güvenlik çevresi (NSP) hakkında bilgi
profile	NetworkSecurityProfile	Ağ güvenliği çevre yapılandırma profili
provisioningIssues	ProvisioningIssue[]	Varsa sağlama sorunlarının listesi
provisioningState	NetworkSecurityPerimeterConfigurationProvisioningState	Oluşturulan veya güncelleştirilen bir ağ güvenlik çevre yapılandırmasının sağlama durumu.
resourceAssociation	ResourceAssociation	Kaynak ilişkilendirme hakkında bilgi

NetworkSecurityPerimeterConfigurationProvisioningState

Numaralandırma

Oluşturulan veya güncelleştirilen bir ağ güvenlik çevre yapılandırmasının sağlama durumu.

Değer	Description
Succeeded
Creating
Updating
Deleting
Accepted
Failed
Canceled

NetworkSecurityProfile

Nesne

Ağ güvenliği çevre yapılandırma profili

Name	Tür	Description
accessRules	AccessRule[]	Erişim Kuralları Listesi
accessRulesVersion	integer (int32)	Geçerli erişim kuralları sürümü
diagnosticSettingsVersion	integer (int32)	Geçerli tanılama ayarları sürümü
enabledLogCategories	string[]	Etkinleştirilen günlük kategorilerinin listesi
name	string	Profilin adı

ProvisioningIssue

Nesne

Ağ güvenlik çevre yapılandırması için bir sağlama sorunu açıklanır

Name	Tür	Description
name	string	Sorunun adı
properties	ProvisioningIssueProperties	Ağ güvenlik çevresi (NSP) yapılandırması için sağlama sorununun ayrıntıları. Kaynak sağlayıcıları, algılanan her ayrı sorun için ayrı sağlama sorunu öğeleri oluşturmalı ve anlamlı ve ayırt edici bir açıklamanın yanı sıra uygun önerilenResourceId'ler ve suggestedAccessRules içermelidir

ProvisioningIssueProperties

Nesne

Ağ güvenlik çevresi (NSP) yapılandırması için sağlama sorununun ayrıntıları. Kaynak sağlayıcıları, algılanan her ayrı sorun için ayrı sağlama sorunu öğeleri oluşturmalı ve anlamlı ve ayırt edici bir açıklamanın yanı sıra uygun önerilenResourceId'ler ve suggestedAccessRules içermelidir

Name	Tür	Description
description	string	Sorunun açıklaması
issueType	IssueType	Sorun türü
severity	Severity	Sorunun önem derecesi.
suggestedAccessRules	AccessRule[]	Sorunu gidermek için ağ güvenlik profiline (NSP) eklenebilecek erişim kuralları.
suggestedResourceIds	string[] (arm-id)	Sorunu düzeltmek için ağ güvenlik çevresi (NSP) ile ilişkilendirilebilen önerilen kaynakların tam kaynak kimlikleri.

ResourceAssociation

Nesne

Kaynak ilişkilendirme hakkında bilgi

Name	Tür	Description
accessMode	ResourceAssociationAccessMode	Kaynak ilişkisinin erişim modu
name	string	Kaynak ilişkisinin adı

ResourceAssociationAccessMode

Numaralandırma

Kaynak ilişkisinin erişim modu

Değer	Description
Enforced	Zorunlu erişim modu - Başarısız erişim denetimlerinin başarısız olduğu kaynağa gelen trafik engellendi
Learning	Öğrenme erişim modu - kaynağa yönelik trafik analiz için etkinleştirildi ancak engellenmedi
Audit	Denetim erişim modu - Erişim denetimlerinin başarısız olduğu kaynağa gelen trafik günlüğe kaydedilir ancak engellenmez

Severity

Numaralandırma

Sorunun önem derecesi.

Değer	Description
Warning
Error

Subscriptions

Nesne

Gelen kuralları için abonelikler

Name	Tür	Description
id	string (arm-id)	Aboneliğin tam Azure kaynak kimliği ('/subscriptions/00000000-0000-0000-0000-0000-00000000000000')

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.