ExistingAzureResourceExtensions Methods
ClassMethods24 members
Extension methods for interacting with resources that are not managed by Aspire's provisioning or container management layer.
AsExisting(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled AsExisting(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the resource as an existing resource in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExisting<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource>? resourceGroupParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.resourceGroupParameter IResourceBuilder<ParameterResource> The name of the existing resource group, or null to use the current resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.AsExistingInResourceGroup(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled AsExistingInResourceGroup(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the resource as an existing resource in a specific resource group and subscription in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExistingInResourceGroup<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource> resourceGroupParameter, IResourceBuilder<ParameterResource> subscriptionParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.resourceGroupParameter IResourceBuilder<ParameterResource> The name of the existing resource group.subscriptionParameter IResourceBuilder<ParameterResource> The subscription identifier containing the resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.AsExistingInResourceGroup(IResourceBuilder<T>, string, string, string) Section titled AsExistingInResourceGroup(IResourceBuilder<T>, string, string, string)extensionIResourceBuilder<T> Marks the resource as an existing resource in a specific resource group and subscription in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExistingInResourceGroup<T>( this IResourceBuilder<T> builder, string name, string resourceGroup, string subscription) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.resourceGroup stringThe name of the existing resource group.subscriptionstringThe subscription identifier containing the resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.AsExistingInSubscription(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled AsExistingInSubscription(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the subscription-scoped resource as an existing resource in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExistingInSubscription<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource> subscriptionParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.subscriptionParameter IResourceBuilder<ParameterResource> The subscription identifier containing the resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Use this only for Azure resources that are deployed at subscription scope. Most Azure services are resource-group scoped and should use
AsExistingInResourceGroup .AsExistingInSubscription(IResourceBuilder<T>, string, string) Section titled AsExistingInSubscription(IResourceBuilder<T>, string, string)extensionIResourceBuilder<T> Marks the subscription-scoped resource as an existing resource in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExistingInSubscription<T>( this IResourceBuilder<T> builder, string name, string subscription) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.subscriptionstringThe subscription identifier containing the resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Use this only for Azure resources that are deployed at subscription scope. Most Azure services are resource-group scoped and should use
AsExistingInResourceGroup .AsExistingInTenant(IResourceBuilder<T>, IResourceBuilder<ParameterResource>) Section titled AsExistingInTenant(IResourceBuilder<T>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the current-tenant-scoped resource as an existing resource in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExistingInTenant<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Tenant scope targets the current tenant. Bicep doesn't support selecting a different tenant with the
tenant() scope function.AsExistingInTenant(IResourceBuilder<T>, string) Section titled AsExistingInTenant(IResourceBuilder<T>, string)extensionIResourceBuilder<T> Marks the current-tenant-scoped resource as an existing resource in both run and publish modes.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> AsExistingInTenant<T>( this IResourceBuilder<T> builder, string name) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Tenant scope targets the current tenant. Bicep doesn't support selecting a different tenant with the
tenant() scope function. Determines if the resource is an existing resource.
public static class ExistingAzureResourceExtensions{ public static bool IsExisting( this IResource resource) { // ... }}Parameters
resourceIResource The resource to check.Returns
boolTrue if the resource is an existing resource, otherwise false.Remarks
This method is not available in polyglot AppHosts. Use the Azure resource-specific polyglot surface instead.
PublishAsExisting(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled PublishAsExisting(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the resource as an existing resource when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExisting<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource>? resourceGroupParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.resourceGroupParameter IResourceBuilder<ParameterResource> The name of the existing resource group, or null to use the current resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.PublishAsExisting(IResourceBuilder<T>, string, string?) Section titled PublishAsExisting(IResourceBuilder<T>, string, string?)extensionIResourceBuilder<T> Marks the resource as an existing resource when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExisting<T>( this IResourceBuilder<T> builder, string name, string? resourceGroup) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.resourceGroup string?The name of the existing resource group, or null to use the current resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.PublishAsExistingInResourceGroup(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled PublishAsExistingInResourceGroup(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the resource as an existing resource in a specific resource group and subscription when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExistingInResourceGroup<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource> resourceGroupParameter, IResourceBuilder<ParameterResource> subscriptionParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.resourceGroupParameter IResourceBuilder<ParameterResource> The name of the existing resource group.subscriptionParameter IResourceBuilder<ParameterResource> The subscription identifier containing the resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.PublishAsExistingInResourceGroup(IResourceBuilder<T>, string, string, string) Section titled PublishAsExistingInResourceGroup(IResourceBuilder<T>, string, string, string)extensionIResourceBuilder<T> Marks the resource as an existing resource in a specific resource group and subscription when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExistingInResourceGroup<T>( this IResourceBuilder<T> builder, string name, string resourceGroup, string subscription) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.resourceGroup stringThe name of the existing resource group.subscriptionstringThe subscription identifier containing the resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.PublishAsExistingInSubscription(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled PublishAsExistingInSubscription(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the subscription-scoped resource as an existing resource when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExistingInSubscription<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource> subscriptionParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.subscriptionParameter IResourceBuilder<ParameterResource> The subscription identifier containing the resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Use this only for Azure resources that are deployed at subscription scope. Most Azure services are resource-group scoped and should use
PublishAsExistingInResourceGroup .PublishAsExistingInSubscription(IResourceBuilder<T>, string, string) Section titled PublishAsExistingInSubscription(IResourceBuilder<T>, string, string)extensionIResourceBuilder<T> Marks the subscription-scoped resource as an existing resource when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExistingInSubscription<T>( this IResourceBuilder<T> builder, string name, string subscription) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.subscriptionstringThe subscription identifier containing the resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Use this only for Azure resources that are deployed at subscription scope. Most Azure services are resource-group scoped and should use
PublishAsExistingInResourceGroup .PublishAsExistingInTenant(IResourceBuilder<T>, IResourceBuilder<ParameterResource>) Section titled PublishAsExistingInTenant(IResourceBuilder<T>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the current-tenant-scoped resource as an existing resource when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExistingInTenant<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Tenant scope targets the current tenant. Bicep doesn't support selecting a different tenant with the
tenant() scope function.PublishAsExistingInTenant(IResourceBuilder<T>, string) Section titled PublishAsExistingInTenant(IResourceBuilder<T>, string)extensionIResourceBuilder<T> Marks the current-tenant-scoped resource as an existing resource when the application is deployed.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> PublishAsExistingInTenant<T>( this IResourceBuilder<T> builder, string name) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Tenant scope targets the current tenant. Bicep doesn't support selecting a different tenant with the
tenant() scope function.RunAsExisting(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled RunAsExisting(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the resource as an existing resource when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExisting<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource>? resourceGroupParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.resourceGroupParameter IResourceBuilder<ParameterResource> The name of the existing resource group, or null to use the current resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.RunAsExisting(IResourceBuilder<T>, string, string?) Section titled RunAsExisting(IResourceBuilder<T>, string, string?)extensionIResourceBuilder<T> Marks the resource as an existing resource when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExisting<T>( this IResourceBuilder<T> builder, string name, string? resourceGroup) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.resourceGroup string?The name of the existing resource group, or null to use the current resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.RunAsExistingInResourceGroup(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled RunAsExistingInResourceGroup(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the resource as an existing resource in a specific resource group and subscription when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExistingInResourceGroup<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource> resourceGroupParameter, IResourceBuilder<ParameterResource> subscriptionParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.resourceGroupParameter IResourceBuilder<ParameterResource> The name of the existing resource group.subscriptionParameter IResourceBuilder<ParameterResource> The subscription identifier containing the resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.RunAsExistingInResourceGroup(IResourceBuilder<T>, string, string, string) Section titled RunAsExistingInResourceGroup(IResourceBuilder<T>, string, string, string)extensionIResourceBuilder<T> Marks the resource as an existing resource in a specific resource group and subscription when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExistingInResourceGroup<T>( this IResourceBuilder<T> builder, string name, string resourceGroup, string subscription) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.resourceGroup stringThe name of the existing resource group.subscriptionstringThe subscription identifier containing the resource group.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.RunAsExistingInSubscription(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>) Section titled RunAsExistingInSubscription(IResourceBuilder<T>, IResourceBuilder<ParameterResource>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the subscription-scoped resource as an existing resource when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExistingInSubscription<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter, IResourceBuilder<ParameterResource> subscriptionParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.subscriptionParameter IResourceBuilder<ParameterResource> The subscription identifier containing the resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Use this only for Azure resources that are deployed at subscription scope. Most Azure services are resource-group scoped and should use
RunAsExistingInResourceGroup .RunAsExistingInSubscription(IResourceBuilder<T>, string, string) Section titled RunAsExistingInSubscription(IResourceBuilder<T>, string, string)extensionIResourceBuilder<T> Marks the subscription-scoped resource as an existing resource when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExistingInSubscription<T>( this IResourceBuilder<T> builder, string name, string subscription) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.subscriptionstringThe subscription identifier containing the resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Use this only for Azure resources that are deployed at subscription scope. Most Azure services are resource-group scoped and should use
RunAsExistingInResourceGroup .RunAsExistingInTenant(IResourceBuilder<T>, IResourceBuilder<ParameterResource>) Section titled RunAsExistingInTenant(IResourceBuilder<T>, IResourceBuilder<ParameterResource>)extensionIResourceBuilder<T> Marks the current-tenant-scoped resource as an existing resource when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExistingInTenant<T>( this IResourceBuilder<T> builder, IResourceBuilder<ParameterResource> nameParameter) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.nameParameter IResourceBuilder<ParameterResource> The name of the existing resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Tenant scope targets the current tenant. Bicep doesn't support selecting a different tenant with the
tenant() scope function.RunAsExistingInTenant(IResourceBuilder<T>, string) Section titled RunAsExistingInTenant(IResourceBuilder<T>, string)extensionIResourceBuilder<T> Marks the current-tenant-scoped resource as an existing resource when the application is running.
public static class ExistingAzureResourceExtensions{ public static IResourceBuilder<T> RunAsExistingInTenant<T>( this IResourceBuilder<T> builder, string name) { // ... }}Parameters
builderIResourceBuilder<T> The resource builder.namestringThe name of the existing resource.Returns
IResourceBuilder<T> The resource builder with the existing resource annotation added.Remarks
Tenant scope targets the current tenant. Bicep doesn't support selecting a different tenant with the
tenant() scope function.