connections

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

Overview

Name	connections
Type	Resource
Id	azure.ai_projects.connections

Fields

The following fields are returned by SELECT queries:

list

Name	Datatype	Description
id	string	A unique identifier for the connection, generated by the service. Required.
name	string	The friendly name of the connection, provided by the user. Required.
credentials	object	The credentials used by the connection. Required.
isDefault	boolean	Whether the connection is tagged as the default connection of its type. Required.
metadata	object	Metadata of the connection. Required.
target	string	The connection URL to be used for this service. Required.
type	string	Category of the connection. Required. Known values are: "AzureOpenAI", "AzureBlob", "AzureStorageAccount", "CognitiveSearch", "CosmosDB", "ApiKey", "AppConfig", "AppInsights", "CustomKeys", and "RemoteTool_Preview". (AzureOpenAI, AzureBlob, AzureStorageAccount, CognitiveSearch, CosmosDB, ApiKey, AppConfig, AppInsights, CustomKeys, RemoteTool_Preview)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	endpoint	connectionType, defaultConnection	List connections. Returns the connections available in the current project, optionally filtered by type or default status.

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.

Name	Datatype	Description
endpoint	string	The service endpoint host (no scheme), e.g. myaccount.table.cosmos.azure.com:443 - value of the client endpoint parameter. (default: )
connectionType	string	Lists connections of this specific type. Known values are: "AzureOpenAI", "AzureBlob", "AzureStorageAccount", "CognitiveSearch", "CosmosDB", "ApiKey", "AppConfig", "AppInsights", "CustomKeys", and "RemoteTool_Preview". Default value is None.
defaultConnection	boolean	Lists connections that are default connections. Default value is None.

SELECT examples

list

List connections. Returns the connections available in the current project, optionally filtered by type or default status.

SELECT
id,
name,
credentials,
isDefault,
metadata,
target,
type
FROM azure.ai_projects.connections
WHERE endpoint = '{{ endpoint }}' -- required
AND connectionType = '{{ connectionType }}'
AND defaultConnection = '{{ defaultConnection }}'
;