Skip to content

Commit 325c2fc

Browse files
committed
Updates to shared private link and vectorization
1 parent a61ecac commit 325c2fc

File tree

2 files changed

+22
-16
lines changed

2 files changed

+22
-16
lines changed

articles/search/search-indexer-howto-access-private.md

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,13 @@ manager: nitinme
77
author: mrcarter8
88
ms.author: mcarter
99
ms.service: cognitive-search
10-
ms.custom:
11-
- ignite-2023
1210
ms.topic: how-to
13-
ms.date: 04/03/2024
11+
ms.date: 05/21/2024
1412
---
1513

1614
# Make outbound connections through a shared private link
1715

18-
This article explains how to configure private, outbound calls from Azure AI Search to an Azure PaaS resource that runs within a virtual network.
16+
This article explains how to configure private, outbound calls from Azure AI Search to an Azure PaaS resource that runs within an Azure virtual network.
1917

2018
Setting up a private connection allows a search service to connect to a virtual network IP address instead of a port that's open to the internet. The object created for the connection is called a *shared private link*. On the connection, the search service uses the shared private link internally to reach an Azure PaaS resource inside the network boundary.
2119

@@ -28,8 +26,8 @@ Shared private link is a premium feature that's billed by usage. When you set up
2826

2927
Azure AI Search makes outbound calls to other Azure PaaS resources in the following scenarios:
3028

31-
+ Indexer or search engine connects to Azure OpenAI for text-to-vector embeddings
32-
+ Indexer connects to supported data sources
29+
+ Indexer or search engine connections to Azure OpenAI for text-to-vector embeddings
30+
+ Indexer connections to supported data sources
3331
+ Indexer (skillset) connections to Azure Storage for caching enrichments, debug session sate, or writing to a knowledge store
3432
+ Encryption key requests to Azure Key Vault
3533
+ Custom skill requests to Azure Functions or similar resource
@@ -72,15 +70,15 @@ When evaluating shared private links for your scenario, remember these constrain
7270

7371
+ An Azure PaaS resource from the following list of [supported resource types](#supported-resource-types), configured to run in a virtual network.
7472

75-
7673
+ Permissions on both Azure AI Search and the data source:
7774

7875
+ On the Azure PaaS resource, you must have the permission to approve private endpoint connections. For instance, if you're using an Azure Storage account as your data source (such as Blob container, Azure Files share, Azure table), you need `Microsoft.Storage/storageAccounts/privateEndpointConnectionsApproval/action`.
7976

80-
+ On the search service, you must have read and write permissions on shared private link resources and read operation statuses:
81-
+ `Microsoft.Search/searchServices/sharedPrivateLinkResources/write`
82-
+ `Microsoft.Search/searchServices/sharedPrivateLinkResources/read`
83-
+ `Microsoft.Search/searchServices/sharedPrivateLinkResources/operationStatuses/read`
77+
+ On the search service, you must have read and write permissions on shared private link resources and read operation statuses:
78+
79+
+ `Microsoft.Search/searchServices/sharedPrivateLinkResources/write`
80+
+ `Microsoft.Search/searchServices/sharedPrivateLinkResources/read`
81+
+ `Microsoft.Search/searchServices/sharedPrivateLinkResources/operationStatuses/read`
8482

8583
<a name="group-ids"></a>
8684

@@ -107,7 +105,7 @@ You can create a shared private link for the following resources.
107105

108106
<sup>4</sup> See [Create a shared private link for a SQL Managed Instance](search-indexer-how-to-access-private-sql.md) for instructions.
109107

110-
<sup>5</sup> The `Microsoft.CognitiveServices/accounts` resource type is used for indexer connections to Azure OpenAI when implementing [integrated Vectorization](vector-search-integrated-vectorization.md).
108+
<sup>5</sup> The `Microsoft.CognitiveServices/accounts` resource type is used for vectorizer and indexer connections to Azure OpenAI when implementing [integrated Vectorization](vector-search-integrated-vectorization.md). There is currently no support for shared private link to embedding models in the Azure AI Studio model catalog or to the Azure AI Vision multimodal API.
111109

112110
## 1 - Create a shared private link
113111

articles/search/vector-search-integrated-vectorization.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -102,8 +102,18 @@ Optionally, [create secondary indexes](index-projections-concept-intro.md) for a
102102

103103
> [!TIP]
104104
> [Try the new **Import and vectorize data** wizard](search-get-started-portal-import-vectors.md) in the Azure portal to explore integrated vectorization before writing any code.
105-
>
106-
> Or, configure a Jupyter notebook to run the same workflow, cell by cell, to see how each step works.
105+
106+
### Secure connections to vectorizers and models
107+
108+
If your architecture requires private connections that bypass the internet, you can create a [shared private link connection](search-indexer-howto-access-private.md) to the embedding models used by skills during indexing and vectorizers at query time.
109+
110+
Shared private links only work for Azure-to-Azure connections. If you're connecting to OpenAI or another external model, the connection must be over the public internet.
111+
112+
For vectorization scenarios, you would use:
113+
114+
+ `openai_account` for embedding models hosted on an Azure OpenAI resource.
115+
116+
+ `sites` for embedding models accessed as a [custom skill](cognitive-search-custom-skill-interface.md) or [custom vectorizer](vector-search-vectorizer-custom-web-api.md). The `sites` group ID is for App services and Azure functions, which you could use to host an embedding model that isn't one of the Azure OpenAI embedding models.
107117

108118
## Limitations
109119

@@ -113,8 +123,6 @@ Azure OpenAI token-per-minute limits are per model, per subscription. Keep this
113123

114124
On Azure AI Search, remember there are [service limits](search-limits-quotas-capacity.md) by tier and workloads.
115125

116-
If you need a [shared private link connection](search-indexer-howto-access-private.md) from a vectorizer, you must review the supportability of your setup and follow the respective instructions.
117-
118126
Finally, the following features aren't currently supported:
119127

120128
+ [Customer-managed encryption keys](search-security-manage-encryption-keys.md)

0 commit comments

Comments
 (0)