Microsoft.Solutions applications

Bicep resource definition

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

resource symbolicname 'Microsoft.Solutions/applications@2023-12-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  managedBy: 'string'
  name: 'string'
  plan: {
    name: 'string'
    product: 'string'
    promotionCode: 'string'
    publisher: 'string'
    version: 'string'
  }
  properties: {
    applicationDefinitionId: 'string'
    jitAccessPolicy: {
      jitAccessEnabled: bool
      jitApprovalMode: 'string'
      jitApprovers: [
        {
          displayName: 'string'
          id: 'string'
          type: 'string'
        }
      ]
      maximumJitAccessDuration: 'string'
    }
    managedResourceGroupId: 'string'
    parameters: any(Azure.Bicep.Types.Concrete.AnyType)
  }
  sku: {
    capacity: int
    family: 'string'
    model: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

ApplicationJitAccessPolicy

Name Description Value
jitAccessEnabled Whether the JIT access is enabled. bool (required)
jitApprovalMode JIT approval mode. 'AutoApprove'
'ManualApprove'
'NotSpecified'
jitApprovers The JIT approvers JitApproverDefinition[]
maximumJitAccessDuration The maximum duration JIT access is granted. This is an ISO8601 time period value. string

ApplicationProperties

Name Description Value
applicationDefinitionId The fully qualified path of managed application definition Id. string
jitAccessPolicy The managed application Jit access policy. ApplicationJitAccessPolicy
managedResourceGroupId The managed resource group Id. string
parameters Name and value pairs that define the managed application parameters. It can be a JObject or a well formed JSON string. any

Identity

Name Description Value
type The identity type. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities The list of user identities associated with the resource. The user identity dictionary key references will be resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Name Description Value

JitApproverDefinition

Name Description Value
displayName The approver display name. string
id The approver service principal Id. string (required)
type The approver type. 'group'
'user'

Microsoft.Solutions/applications

Name Description Value
identity The identity of the resource. Identity
kind The kind of the managed application. Allowed values are MarketPlace and ServiceCatalog. string

Constraints:
Pattern = ^[-\w\._,\(\)]+$ (required)
location Resource location string
managedBy ID of the resource that manages this resource. string
name The resource name string

Constraints:
Min length = 3
Max length = 3 (required)
plan The plan information. Plan
properties The managed application properties. ApplicationProperties (required)
sku The SKU of the resource. Sku
tags Resource tags Dictionary of tag names and values. See Tags in templates

Plan

Name Description Value
name The plan name. string (required)
product The product code. string (required)
promotionCode The promotion code. string
publisher The publisher ID. string (required)
version The plan's version. string (required)

ResourceTags

Name Description Value

Sku

Name Description Value
capacity The SKU capacity. int
family The SKU family. string
model The SKU model. string
name The SKU name. string (required)
size The SKU size. string
tier The SKU tier. string

UserAssignedResourceIdentity

Name Description Value

ARM template resource definition

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

{
  "type": "Microsoft.Solutions/applications",
  "apiVersion": "2023-12-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "managedBy": "string",
  "plan": {
    "name": "string",
    "product": "string",
    "promotionCode": "string",
    "publisher": "string",
    "version": "string"
  },
  "properties": {
    "applicationDefinitionId": "string",
    "jitAccessPolicy": {
      "jitAccessEnabled": "bool",
      "jitApprovalMode": "string",
      "jitApprovers": [
        {
          "displayName": "string",
          "id": "string",
          "type": "string"
        }
      ],
      "maximumJitAccessDuration": "string"
    },
    "managedResourceGroupId": "string",
    "parameters": {}
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "model": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

ApplicationJitAccessPolicy

Name Description Value
jitAccessEnabled Whether the JIT access is enabled. bool (required)
jitApprovalMode JIT approval mode. 'AutoApprove'
'ManualApprove'
'NotSpecified'
jitApprovers The JIT approvers JitApproverDefinition[]
maximumJitAccessDuration The maximum duration JIT access is granted. This is an ISO8601 time period value. string

ApplicationProperties

Name Description Value
applicationDefinitionId The fully qualified path of managed application definition Id. string
jitAccessPolicy The managed application Jit access policy. ApplicationJitAccessPolicy
managedResourceGroupId The managed resource group Id. string
parameters Name and value pairs that define the managed application parameters. It can be a JObject or a well formed JSON string. any

Identity

Name Description Value
type The identity type. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities The list of user identities associated with the resource. The user identity dictionary key references will be resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Name Description Value

JitApproverDefinition

Name Description Value
displayName The approver display name. string
id The approver service principal Id. string (required)
type The approver type. 'group'
'user'

Microsoft.Solutions/applications

Name Description Value
apiVersion The api version '2023-12-01-preview'
identity The identity of the resource. Identity
kind The kind of the managed application. Allowed values are MarketPlace and ServiceCatalog. string

Constraints:
Pattern = ^[-\w\._,\(\)]+$ (required)
location Resource location string
managedBy ID of the resource that manages this resource. string
name The resource name string

Constraints:
Min length = 3
Max length = 3 (required)
plan The plan information. Plan
properties The managed application properties. ApplicationProperties (required)
sku The SKU of the resource. Sku
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Solutions/applications'

Plan

Name Description Value
name The plan name. string (required)
product The product code. string (required)
promotionCode The promotion code. string
publisher The publisher ID. string (required)
version The plan's version. string (required)

ResourceTags

Name Description Value

Sku

Name Description Value
capacity The SKU capacity. int
family The SKU family. string
model The SKU model. string
name The SKU name. string (required)
size The SKU size. string
tier The SKU tier. string

UserAssignedResourceIdentity

Name Description Value

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
Create a managed application that deploys linked templates

Deploy to Azure
This template creates a managed application that deploys linked templates.
Create a managed application with a customized view

Deploy to Azure
This template creates a managed application that has a customized default view.
Create a managed application with metrics and alerts

Deploy to Azure
This template creates a managed application that has application metrics and alerts.

Terraform (AzAPI provider) resource definition

The applications 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.Solutions/applications resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Solutions/applications@2023-12-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  kind = "string"
  location = "string"
  managedBy = "string"
  plan = {
    name = "string"
    product = "string"
    promotionCode = "string"
    publisher = "string"
    version = "string"
  }
  sku = {
    capacity = int
    family = "string"
    model = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      applicationDefinitionId = "string"
      jitAccessPolicy = {
        jitAccessEnabled = bool
        jitApprovalMode = "string"
        jitApprovers = [
          {
            displayName = "string"
            id = "string"
            type = "string"
          }
        ]
        maximumJitAccessDuration = "string"
      }
      managedResourceGroupId = "string"
      parameters = ?
    }
  })
}

Property values

ApplicationJitAccessPolicy

Name Description Value
jitAccessEnabled Whether the JIT access is enabled. bool (required)
jitApprovalMode JIT approval mode. 'AutoApprove'
'ManualApprove'
'NotSpecified'
jitApprovers The JIT approvers JitApproverDefinition[]
maximumJitAccessDuration The maximum duration JIT access is granted. This is an ISO8601 time period value. string

ApplicationProperties

Name Description Value
applicationDefinitionId The fully qualified path of managed application definition Id. string
jitAccessPolicy The managed application Jit access policy. ApplicationJitAccessPolicy
managedResourceGroupId The managed resource group Id. string
parameters Name and value pairs that define the managed application parameters. It can be a JObject or a well formed JSON string. any

Identity

Name Description Value
type The identity type. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities The list of user identities associated with the resource. The user identity dictionary key references will be resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Name Description Value

JitApproverDefinition

Name Description Value
displayName The approver display name. string
id The approver service principal Id. string (required)
type The approver type. 'group'
'user'

Microsoft.Solutions/applications

Name Description Value
identity The identity of the resource. Identity
kind The kind of the managed application. Allowed values are MarketPlace and ServiceCatalog. string

Constraints:
Pattern = ^[-\w\._,\(\)]+$ (required)
location Resource location string
managedBy ID of the resource that manages this resource. string
name The resource name string

Constraints:
Min length = 3
Max length = 3 (required)
plan The plan information. Plan
properties The managed application properties. ApplicationProperties (required)
sku The SKU of the resource. Sku
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Solutions/applications@2023-12-01-preview"

Plan

Name Description Value
name The plan name. string (required)
product The product code. string (required)
promotionCode The promotion code. string
publisher The publisher ID. string (required)
version The plan's version. string (required)

ResourceTags

Name Description Value

Sku

Name Description Value
capacity The SKU capacity. int
family The SKU family. string
model The SKU model. string
name The SKU name. string (required)
size The SKU size. string
tier The SKU tier. string

UserAssignedResourceIdentity

Name Description Value