Skip to content
Docs Try Aspire

AzureSearchExtensions Methods

Class Methods 2 members
Provides extension methods for adding the Azure AI Search resources to the application model.
AddAzureSearch(IDistributedApplicationBuilder, string) Section titled AddAzureSearch(IDistributedApplicationBuilder, string) extension IResourceBuilder<AzureSearchResource>
Adds an Azure AI Search service resource to the application model.
public static class AzureSearchExtensions
{
public static IResourceBuilder<AzureSearchResource> AddAzureSearch(
this IDistributedApplicationBuilder builder,
string name)
{
// ...
}
}
builder IDistributedApplicationBuilder The builder for the distributed application.
name string The name of the Azure AI Search resource.
IResourceBuilder<AzureSearchResource> A reference to the ApplicationModel.IResourceBuilder`1.
By default references to the Azure AI Search service resource will be assigned the following roles: - SearchBuiltInRole.SearchIndexDataContributor - SearchBuiltInRole.SearchServiceContributor These can be replaced by calling AzureSearchExtensions.WithRoleAssignments.
WithRoleAssignments(IResourceBuilder<T>, IResourceBuilder<AzureSearchResource>, SearchBuiltInRole[]) Section titled WithRoleAssignments(IResourceBuilder<T>, IResourceBuilder<AzureSearchResource>, SearchBuiltInRole[]) extension IResourceBuilder<T>
Assigns the specified roles to the given resource, granting it the necessary permissions on the target Azure AI Search service resource. This replaces the default role assignments for the resource.
public static class AzureSearchExtensions
{
public static IResourceBuilder<T> WithRoleAssignments<T>(
this IResourceBuilder<T> builder,
IResourceBuilder<AzureSearchResource> target,
params SearchBuiltInRole[] roles)
{
// ...
}
}
builder IResourceBuilder<T> The resource to which the specified roles will be assigned.
target IResourceBuilder<AzureSearchResource> The target Azure AI Search service resource.
roles SearchBuiltInRole[] The built-in AI Search roles to be assigned.
IResourceBuilder<T> The updated ApplicationModel.IResourceBuilder`1 with the applied role assignments.
Assigns the SearchIndexDataReader role to the 'Projects.Api' project.
var builder = DistributedApplication.CreateBuilder(args);
var search = builder.AddAzureSearch("search");
var api = builder.AddProject<Projects.Api>("api")
.WithRoleAssignments(search, SearchBuiltInRole.SearchIndexDataReader)
.WithReference(search);