AzureCognitiveServicesProjectConnectionsBuilderExtensions Methods
Class Methods 12 members
Extension methods for adding Microsoft Foundry project connection resources to the distributed application model.
AddBingGroundingConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, string, string) Section titled AddBingGroundingConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, string, string) extension IResourceBuilder<BingGroundingConnectionResource> Adds a Grounding with Bing Search connection to a Microsoft Foundry project.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<BingGroundingConnectionResource> AddBingGroundingConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, string name, string bingResourceId) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> The ApplicationModel.IResourceBuilder`1 for the parent Microsoft Foundry project resource. name string The name of the connection resource. bingResourceId string The full Azure resource ID of the Bing Search resource (e.g., /subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.Bing/accounts/{name}). Returns
IResourceBuilder<BingGroundingConnectionResource> A reference to the ApplicationModel.IResourceBuilder`1 for the connection resource. Remarks
The Bing Search resource ( Microsoft.Bing/accounts) cannot be provisioned through Aspire or Bicep. It must be created manually in the Azure portal.
Once the Bing resource exists, pass its resource ID to this method. The connection is created in the Foundry project using API key authentication with category: "ApiKey" and metadata.Type: "bing_grounding".
AddBingGroundingConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, string, IResourceBuilder<ParameterResource>) Section titled AddBingGroundingConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, string, IResourceBuilder<ParameterResource>) extension IResourceBuilder<BingGroundingConnectionResource> Adds a Grounding with Bing Search connection to a Microsoft Foundry project using a parameter resource for the Bing resource ID.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<BingGroundingConnectionResource> AddBingGroundingConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, string name, IResourceBuilder<ParameterResource> bingResourceId) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> The ApplicationModel.IResourceBuilder`1 for the parent Microsoft Foundry project resource. name string The name of the connection resource. bingResourceId IResourceBuilder<ParameterResource> A parameter resource containing the full Azure resource ID of the Bing Search resource. Returns
IResourceBuilder<BingGroundingConnectionResource> A reference to the ApplicationModel.IResourceBuilder`1 for the connection resource. Remarks
This overload allows the Bing resource ID to be supplied as a parameter (e.g., from user secrets or configuration) rather than a hardcoded string. The parameter value is resolved at deployment time and embedded in the Bicep template.
AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, string, Func<AzureResourceInfrastructure, CognitiveServicesConnectionProperties>) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, string, Func<AzureResourceInfrastructure, CognitiveServicesConnectionProperties>) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds a Microsoft Foundry project connection resource to a project. This is a low level interface that requires the caller to specify all connection properties.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, string name, Func<AzureResourceInfrastructure, CognitiveServicesConnectionProperties> configureProperties) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> The ApplicationModel.IResourceBuilder`1 for the parent Microsoft Foundry project resource. name string The name of the Microsoft Foundry project connection resource. configureProperties Func<AzureResourceInfrastructure, CognitiveServicesConnectionProperties> Action to customize the resource. Returns
IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> A reference to the ApplicationModel.IResourceBuilder`1 for the Microsoft Foundry project connection resource. Remarks
This method is not available in polyglot app hosts.
AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureCosmosDBResource) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureCosmosDBResource) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds CosmosDB to a project as a connection
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, AzureCosmosDBResource db) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> db AzureCosmosDBResource AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureCosmosDBResource>) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureCosmosDBResource>) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds CosmosDB to a project as a connection
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, IResourceBuilder<AzureCosmosDBResource> db) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> db IResourceBuilder<AzureCosmosDBResource> AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureStorageResource) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureStorageResource) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds an Azure Storage account to a project as a connection.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, AzureStorageResource storage) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> storage AzureStorageResource AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureStorageResource>) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureStorageResource>) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds an Azure Storage account to a project as a connection.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, IResourceBuilder<AzureStorageResource> storage) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> storage IResourceBuilder<AzureStorageResource> AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureContainerRegistryResource) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureContainerRegistryResource) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds a container registry connection to the Microsoft Foundry project.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, AzureContainerRegistryResource registry) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> registry AzureContainerRegistryResource AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureContainerRegistryResource>) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureContainerRegistryResource>) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds a container registry connection to the Microsoft Foundry project.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, IResourceBuilder<AzureContainerRegistryResource> registry) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> registry IResourceBuilder<AzureContainerRegistryResource> AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureSearchResource) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, AzureSearchResource) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds an Azure AI Search connection to a Microsoft Foundry project.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, AzureSearchResource search) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> search AzureSearchResource AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureSearchResource>) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureSearchResource>) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds an Azure AI Search connection to a Microsoft Foundry project.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, IResourceBuilder<AzureSearchResource> search) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> search IResourceBuilder<AzureSearchResource> AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureKeyVaultResource>) Section titled AddConnection(IResourceBuilder<AzureCognitiveServicesProjectResource>, IResourceBuilder<AzureKeyVaultResource>) extension IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> Adds a Key Vault connection to the Microsoft Foundry project.
public static class AzureCognitiveServicesProjectConnectionsBuilderExtensions{ public static IResourceBuilder<AzureCognitiveServicesProjectConnectionResource> AddConnection( this IResourceBuilder<AzureCognitiveServicesProjectResource> builder, IResourceBuilder<AzureKeyVaultResource> keyVault) { // ... }}Parameters
builder IResourceBuilder<AzureCognitiveServicesProjectResource> keyVault IResourceBuilder<AzureKeyVaultResource> Remarks
This connection allows the Microsoft Foundry project to store secrets for various other connections. As such, we recommend adding this connection *before* any others, so that those connections can leverage the Key Vault connection for secret storage.