Network Security Perimeter Configurations - Get

Servizio:: Search Management

Versione API:: 2025-02-01-preview

Ottiene una configurazione perimetrale della sicurezza di rete.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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]*$	Nome della configurazione della sicurezza di rete.
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione corrente. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
searchServiceName	path	True	string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$	Nome del servizio Ricerca intelligenza artificiale di Azure associato al gruppo di risorse specificato.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
api-version	query	True	string	Versione dell'API da usare per ogni richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	NetworkSecurityPerimeterConfiguration	È stata recuperata correttamente la configurazione.
Other Status Codes	CloudError	Si è verificato un errore imprevisto durante l'operazione.

Sicurezza

azure_auth

Specifica un flusso di concessione implicita, come supportato in Microsoft Identity Platform.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get an NSP config by name

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
CloudError	Contiene informazioni su un errore dell'API.
CloudErrorBody	Descrive un particolare errore dell'API con un codice di errore e un messaggio.
NetworkSecurityPerimeterConfiguration	Configurazione del perimetro di sicurezza di rete per un server.
NSPConfigAccessRule	Regola di accesso per una configurazione perimetrale della sicurezza di rete.
NSPConfigAccessRuleProperties	Proprietà per le regole di accesso in una configurazione perimetrale della sicurezza di rete.
NSPConfigAssociation	Associazione di risorse per il perimetro di sicurezza di rete.
NSPConfigNetworkSecurityPerimeterRule	Proprietà del perimetro di sicurezza di rete presenti in una regola di configurazione.
NSPConfigPerimeter	Perimetro per una configurazione perimetrale della sicurezza di rete.
NSPConfigProfile	Profilo per una configurazione perimetrale della sicurezza di rete.
NSPProvisioningIssue	Oggetto per descrivere eventuali problemi relativi al provisioning dei perimetri di sicurezza di rete in un servizio di ricerca.
NSPProvisioningIssueProperties	Le proprietà per descrivere eventuali problemi relativi al provisioning dei perimetri di sicurezza di rete in un servizio di ricerca.

CloudError

Oggetto

Contiene informazioni su un errore dell'API.

Nome	Tipo	Descrizione
error	CloudErrorBody	Descrive un particolare errore dell'API con un codice di errore e un messaggio.
message	string	Breve descrizione dell'errore che indica cosa è andato storto (per informazioni dettagliate/debug fare riferimento alla proprietà 'error.message').

CloudErrorBody

Oggetto

Descrive un particolare errore dell'API con un codice di errore e un messaggio.

Nome	Tipo	Descrizione
code	string	Codice di errore che descrive più precisamente la condizione di errore rispetto a un codice di stato HTTP. Può essere usato per gestire casi di errore specifici a livello di codice.
details	CloudErrorBody[]	Contiene errori annidati correlati a questo errore.
message	string	Messaggio che descrive l'errore in dettaglio e fornisce informazioni di debug.
target	string	Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore.

NetworkSecurityPerimeterConfiguration

Oggetto

Configurazione del perimetro di sicurezza di rete per un server.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties.networkSecurityPerimeter	NSPConfigPerimeter	Perimetro per una configurazione perimetrale della sicurezza di rete.
properties.profile	NSPConfigProfile	Profilo per una configurazione perimetrale della sicurezza di rete.
properties.provisioningIssues	NSPProvisioningIssue[]	Oggetto per descrivere eventuali problemi relativi al provisioning dei perimetri di sicurezza di rete in un servizio di ricerca.
properties.provisioningState	string
properties.resourceAssociation	NSPConfigAssociation	Associazione di risorse per il perimetro di sicurezza di rete.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

NSPConfigAccessRule

Oggetto

Regola di accesso per una configurazione perimetrale della sicurezza di rete.

Nome	Tipo	Descrizione
name	string
properties	NSPConfigAccessRuleProperties	Proprietà per le regole di accesso in una configurazione perimetrale della sicurezza di rete.

NSPConfigAccessRuleProperties

Oggetto

Proprietà per le regole di accesso in una configurazione perimetrale della sicurezza di rete.

Nome	Tipo	Descrizione
addressPrefixes	string[]
direction	string
fullyQualifiedDomainNames	string[]
networkSecurityPerimeters	NSPConfigNetworkSecurityPerimeterRule[]	Proprietà del perimetro di sicurezza di rete presenti in una regola di configurazione.
subscriptions	string[]

NSPConfigAssociation

Oggetto

Associazione di risorse per il perimetro di sicurezza di rete.

Nome	Tipo	Descrizione
accessMode	string
name	string

NSPConfigNetworkSecurityPerimeterRule

Oggetto

Proprietà del perimetro di sicurezza di rete presenti in una regola di configurazione.

Nome	Tipo	Descrizione
id	string
location	string
perimeterGuid	string

NSPConfigPerimeter

Oggetto

Perimetro per una configurazione perimetrale della sicurezza di rete.

Nome	Tipo	Descrizione
id	string
location	string
perimeterGuid	string

NSPConfigProfile

Oggetto

Profilo per una configurazione perimetrale della sicurezza di rete.

Nome	Tipo	Descrizione
accessRules	NSPConfigAccessRule[]	Regola di accesso per una configurazione perimetrale della sicurezza di rete.
accessRulesVersion	string
name	string

NSPProvisioningIssue

Oggetto

Oggetto per descrivere eventuali problemi relativi al provisioning dei perimetri di sicurezza di rete in un servizio di ricerca.

Nome	Tipo	Descrizione
name	string
properties	NSPProvisioningIssueProperties	Le proprietà per descrivere eventuali problemi relativi al provisioning dei perimetri di sicurezza di rete in un servizio di ricerca.

NSPProvisioningIssueProperties

Oggetto

Le proprietà per descrivere eventuali problemi relativi al provisioning dei perimetri di sicurezza di rete in un servizio di ricerca.

Nome	Tipo	Descrizione
description	string
issueType	string
severity	string
suggestedAccessRules	string[]
suggestedResourceIds	string[]