AzurePostgresExtensions Methods

Docs / Reference / Search C# APIs / Aspire.Hosting.Azure.PostgreSQL / AzurePostgresExtensions / Methods

Methods

Docs Reference Search C# APIs Aspire.Hosting.Azure.PostgreSQL AzurePostgresExtensions Methods

Class Methods 7 members

Provides extension methods for adding the Azure PostgreSQL resources to the application model.

AddAzurePostgresFlexibleServer(IDistributedApplicationBuilder, string) extension IResourceBuilder<AzurePostgresFlexibleServerResource>

Adds an Azure PostgreSQL Flexible Server resource to the application model.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<AzurePostgresFlexibleServerResource> AddAzurePostgresFlexibleServer(
        this IDistributedApplicationBuilder builder,
        string name)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L138-L146

Parameters

builder IDistributedApplicationBuilder The builder for the distributed application.

name string The name of the resource.

Returns

IResourceBuilder<AzurePostgresFlexibleServerResource> A reference to the ApplicationModel.IResourceBuilder`1 builder.

Remarks

By default, the Azure PostgreSQL Flexible Server resource is configured to use Microsoft Entra ID (Azure Active Directory) for authentication. This requires changes to the application code to use an azure credential to authenticate with the resource. See https://learn.microsoft.com/azure/postgresql/flexible-server/how-to-connect-with-managed-identity#connect-using-managed-identity-in-c for more information. You can use the AzurePostgresExtensions.WithPasswordAuthentication method to configure the resource to use password authentication. The following example creates an Azure PostgreSQL Flexible Server resource and referencing that resource in a .NET project.

var builder = DistributedApplication.CreateBuilder(args);

var data = builder.AddAzurePostgresFlexibleServer("data");

builder.AddProject<Projects.ProductService>()
    .WithReference(data);

builder.Build().Run();

AddDatabase(IResourceBuilder<AzurePostgresFlexibleServerResource>, string, string?) extension IResourceBuilder<AzurePostgresFlexibleServerDatabaseResource>

Adds an Azure PostgreSQL database to the application model.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<AzurePostgresFlexibleServerDatabaseResource> AddDatabase(
        this IResourceBuilder<AzurePostgresFlexibleServerResource> builder,
        string name,
        string? databaseName = null)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L158-L181

Parameters

builder IResourceBuilder<AzurePostgresFlexibleServerResource> The Azure PostgreSQL server resource builder.

name string The name of the resource. This name will be used as the connection string name when referenced in a dependency.

databaseName string? optional The name of the database. If not provided, this defaults to the same value as name.

Returns

IResourceBuilder<AzurePostgresFlexibleServerDatabaseResource> A reference to the ApplicationModel.IResourceBuilder`1.

Obsolete — This method is obsolete and will be removed in a future version. Use AddAzurePostgresFlexibleServer instead to add an Azure PostgreSQL Flexible Server resource.

AsAzurePostgresFlexibleServer(IResourceBuilder<PostgresServerResource>) extension IResourceBuilder<PostgresServerResource>

Configures resource to use Azure for local development and when doing a deployment via the Azure Developer CLI.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<PostgresServerResource> AsAzurePostgresFlexibleServer(
        this IResourceBuilder<PostgresServerResource> builder)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L108

Parameters

builder IResourceBuilder<PostgresServerResource> The ApplicationModel.IResourceBuilder`1 builder.

Returns

IResourceBuilder<PostgresServerResource> A reference to the ApplicationModel.IResourceBuilder`1 builder.

Obsolete — This method is obsolete and will be removed in a future version. Use AddAzurePostgresFlexibleServer instead to add an Azure PostgreSQL Flexible Server resource.

PublishAsAzurePostgresFlexibleServer(IResourceBuilder<PostgresServerResource>) extension IResourceBuilder<PostgresServerResource>

Configures Postgres Server resource to be deployed as Azure PostgreSQL Flexible Server.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<PostgresServerResource> PublishAsAzurePostgresFlexibleServer(
        this IResourceBuilder<PostgresServerResource> builder)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L99

Parameters

builder IResourceBuilder<PostgresServerResource> The ApplicationModel.IResourceBuilder`1 builder.

Returns

IResourceBuilder<PostgresServerResource> A reference to the ApplicationModel.IResourceBuilder`1 builder.

RunAsContainer(IResourceBuilder<AzurePostgresFlexibleServerResource>, Action<IResourceBuilder<PostgresServerResource>>) extension IResourceBuilder<AzurePostgresFlexibleServerResource>

Configures an Azure PostgreSQL Flexible Server resource to run locally in a container.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<AzurePostgresFlexibleServerResource> RunAsContainer(
        this IResourceBuilder<AzurePostgresFlexibleServerResource> builder,
        Action<IResourceBuilder<PostgresServerResource>>? configureContainer = null)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L210-L252

Parameters

builder IResourceBuilder<AzurePostgresFlexibleServerResource> The Azure PostgreSQL server resource builder.

configureContainer Action<IResourceBuilder<PostgresServerResource>> optional Callback that exposes underlying container to allow for customization.

Returns

IResourceBuilder<AzurePostgresFlexibleServerResource> A reference to the ApplicationModel.IResourceBuilder`1 builder.

Remarks

The following example creates an Azure PostgreSQL Flexible Server resource that runs locally in a PostgreSQL container and referencing that resource in a .NET project.

var builder = DistributedApplication.CreateBuilder(args);

var data = builder.AddAzurePostgresFlexibleServer("data")
    .RunAsContainer();

builder.AddProject<Projects.ProductService>()
    .WithReference(data);

builder.Build().Run();

WithPasswordAuthentication(IResourceBuilder<AzurePostgresFlexibleServerResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) extension IResourceBuilder<AzurePostgresFlexibleServerResource>

Configures the resource to use password authentication for Azure PostgreSQL Flexible Server.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<AzurePostgresFlexibleServerResource> WithPasswordAuthentication(
        this IResourceBuilder<AzurePostgresFlexibleServerResource> builder,
        IResourceBuilder<ParameterResource>? userName = null,
        IResourceBuilder<ParameterResource>? password = null)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L292-L311

Parameters

builder IResourceBuilder<AzurePostgresFlexibleServerResource> The Azure PostgreSQL server resource builder.

userName IResourceBuilder<ParameterResource> optional The parameter used to provide the user name for the PostgreSQL resource. If null a default value will be used.

password IResourceBuilder<ParameterResource> optional The parameter used to provide the administrator password for the PostgreSQL resource. If null a random password will be generated.

Returns

IResourceBuilder<AzurePostgresFlexibleServerResource> A reference to the ApplicationModel.IResourceBuilder`1 builder.

Remarks

The following example creates an Azure PostgreSQL Flexible Server resource that uses password authentication.

var builder = DistributedApplication.CreateBuilder(args);

var data = builder.AddAzurePostgresFlexibleServer("data")
    .WithPasswordAuthentication();

builder.AddProject<Projects.ProductService>()
    .WithReference(data);

builder.Build().Run();

WithPasswordAuthentication(IResourceBuilder<AzurePostgresFlexibleServerResource>, IResourceBuilder<IAzureKeyVaultResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) extension IResourceBuilder<AzurePostgresFlexibleServerResource>

Configures the resource to use password authentication for Azure PostgreSQL Flexible Server. This overload is used when the PostgreSQL resource is created in a container and the password is stored in an Azure Key Vault secret.

public static class AzurePostgresExtensions
{
    public static IResourceBuilder<AzurePostgresFlexibleServerResource> WithPasswordAuthentication(
        this IResourceBuilder<AzurePostgresFlexibleServerResource> builder,
        IResourceBuilder<IAzureKeyVaultResource> keyVaultBuilder,
        IResourceBuilder<ParameterResource>? userName = null,
        IResourceBuilder<ParameterResource>? password = null)
    {
        // ...
    }
}

AzurePostgresExtensions.cs#L329-L360

Parameters

builder IResourceBuilder<AzurePostgresFlexibleServerResource> The Azure PostgreSQL server resource builder.

keyVaultBuilder IResourceBuilder<IAzureKeyVaultResource> The Azure Key Vault resource builder.

userName IResourceBuilder<ParameterResource> optional The parameter used to provide the user name for the PostgreSQL resource. If null a default value will be used.

password IResourceBuilder<ParameterResource> optional The parameter used to provide the administrator password for the PostgreSQL resource. If null a random password will be generated.

Returns

IResourceBuilder<AzurePostgresFlexibleServerResource> A reference to the ApplicationModel.IResourceBuilder`1 builder.