Microsoft.App builders

Bicep resource definition

The builders 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/builders resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.App/builders@2024-10-02-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    containerRegistries: [
      {
        containerRegistryServer: 'string'
        identityResourceId: 'string'
      }
    ]
    environmentId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

BuilderProperties

Name Description Value
containerRegistries List of mappings of container registries and the managed identity used to connect to it. ContainerRegistry[]
environmentId Resource ID of the container apps environment that the builder is associated with. string (required)

ContainerRegistry

Name Description Value
containerRegistryServer Login server of the container registry. string (required)
identityResourceId Resource ID of the managed identity. string (required)

ManagedServiceIdentity

Name Description Value
type Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (required)
userAssignedIdentities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. UserAssignedIdentities

Microsoft.App/builders

Name Description Value
identity The managed service identities assigned to this resource. ManagedServiceIdentity
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 2
Max length = 2
Pattern = ^[-\w\._\(\)]+$ (required)
properties The resource-specific properties for this resource. BuilderProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

ARM template resource definition

The builders 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/builders resource, add the following JSON to your template.

{
  "type": "Microsoft.App/builders",
  "apiVersion": "2024-10-02-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "containerRegistries": [
      {
        "containerRegistryServer": "string",
        "identityResourceId": "string"
      }
    ],
    "environmentId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

BuilderProperties

Name Description Value
containerRegistries List of mappings of container registries and the managed identity used to connect to it. ContainerRegistry[]
environmentId Resource ID of the container apps environment that the builder is associated with. string (required)

ContainerRegistry

Name Description Value
containerRegistryServer Login server of the container registry. string (required)
identityResourceId Resource ID of the managed identity. string (required)

ManagedServiceIdentity

Name Description Value
type Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (required)
userAssignedIdentities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. UserAssignedIdentities

Microsoft.App/builders

Name Description Value
apiVersion The api version '2024-10-02-preview'
identity The managed service identities assigned to this resource. ManagedServiceIdentity
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 2
Max length = 2
Pattern = ^[-\w\._\(\)]+$ (required)
properties The resource-specific properties for this resource. BuilderProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.App/builders'

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Terraform (AzAPI provider) resource definition

The builders resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.App/builders resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/builders@2024-10-02-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      containerRegistries = [
        {
          containerRegistryServer = "string"
          identityResourceId = "string"
        }
      ]
      environmentId = "string"
    }
  })
}

Property values

BuilderProperties

Name Description Value
containerRegistries List of mappings of container registries and the managed identity used to connect to it. ContainerRegistry[]
environmentId Resource ID of the container apps environment that the builder is associated with. string (required)

ContainerRegistry

Name Description Value
containerRegistryServer Login server of the container registry. string (required)
identityResourceId Resource ID of the managed identity. string (required)

ManagedServiceIdentity

Name Description Value
type Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (required)
userAssignedIdentities The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. UserAssignedIdentities

Microsoft.App/builders

Name Description Value
identity The managed service identities assigned to this resource. ManagedServiceIdentity
location The geo-location where the resource lives string (required)
name The resource name string

Constraints:
Min length = 2
Max length = 2
Pattern = ^[-\w\._\(\)]+$ (required)
properties The resource-specific properties for this resource. BuilderProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.App/builders@2024-10-02-preview"

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value