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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.resourceGroupParameterIResourceBuilder<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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.resourceGroupParameterIResourceBuilder<ParameterResource>The name of the existing resource group.subscriptionParameterIResourceBuilder<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.resourceGroupstringThe 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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.subscriptionParameterIResourceBuilder<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.nameParameterIResourceBuilder<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
resourceIResourceThe 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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.resourceGroupParameterIResourceBuilder<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.resourceGroupstring?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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.resourceGroupParameterIResourceBuilder<ParameterResource>The name of the existing resource group.subscriptionParameterIResourceBuilder<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.resourceGroupstringThe 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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.subscriptionParameterIResourceBuilder<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.nameParameterIResourceBuilder<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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.resourceGroupParameterIResourceBuilder<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.resourceGroupstring?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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.resourceGroupParameterIResourceBuilder<ParameterResource>The name of the existing resource group.subscriptionParameterIResourceBuilder<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.resourceGroupstringThe 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.nameParameterIResourceBuilder<ParameterResource>The name of the existing resource.subscriptionParameterIResourceBuilder<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.nameParameterIResourceBuilder<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.