Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The connectedEnvironments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.App/connectedEnvironments resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.App/connectedEnvironments@2025-10-02-preview' = {
scope: resourceSymbolicName or scope
extendedLocation: {
name: 'string'
type: 'string'
}
location: 'string'
name: 'string'
properties: {
customDomainConfiguration: {
certificateKeyVaultProperties: {
identity: 'string'
keyVaultUrl: 'string'
}
certificatePassword: 'string'
certificateValue: any(...)
dnsSuffix: 'string'
}
daprAIConnectionString: 'string'
staticIp: 'string'
}
tags: {
{customized property}: 'string'
}
}
Property Values
Microsoft.App/connectedEnvironments
| Name | Description | Value |
|---|---|---|
| extendedLocation | The complex type of the extended location. | ExtendedLocation |
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string (required) |
| properties | ConnectedEnvironment resource specific properties | ConnectedEnvironmentProperties |
| scope | Use when creating a resource at a scope that is different than the deployment scope. | Set this property to the symbolic name of a resource to apply the extension resource. |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
CertificateKeyVaultProperties
| Name | Description | Value |
|---|---|---|
| identity | Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity. | string |
| keyVaultUrl | URL pointing to the Azure Key Vault secret that holds the certificate. | string |
ConnectedEnvironmentProperties
| Name | Description | Value |
|---|---|---|
| customDomainConfiguration | Custom domain configuration for the environment | CustomDomainConfiguration |
| daprAIConnectionString | Application Insights connection string used by Dapr to export Service to Service communication telemetry | string Constraints: Sensitive value. Pass in as a secure parameter. |
| staticIp | Static IP of the connectedEnvironment | string |
CustomDomainConfiguration
| Name | Description | Value |
|---|---|---|
| certificateKeyVaultProperties | Certificate stored in Azure Key Vault. | CertificateKeyVaultProperties |
| certificatePassword | Certificate password | string Constraints: Sensitive value. Pass in as a secure parameter. |
| certificateValue | PFX or PEM blob | any |
| dnsSuffix | Dns suffix for the environment domain | string |
ExtendedLocation
| Name | Description | Value |
|---|---|---|
| name | The name of the extended location. | string |
| type | The type of the extended location. | 'CustomLocation' |
TrackedResourceTags
| Name | Description | Value |
|---|
ARM template resource definition
The connectedEnvironments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.App/connectedEnvironments resource, add the following JSON to your template.
{
"type": "Microsoft.App/connectedEnvironments",
"apiVersion": "2025-10-02-preview",
"name": "string",
"extendedLocation": {
"name": "string",
"type": "string"
},
"location": "string",
"properties": {
"customDomainConfiguration": {
"certificateKeyVaultProperties": {
"identity": "string",
"keyVaultUrl": "string"
},
"certificatePassword": "string",
"certificateValue": {},
"dnsSuffix": "string"
},
"daprAIConnectionString": "string",
"staticIp": "string"
},
"tags": {
"{customized property}": "string"
}
}
Property Values
Microsoft.App/connectedEnvironments
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2025-10-02-preview' |
| extendedLocation | The complex type of the extended location. | ExtendedLocation |
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string (required) |
| properties | ConnectedEnvironment resource specific properties | ConnectedEnvironmentProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| type | The resource type | 'Microsoft.App/connectedEnvironments' |
CertificateKeyVaultProperties
| Name | Description | Value |
|---|---|---|
| identity | Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity. | string |
| keyVaultUrl | URL pointing to the Azure Key Vault secret that holds the certificate. | string |
ConnectedEnvironmentProperties
| Name | Description | Value |
|---|---|---|
| customDomainConfiguration | Custom domain configuration for the environment | CustomDomainConfiguration |
| daprAIConnectionString | Application Insights connection string used by Dapr to export Service to Service communication telemetry | string Constraints: Sensitive value. Pass in as a secure parameter. |
| staticIp | Static IP of the connectedEnvironment | string |
CustomDomainConfiguration
| Name | Description | Value |
|---|---|---|
| certificateKeyVaultProperties | Certificate stored in Azure Key Vault. | CertificateKeyVaultProperties |
| certificatePassword | Certificate password | string Constraints: Sensitive value. Pass in as a secure parameter. |
| certificateValue | PFX or PEM blob | any |
| dnsSuffix | Dns suffix for the environment domain | string |
ExtendedLocation
| Name | Description | Value |
|---|---|---|
| name | The name of the extended location. | string |
| type | The type of the extended location. | 'CustomLocation' |
TrackedResourceTags
| Name | Description | Value |
|---|
Usage Examples
Terraform (AzAPI provider) resource definition
The connectedEnvironments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.App/connectedEnvironments resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.App/connectedEnvironments@2025-10-02-preview"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
extendedLocation = {
name = "string"
type = "string"
}
properties = {
customDomainConfiguration = {
certificateKeyVaultProperties = {
identity = "string"
keyVaultUrl = "string"
}
certificatePassword = "string"
certificateValue = ?
dnsSuffix = "string"
}
daprAIConnectionString = "string"
staticIp = "string"
}
}
}
Property Values
Microsoft.App/connectedEnvironments
| Name | Description | Value |
|---|---|---|
| extendedLocation | The complex type of the extended location. | ExtendedLocation |
| location | The geo-location where the resource lives | string (required) |
| name | The resource name | string (required) |
| parent_id | The ID of the resource to apply this extension resource to. | string (required) |
| properties | ConnectedEnvironment resource specific properties | ConnectedEnvironmentProperties |
| tags | Resource tags | Dictionary of tag names and values. |
| type | The resource type | "Microsoft.App/connectedEnvironments@2025-10-02-preview" |
CertificateKeyVaultProperties
| Name | Description | Value |
|---|---|---|
| identity | Resource ID of a managed identity to authenticate with Azure Key Vault, or System to use a system-assigned identity. | string |
| keyVaultUrl | URL pointing to the Azure Key Vault secret that holds the certificate. | string |
ConnectedEnvironmentProperties
| Name | Description | Value |
|---|---|---|
| customDomainConfiguration | Custom domain configuration for the environment | CustomDomainConfiguration |
| daprAIConnectionString | Application Insights connection string used by Dapr to export Service to Service communication telemetry | string Constraints: Sensitive value. Pass in as a secure parameter. |
| staticIp | Static IP of the connectedEnvironment | string |
CustomDomainConfiguration
| Name | Description | Value |
|---|---|---|
| certificateKeyVaultProperties | Certificate stored in Azure Key Vault. | CertificateKeyVaultProperties |
| certificatePassword | Certificate password | string Constraints: Sensitive value. Pass in as a secure parameter. |
| certificateValue | PFX or PEM blob | any |
| dnsSuffix | Dns suffix for the environment domain | string |
ExtendedLocation
| Name | Description | Value |
|---|---|---|
| name | The name of the extended location. | string |
| type | The type of the extended location. | 'CustomLocation' |
TrackedResourceTags
| Name | Description | Value |
|---|