Overview: Resource schemas
The following properties and values are available across all Radius resources:
|The name of your resource.
|The location of your resource. See below for more information. The rad CLI defaults the value to ‘global’ for Radius resources. Direct API calls require
location to be set to
|The environment used by your resources for deployment.
The name of the resource defines how to address the resource within the context of the application.
Radius resource names follow the DNS-1035 naming convention. This, plus other control-plane requirements, result in resource names that must:
- Contain at most 63 user-entered characters
- Contain only alphanumeric characters or ‘-’
- Start with an alphabetic character
- End with an alphanumeric character
The combination of the resource name and application name results in the rendered resource name in a self-hosted Kubernetes environment. The resource group name and resource name also result in the full Universal Control Plane (UCP) identifier of the resource.
For example, take the following values:
- Resource name:
- Application name:
- Resource group name:
The resulting names are:
- Rendered Kubernetes pod name:
- Universal Control Plane (UCP) ID:
The location property defines where to deploy a resource within the targeted platform.
For self-hosted environments, the location property is defaulted to
global by the rad CLI to indicate the resource is scoped to the entire underlying cluster. Direct API calls require
location to be set to
'global'. This is a point-in-time implementation that will be revisited in a future revision of self-hosted Kubernetes environments.
environment string parameter is automatically injected into your Bicep template using the environment ID value specified in your default workspace. This value can also be overridden with the rad CLI:
rad deploy --params environment="/planes/radius/...".
To access the auto-injected value, specify an
environment string parameter in your Bicep file:
param environment string
Was this page helpful?
Sorry to hear that. If you would like to also contribute a suggestion visit and tell us how we can improve.