Radius.Core/applications@2025-08-01-preview

❗️ Preview Release: This documentation covers a preview of Radius which uses different Resource Types from the current release. Enable it by passing the --preview to the Radius CLI or settingRADIUS_PREVIEW=true.

Description

The Radius.Core/applications Resource Type represents a Radius Application: a logical grouping of the resources that make up a single Application, such as containers, databases, and message queues, along with the connections between them. Radius uses the Application to build the application graph, apply shared configuration, and manage its resources together throughout their lifecycle.

Defining an Application

An Application is always deployed to a Radius Environment, which is supplied through the environment property. To define an Application, add a Radius.Core/applications resource to your application definition Bicep file.

extension radius

@description('The Radius Environment ID. Injected automatically by the rad CLI.')
param environment string

resource myApp 'Radius.Core/applications@2025-08-01-preview' = {
  name: 'my-app'
  properties: {
    environment: environment
  }
}

Deploying an Application

An Application is deployed with the rad deploy command, which deploys the Application together with the resources that belong to it:

rad deploy ./app.bicep

Adding resources to an Application

Resources are composed into an Application by setting their application property to the Application’s ID. For example, to add a Container to this Application, add the following to the application definition Bicep file and set application: myApp.id:

resource frontend 'Radius.Compute/containers@2025-08-01-preview' = {
  name: 'frontend'
  properties: {
    environment: environment
    application: myApp.id
    containers: {
      frontend: {
        image: 'ghcr.io/my-org/frontend:latest'
      }
    }
  }
}

Top-Level Properties

Property	Type	Description
`environment`	string	(Required) Fully qualified resource ID of the environment the application is deployed to
`provisioningState`	string	(Read Only) The status of the Application resource within the Radius control plane. Does not include the other resources that compose the Application. Allowed values: `Accepted`, `Canceled`, `Creating`, `Deleting`, `Failed`, `Provisioning`, `Succeeded`, `Updating`.
`status`	object	(Read Only) Deployment details for the Application, including any output resources Radius created for it.

Object Properties

`status`

Property	Type	Description
`compute`	object	The compute resource associated with the resource.
`outputResources`	object[]	Properties of an output resource
`recipe`	object	The recipe data at the time of deployment

`status.compute`

Property	Type	Description
`kind`	string	Discriminator property that selects the variant. Allowed values: `aci`, `kubernetes`.
`identity`	object	Configuration for supported external identity providers
`resourceId`	string	The resource id of the compute resource for application environment.

`status.outputResources`

Property	Type	Description
`id`	string	The UCP resource ID of the underlying resource.
`localId`	string	The logical identifier scoped to the owning Radius resource. This is only needed or used when a resource has a dependency relationship. LocalIDs do not have any particular format or meaning beyond being compared to determine dependency relationships.
`radiusManaged`	boolean	Determines whether Radius manages the lifecycle of the underlying resource.

`status.recipe`

Property	Type	Description
`templateKind`	string	TemplateKind is the kind of the recipe template used by the portable resource upon deployment.
`templatePath`	string	TemplatePath is the path of the recipe consumed by the portable resource upon deployment.
`templateVersion`	string	TemplateVersion is the version number of the template.

`status.compute.identity`

Property	Type	Description
`kind`	string	kind of identity setting Allowed values: `azure.com.workload`, `systemAssigned`, `systemAssignedUserAssigned`, `undefined`, `userAssigned`.
`managedIdentity`	string array	The list of user assigned managed identities
`oidcIssuer`	string	The URI for your compute platform’s OIDC issuer
`resource`	string	The resource ID of the provisioned identity

`status.compute.aci`

Property	Type	Description
`resourceGroup`	string	The resource group to use for the environment.

`status.compute.kubernetes`

Property	Type	Description
`namespace`	string	The namespace to use for the environment.

Feedback

Was this page helpful?

Glad to hear it! Please feel free to star our repo and join our Discord server to stay up to date with the project.

Sorry to hear that. If you would like to also contribute a suggestion visit and tell us how we can improve.