Stabilire connessioni in uscita tramite un collegamento privato condiviso

Articolo
11/19/2024

Questo articolo illustra come configurare le chiamate private e in uscita da Ricerca di intelligenza artificiale di Azure a una risorsa di Azure eseguita all'interno di una rete virtuale di Azure.

La configurazione di una connessione privata consente a un servizio di ricerca di connettersi a un indirizzo IP di rete virtuale anziché a una porta aperta a Internet. L'oggetto creato per la connessione è denominato collegamento privato condiviso. Nella connessione, il servizio di ricerca usa internamente il collegamento privato condiviso per raggiungere una risorsa di Azure all'interno del limite di rete.

Il collegamento privato condiviso è una funzionalità Premium fatturata in base all'utilizzo. Quando si configura un collegamento privato condiviso, gli addebiti per l'endpoint privato vengono aggiunti alla fattura di Azure. Quando si usa il collegamento privato condiviso, vengono fatturate anche le tariffe di trasferimento dei dati per l'accesso in ingresso e in uscita. Per informazioni dettagliate, vedere Prezzi di Collegamento privato di Azure.

Nota

Se si configura una connessione dell'indicizzatore privato a un'istanza gestita di SQL, vedere invece questo articolo per i passaggi specifici del tipo di risorsa.

Quando usare un collegamento privato condiviso

Ricerca di intelligenza artificiale di Azure effettua chiamate in uscita ad altre risorse di Azure negli scenari seguenti:

Connessioni dell'indicizzatore o del motore di ricerca ad Azure OpenAI per incorporamenti da testo a vettore
Connessioni dell'indicizzatore a origini dati supportate
Connessioni dell'indicizzatore (set di competenze) ad Archiviazione di Azure per l'arricchimento nella cache, lo stato della sessione di debug o la scrittura in un archivio conoscenze
Connessioni dell'indicizzatore (set di competenze) ai servizi di intelligenza artificiale di Azure per scopi di fatturazione
Richieste di chiavi di crittografia ad Azure Key Vault
Richieste di competenze personalizzate a Funzioni di Azure o a una risorsa simile

I collegamenti privati condivisi funzionano solo per le connessioni da Azure ad Azure. Se ci si connette a OpenAI o a un altro modello esterno, la connessione deve trovarsi su Internet pubblico.

I collegamenti privati condivisi sono destinati alle operazioni e ai dati a cui si accede tramite un endpoint privato per le risorse di Azure o i client eseguiti in una rete virtuale di Azure.

Un collegamento privato condiviso è:

Creato con gli strumenti, le API o gli SDK di Ricerca intelligenza artificiale di Azure
Approvato dal proprietario della risorsa di Azure
Usato internamente da Ricerca di intelligenza artificiale di Azure in una connessione privata a una risorsa di Azure specifica

Solo il servizio di ricerca può usare i collegamenti privati creati e nel servizio può essere creato un solo collegamento privato condiviso per ogni combinazione di risorsa e sottorisorsa.

Dopo aver configurato il collegamento privato, viene usato automaticamente ogni volta che il servizio di ricerca si connette a tale risorsa. Non è necessario modificare il stringa di connessione o modificare il client usato per inviare le richieste, anche se il dispositivo usato per la connessione deve connettersi usando un indirizzo IP autorizzato nel firewall della risorsa di Azure.

Esistono due scenari per l'uso di collegamento privato di Azure e Ricerca di intelligenza artificiale di Azure insieme.

Scenario uno: creare un collegamento privato condiviso quando una connessione in uscita (indicizzatore) ad Azure richiede una connessione privata.
Scenario due: configurare la ricerca di una connessione in ingresso privata dai client eseguiti in una rete virtuale.

Lo scenario 1 è illustrato in questo articolo.

Sebbene entrambi gli scenari abbiano una dipendenza dal collegamento privato di Azure, sono indipendenti. È possibile creare un collegamento privato condiviso senza dover configurare il proprio servizio di ricerca per un endpoint privato.

Limiti

Quando si valutano collegamenti privati condivisi per lo scenario, tenere presente questi vincoli.

Diversi tipi di risorse usati in un collegamento privato condiviso sono disponibili in anteprima. Se ci si connette a una risorsa di anteprima (Database di Azure per MySQL o Istanza gestita di SQL di Azure), usare una versione di anteprima dell'API REST di gestione per creare il collegamento privato condiviso. Queste versioni includono 2020-08-01-preview, 2021-04-01-preview, 2024-03-01-preview e 2024-06-01-preview. È consigliabile usare l'API di anteprima più recente.
L'esecuzione dell'indicizzatore deve usare l'ambiente di esecuzione privato specifico del servizio di ricerca. Le connessioni endpoint private non sono supportate dall'ambiente di elaborazione del contenuto multi-tenant. L'impostazione di configurazione per questo requisito è descritta in questo articolo.
Esaminare i limiti delle risorse di collegamento privato condiviso per ogni livello.

Prerequisiti

Una risorsa di Azure supportata, configurata per l'esecuzione in una rete virtuale.

Un'servizio di ricerca di intelligenza artificiale di Azure con requisiti di livello e area, in base al carico di lavoro:

Carico di lavoro	Requisiti di livello	Requisiti dell'area geografica	Requisiti di creazione del servizio
Indicizzatori senza set di competenze	Basic e versioni successive	None	None
Set di competenze con competenze di incorporamento (vettorializzazione integrata)	Basic e versioni successive	Aree con capacità elevata	Dopo il 3 aprile 2024
Set di competenze che usano altre competenze predefinite o personalizzate	Standard 2 (S2) e versioni successive	None	Dopo il 3 aprile 2024

Autorizzazioni sia per Ricerca di intelligenza artificiale di Azure che per la risorsa di Azure:

Conto risorse	Autorizzazioni
Azure AI Search	`Microsoft.Search/searchServices/sharedPrivateLinkResources/write` `Microsoft.Search/searchServices/sharedPrivateLinkResources/read` `Microsoft.Search/searchServices/sharedPrivateLinkResources/operationStatuses/read`
Altra risorsa di Azure	Autorizzazione per approvare le connessioni dell'endpoint privato. Ad esempio, in Archiviazione di Azure è necessario `Microsoft.Storage/storageAccounts/privateEndpointConnectionsApproval/action`.

Tipi di risorsa supportati

È possibile creare un collegamento privato condiviso per le risorse seguenti.

Tipo di risorsa	Sottorisorsa (o ID gruppo)
Microsoft.Storage/storageAccounts ¹	`blob`, `table`, `dfsfile`
Microsoft.DocumentDB/databaseAccounts ²	`Sql`
Microsoft.Sql/servers ³	`sqlServer`
Microsoft.KeyVault/vaults	`vault`
Microsoft.DBforMySQL/servers (anteprima)	`mysqlServer`
Microsoft.Web/sites ⁴	`sites`
Microsoft.Sql/managedInstances (anteprima) ⁵	`managedInstance`
Microsoft.CognitiveServices/accounts ⁶ ⁷	`openai_account`
Microsoft.CognitiveServices/accounts ⁸	`cognitiveservices_account`

¹ Se Archiviazione di Azure e Ricerca di intelligenza artificiale di Azure si trovano nella stessa area, la connessione all'archiviazione viene stabilita tramite la rete backbone Microsoft, il che significa che un collegamento privato condiviso è ridondante per questa configurazione. Tuttavia, se è già stato configurato un endpoint privato per Archiviazione di Azure, è necessario configurare anche un collegamento privato condiviso o la connessione viene rifiutata sul lato di archiviazione. Inoltre, se si usano più formati di archiviazione per vari scenari di ricerca, assicurarsi di creare un collegamento privato condiviso separato per ogni sottorisorsa.

² Il tipo di risorsa Microsoft.DocumentDB/databaseAccounts viene usato per le connessioni dell'indicizzatore ad Azure Cosmos DB per NoSQL. Il nome del provider e l'ID gruppo fanno distinzione tra maiuscole e minuscole.

³ Il tipo di risorsa Microsoft.Sql/servers viene usato per le connessioni al database SQL di Azure. Attualmente non è disponibile alcun supporto per un collegamento privato condiviso ad Azure Synapse SQL.

⁴ Il tipo di risorsa Microsoft.Web/sites viene usato per il servizio app e le funzioni di Azure. Nel contesto di Ricerca di intelligenza artificiale di Azure, una funzione di Azure è lo scenario più probabile. Una funzione di Azure viene comunemente usata per ospitare la logica di una competenza personalizzata. La funzione di Azure include piani di hosting del servizio app A consumo, Premium e Dedicato. L'ambiente del servizio app (ASE), il servizio Azure Kubernetes (AKS) e Gestione API di Azure non sono attualmente supportati.

⁵ Per istruzioni, vedere Creare un collegamento privato condiviso per un'istanza gestita di SQL.

⁶ Il Microsoft.CognitiveServices/accounts tipo di risorsa viene usato per le connessioni vettoriali e indicizzatori ai modelli di incorporamento OpenAI di Azure quando si implementa la vettorializzazione integrata. A partire dal 19 novembre 2024, è ora disponibile il supporto per il collegamento privato condiviso per l'incorporamento di modelli nel catalogo dei modelli di Azure AI Studio o per l'API multi-visione artificiale di Azure.

⁷ Il collegamento privato condiviso per Azure OpenAI è supportato solo nel cloud pubblico. Altre offerte cloud, ad esempio Microsoft Azure per enti pubblici non dispongono del supporto per i collegamenti privati condivisi per openai_account l'ID gruppo.

⁸ I collegamenti privati condivisi sono ora supportati (a partire da novembre 2024) per le connessioni agli account multiservizio di Azure per intelligenza artificiale. Ricerca di intelligenza artificiale di Azure si connette al multiservizio di Intelligenza artificiale di Azure per scopi di fatturazione. Queste connessioni possono ora essere private tramite un collegamento privato condiviso.

1 - Creare un collegamento privato condiviso

Usare il portale di Azure, l'API REST di gestione, l'interfaccia della riga di comando di Azure o Azure PowerShell per creare un collegamento privato condiviso.

Di seguito sono riportati alcuni suggerimenti:

Assegnare un nome significativo al collegamento privato. Nella risorsa PaaS di Azure viene visualizzato un collegamento privato condiviso insieme ad altri endpoint privati. Un nome come "link-privato-condiviso-per-search" può ricordare come viene usato.

Quando si completano i passaggi di questa sezione, si dispone di un collegamento privato condiviso di cui è stato effettuato il provisioning in uno stato in sospeso. La creazione del collegamento richiede alcuni minuti. Una volta creato, il proprietario della risorsa deve approvare la richiesta affinché sia operativa.

Accedere al portale di Azure e trovare il servizio di ricerca.
Nel riquadro di spostamento a sinistra, in Impostazioni selezionare Rete.
Nella pagina accesso privato condiviso selezionare + Aggiungi accesso privato condiviso.
Selezionare Connettersi a una risorsa di Azure nella directory o Connettersi a una risorsa di Azure in base all'ID risorsa.
Se si seleziona la prima opzione (scelta consigliata), il portale consente di selezionare la risorsa di Azure appropriata e di compilare altre proprietà, ad esempio l'ID gruppo della risorsa e il tipo di risorsa.
Se si seleziona la seconda opzione, immettere manualmente l'ID risorsa di Azure e scegliere l'ID gruppo appropriato dall'elenco all'inizio di questo articolo.
Verificare che lo stato del provisioning sia "In aggiornamento".
Dopo aver creato la risorsa, lo stato di provisioning della risorsa viene modificato in "Completato".

Nota

Le versioni dell'API di anteprima sono necessarie per gli ID gruppo in anteprima. I tipi di risorse seguenti sono disponibili in anteprima: managedInstance, mySqlServer, sites.

Anche se gli strumenti come il portale di Azure, Azure PowerShell o l'interfaccia della riga di comando di Azure dispongono di meccanismi predefiniti per l'accesso all'account, un client REST deve fornire un token di connessione che consenta di eseguire la richiesta.

Poiché è semplice e veloce, questa sezione usa i passaggi dell'interfaccia della riga di comando di Azure per ottenere un token di connessione. Per approcci più durevoli, vedere Gestire con REST.

Aprire una riga di comando ed eseguire az login per l'accesso ad Azure.
Mostrare l'account e la sottoscrizione attivi. Verificare che questa sottoscrizione sia la stessa che ha la risorsa PaaS di Azure per cui si sta creando il collegamento privato condiviso.
```
az account show
```
Modificare la sottoscrizione se non è quella corretta:
```
az account set --subscription {{Azure PaaS subscription ID}}
```
Creare un token di connessione e quindi copiare l'intero token (tutti gli elementi tra virgolette).
```
az account get-access-token
```

Passare a un client REST e configurare una risorsa di collegamento privato condiviso GET. Esaminare i collegamenti privati condivisi esistenti per assicurarsi di non duplicare un collegamento. Per ogni combinazione di risorse e sottorisorse può essere presente un solo collegamento privato condiviso.

@subscriptionId = PASTE-HERE
@rg-name = PASTE-HERE
@service-name = PASTE-HERE
@token = PASTE-TOKEN-HERE

GET https://https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{rg-name}}/providers/Microsoft.Search/searchServices/{{service-name}}/sharedPrivateLinkResources?api-version=2023-11-01 HTTP/1.1
  Content-type: application/json
  Authorization: Bearer {{token}}

Inviare la richiesta. Dovrebbe essere visualizzato un elenco di tutte le risorse di collegamento privato condivise esistenti per il servizio di ricerca. Assicurarsi che non sia presente alcun collegamento privato condiviso esistente per la combinazione di risorsa e sottorisorsa.

Formulare una richiesta PUT per Creare o aggiornare il collegamento privato condiviso per la risorsa PaaS di Azure.

PUT https://https://management.azure.com/subscriptions/{{subscriptionId}}/resourceGroups/{{rg-name}}/providers/Microsoft.Search/searchServices/{{service-name}}/sharedPrivateLinkResources/{{shared-private-link-name}}?api-version=2023-11-01 HTTP/1.1
  Content-type: application/json
  Authorization: Bearer {{token}}

{
    "properties":
     {
        "groupID": "blob",
        "privateLinkResourceId": "/subscriptions/{{subscriptionId}}/resourceGroups/{{rg-name}}/providers/Microsoft.Storage/storageAccounts/{{storage-account-name}}",
        "provisioningState": "",
        "requestMessage": "Please approve this request.",
        "resourceRegion": "",
        "status": ""
     }
}

Se la risorsa PaaS di Azure si trova in una sottoscrizione diversa, usare l'interfaccia della riga di comando di Azure per modificare la sottoscrizione e quindi ottenere un token di connessione valido per tale sottoscrizione:

az account set --subscription {{Azure PaaS subscription ID}}

az account get-access-token

Inviare la richiesta. Per controllare lo stato, eseguire di nuovo la prima richiesta GET di collegamento privato condiviso per monitorare lo stato di provisioning durante la transizione dall'aggiornamento a riuscito.

Per istruzioni su come iniziare, vedere Gestire con PowerShell.

Prima di tutto, usare Get-AzSearchSharedPrivateLinkResource per esaminare eventuali collegamenti privati condivisi esistenti per assicurarsi di non duplicare un collegamento. Per ogni combinazione di risorse e sottorisorse può essere presente un solo collegamento privato condiviso.

Get-AzSearchSharedPrivateLinkResource -ResourceGroupName <search-service-resource-group-name> -ServiceName <search-service-name>

Usare New-AzSearchSharedPrivateLinkResource per creare un collegamento privato condiviso, sostituendo i valori validi per i segnaposto. Questo esempio è relativo all'archiviazione BLOB.

New-AzSearchSharedPrivateLinkResource -ResourceGroupName <search-service-resource-group-name> -ServiceName <search-service-name> -Name <spl-name> -PrivateLinkResourceId /subscriptions/<alphanumeric-subscription-ID>/resourceGroups/<storage-resource-group-name>/providers/Microsoft.Storage/storageAccounts/myBlobStorage -GroupId blob -RequestMessage "Please approve"

Eseguire di nuovo la prima richiesta per monitorare lo stato di provisioning durante la transizione dall'aggiornamento a riuscito.

Per istruzioni su come iniziare, vedere Gestire con l'interfaccia della riga di comando di Azure.

Usare prima di tutto az-search-shared-private-link-resource list per esaminare eventuali collegamenti privati condivisi esistenti per assicurarsi di non duplicare un collegamento. Per ogni combinazione di risorse e sottorisorse può essere presente un solo collegamento privato condiviso.

az search shared-private-link-resource list --service-name {{your-search-service-name}} --resource-group {{your-search-service-resource-group}}

Usare az-search-shared-private-link-resource create per il passaggio successivo. Questo esempio è per Azure Cosmos DB per NoSQL.

La sintassi fa distinzione tra maiuscole e minuscole, quindi assicurarsi che l'ID gruppo sia Sql e che il nome del provider sia Microsoft.DocumentDB.

az search shared-private-link-resource create --name {{your-shared-private-link-name}} --service-name {{your-search-service-name}} --resource-group {{your-search-service-resource-group}} --group-id Sql --resource-id "/subscriptions/{{your-subscription-ID}}/{{your-cosmos-db-resource-group}}/providers/Microsoft.DocumentDB/databaseAccounts/{{your-cosmos-db-account-name}}"

Eseguire di nuovo la prima richiesta per monitorare lo stato di provisioning durante la transizione dall'aggiornamento a riuscito.

Flusso di lavoro di creazione di collegamenti privati condivisi

Viene restituita una risposta 202 Accepted in caso di esito positivo. Il processo di creazione di un endpoint privato in uscita è un'operazione a esecuzione prolungata (asincrona). Comporta la distribuzione delle risorse seguenti:

Endpoint privato, allocato con un indirizzo IP privato in uno stato "Pending". L'indirizzo IP privato viene ottenuto dallo spazio indirizzi allocato alla rete virtuale dell'ambiente di esecuzione per l'indicizzatore privato specifico del servizio di ricerca. Dopo l'approvazione dell'endpoint privato, qualsiasi comunicazione da Ricerca di intelligenza artificiale di Azure alla risorsa di Azure proviene dall'indirizzo IP privato e da un canale di collegamento privato sicuro.
Zona DNS privata per il tipo di risorsa, in base all'ID gruppo. Distribuendo questa risorsa, assicurarsi che qualsiasi ricerca DNS nella risorsa privata usi l'indirizzo IP associato all'endpoint privato.

2 - Approvare la connessione endpoint privato

L'approvazione della connessione all'endpoint privato viene concessa sul lato PaaS di Azure. È necessaria l'approvazione esplicita da parte del proprietario della risorsa. I passaggi seguenti illustrano l'approvazione usando il portale di Azure, ma ecco alcuni collegamenti per approvare la connessione a livello di codice dal lato PaaS di Azure:

In Archiviazione di Azure usare le connessioni endpoint private - Put
In Azure Cosmos DB usare le connessioni endpoint private - Creare o aggiornare
In Azure OpenAI usare le connessioni endpoint private - Creare o aggiornare

Usando il portale di Azure, seguire questa procedura:

Aprire la pagina Rete della risorsa PaaS di Azure.testo
Trovare la sezione in cui sono elencate le connessioni dell'endpoint privato. L'esempio seguente è relativo a un account di archiviazione.
Selezionare la connessione e quindi Approva. L'aggiornamento dello stato nel portale può richiedere alcuni minuti.

Dopo l'approvazione dell'endpoint privato, Azure AI Search crea i mapping di zona DNS necessari nella zona DNS creata.

Anche se il collegamento all'endpoint privato nella pagina Rete è attivo, non verrà risolto.

La selezione del collegamento genera un errore. Viene visualizzato un messaggio di stato di "The access token is from the wrong issuer" e must match the tenant associated with this subscription perché viene effettuato il provisioning della risorsa endpoint privato back-end da Microsoft in un tenant gestito da Microsoft, mentre la risorsa collegata (Ricerca intelligenza artificiale di Azure) si trova nel tenant. Per impostazione predefinita, non è possibile accedere alla risorsa endpoint privato selezionando il collegamento di connessione all'endpoint privato.

Seguire le istruzioni nella sezione successiva per controllare lo stato del collegamento privato condiviso.

3 - Controllare lo stato del collegamento privato condiviso

Lato Azure AI Search è possibile confermare l'approvazione della richiesta rivedendo la pagina Accesso privato condiviso della pagina Rete del servizio di ricerca. Lo stato della connessione dovrebbe essere approvato.

In alternativa, è anche possibile ottenere lo stato della connessione usando le risorse collegamento privato condiviso - Ottieni.

az rest --method get --uri https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/contoso/providers/Microsoft.Search/searchServices/contoso-search/sharedPrivateLinkResources/blob-pe?api-version=2024-07-01

Verrà restituito un codice JSON, in cui lo stato della connessione viene visualizzato come "status" nella sezione "proprietà". Di seguito è riportato un esempio per un account di archiviazione.

{
      "name": "blob-pe",
      "properties": {
        "privateLinkResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/contoso/providers/Microsoft.Storage/storageAccounts/contoso-storage",
        "groupId": "blob",
        "requestMessage": "please approve",
        "status": "Approved",
        "resourceRegion": null,
        "provisioningState": "Succeeded"
      }
}

Se lo stato di provisioning (properties.provisioningState) della risorsa è "Completato" e lo stato di connessione (properties.status) è "Approvato", significa che la risorsa collegamento privato condiviso è funzionale e l'indicizzatore può essere configurato per comunicare tramite l'endpoint privato.

4 - Configurare l'indicizzatore per l'esecuzione nell'ambiente privato

L’esecuzione dell'indicizzatore avviene in un ambiente privato specifico del servizio di ricerca o in un ambiente multi-tenant usato internamente per eseguire l'offload di costose elaborazioni del set di competenze per più clienti.

L'ambiente di esecuzione è trasparente, ma dopo aver iniziato a creare regole del firewall o stabilire connessioni private, è necessario tenere conto dell'esecuzione dell'indicizzatore. Per una connessione privata, configurare l'esecuzione dell'indicizzatore per l'esecuzione sempre nell'ambiente privato.

Questo passaggio illustra come configurare l'indicizzatore per l'esecuzione nell'ambiente privato usando l'API REST. È anche possibile impostare l'ambiente di esecuzione usando l'editor JSON nel portale.

Nota

È possibile eseguire questo passaggio prima dell'approvazione della connessione all'endpoint privato. Tuttavia, finché la connessione all'endpoint privato non viene visualizzata come approvata, qualsiasi indicizzatore esistente che tenta di comunicare con una risorsa sicura (ad esempio l'account di archiviazione) finirà in uno stato di errore temporaneo e non verranno creati nuovi indicizzatori.

Creare la definizione, l'indice e il set di competenze dell'origine dati (se ne usi uno) come normalmente. Non esistono proprietà in nessuna di queste definizioni che variano quando si usa un endpoint privato condiviso.
Creare un indicizzatore che punti all'origine dati, all'indice e al set di competenze creato nel passaggio precedente. Forzare inoltre l'esecuzione dell'indicizzatore nell'ambiente di esecuzione privato impostando la proprietà di configurazione dell'indicizzatore executionEnvironment su private.
```
{
    "name": "indexer",
    "dataSourceName": "blob-datasource",
    "targetIndexName": "index",
    "parameters": {
        "configuration": {
            "executionEnvironment": "private"
        }
    },
    "fieldMappings": []
}
```

Dopo aver creato correttamente l'indicizzatore, deve connettersi alla risorsa di Azure tramite la connessione all'endpoint privato. È possibile monitorare lo stato dell'indicizzatore usando l'API Stato dell'indicizzatore.

Nota

Se sono già presenti indicizzatori, è possibile aggiornarli tramite l'API PUT impostando executionEnvironment su private o usando l'editor JSON nel portale.

5 - Testare il collegamento privato condiviso

Se non è già stato fatto, verificare che la risorsa PaaS di Azure rifiuti le connessioni dalla rete Internet pubblica. Se le connessioni vengono accettate, esaminare le impostazioni DNS nella pagina Rete della risorsa PaaS di Azure.
Scegliere uno strumento in grado di richiamare uno scenario di richiesta in uscita, ad esempio una connessione dell'indicizzatore a un endpoint privato. Una scelta semplice consiste nell'usare la procedura guidata Importa dati, ma è anche possibile provare un client REST e le API REST per una maggiore precisione. Supponendo che il servizio di ricerca non sia configurato anche per una connessione privata, la connessione client REST a Search può essere eseguita tramite Internet pubblico.
Impostare la stringa di connessione sulla risorsa PaaS di Azure privata. Il formato della stringa di connessione non cambia per il collegamento privato condiviso. Il servizio di ricerca richiama internamente il collegamento privato condiviso.

Per i carichi di lavoro dell'indicizzatore, la stringa di connessione si trova nella definizione dell'origine dati. Un esempio di origine dati potrebbe essere simile al seguente:
```
 {
   "name": "my-blob-ds",
   "type": "azureblob",
   "subtype": null,
   "credentials": {
     "connectionString": "DefaultEndpointsProtocol=https;AccountName=<YOUR-STORAGE-ACCOUNT>;AccountKey=..."
   }
```
Per i carichi di lavoro dell'indicizzatore, ricordarsi di impostare l'ambiente di esecuzione nella definizione dell'indicizzatore. Un esempio di definizione dell'indicizzatore potrebbe essere simile al seguente:
```
"name": "indexer",
"dataSourceName": "my-blob-ds",
"targetIndexName": "my-index",
"parameters": {
   "configuration": {
       "executionEnvironment": "private"
       }
   },
"fieldMappings": []
}
```
Eseguire l'indicizzatore. Se l'esecuzione dell'indicizzatore ha esito positivo e l'indice di ricerca viene popolato, il collegamento privato condiviso funziona.

Risoluzione dei problemi

Se la creazione dell'indicizzatore non riesce con "Le credenziali dell'origine dati non sono valide", controllare lo stato di approvazione del collegamento privato condiviso prima di eseguire il debug della connessione. Se lo stato è Approved, controllare la proprietà properties.provisioningState. Se è Incomplete, potrebbe verificarsi un problema con le dipendenze sottostanti. In questo caso, eseguire nuovamente la richiesta di PUT per ricreare il collegamento privato condiviso. Potrebbe anche essere necessario ripetere il passaggio di approvazione.
Se gli indicizzatori hanno esito negativo in modo coerente o intermittente, controllare la executionEnvironmentproprietà sull'indicizzatore. Il valore deve essere impostato su private. Se questa proprietà non è stata impostata e l'indicizzatore ha avuto esito positivo in passato, è perché il servizio di ricerca ha usato un ambiente privato a proprio accordo. Un servizio di ricerca sposta l'elaborazione dall'ambiente multi-tenant se il sistema è sotto carico.
Se viene visualizzato un errore durante la creazione di un collegamento privato condiviso, controllare i limiti del servizio per verificare di essere sotto la quota per il livello.

Passaggi successivi

Altre informazioni sugli endpoint privati e altri metodi di connessione sicura:

Condividi tramite

Stabilire connessioni in uscita tramite un collegamento privato condiviso

Quando usare un collegamento privato condiviso

Limiti

Prerequisiti

Tipi di risorsa supportati

1 - Creare un collegamento privato condiviso

Flusso di lavoro di creazione di collegamenti privati condivisi

2 - Approvare la connessione endpoint privato

3 - Controllare lo stato del collegamento privato condiviso

4 - Configurare l'indicizzatore per l'esecuzione nell'ambiente privato

5 - Testare il collegamento privato condiviso

Risoluzione dei problemi

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive