Skip to main content

private_endpoint_connections

Creates, updates, deletes, gets or lists a private_endpoint_connections resource.

Overview

Nameprivate_endpoint_connections
TypeResource
Idazure.search.private_endpoint_connections

Fields

The following fields are returned by SELECT queries:

The definition of the private endpoint connection was successfully retrieved and is in the response.

NameDatatypeDescription
idstringFully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
namestringThe name of the resource
propertiesobjectDescribes the properties of an existing private endpoint connection to the Azure AI Search service.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresourceGroupName, searchServiceName, privateEndpointConnectionName, subscriptionIdx-ms-client-request-idGets the details of the private endpoint connection to the search service in the given resource group.
list_by_serviceselectsubscriptionId, resourceGroupName, searchServiceNamex-ms-client-request-idGets a list of all private endpoint connections in the given service.
updatereplaceresourceGroupName, searchServiceName, privateEndpointConnectionName, subscriptionIdx-ms-client-request-idUpdates a private endpoint connection to the search service in the given resource group.
deletedeleteresourceGroupName, searchServiceName, privateEndpointConnectionName, subscriptionIdx-ms-client-request-idDisconnects the private endpoint connection and deletes it from the search service.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
privateEndpointConnectionNamestringThe name of the private endpoint connection to the Azure AI Search service with the specified resource group.
resourceGroupNamestringThe name of the resource group within the current subscription. You can obtain this value from the Azure Resource Manager API or the portal.
searchServiceNamestringThe name of the Azure AI Search service associated with the specified resource group.
subscriptionIdstringThe unique identifier for a Microsoft Azure subscription. You can obtain this value from the Azure Resource Manager API or the portal.
x-ms-client-request-idstring (uuid)A client-generated GUID value that identifies this request. If specified, this will be included in response information as a way to track the request.

SELECT examples

Gets the details of the private endpoint connection to the search service in the given resource group.

SELECT
id,
name,
properties,
type
FROM azure.search.private_endpoint_connections
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND searchServiceName = '{{ searchServiceName }}' -- required
AND privateEndpointConnectionName = '{{ privateEndpointConnectionName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND x-ms-client-request-id = '{{ x-ms-client-request-id }}'
;

REPLACE examples

Updates a private endpoint connection to the search service in the given resource group.

REPLACE azure.search.private_endpoint_connections
SET
data__properties = '{{ properties }}'
WHERE
resourceGroupName = '{{ resourceGroupName }}' --required
AND searchServiceName = '{{ searchServiceName }}' --required
AND privateEndpointConnectionName = '{{ privateEndpointConnectionName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
AND x-ms-client-request-id = '{{ x-ms-client-request-id}}'
RETURNING
id,
name,
properties,
type;

DELETE examples

Disconnects the private endpoint connection and deletes it from the search service.

DELETE FROM azure.search.private_endpoint_connections
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND searchServiceName = '{{ searchServiceName }}' --required
AND privateEndpointConnectionName = '{{ privateEndpointConnectionName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
AND x-ms-client-request-id = '{{ x-ms-client-request-id }}'
;