Microsoft.LabServices labPlans

2025-02-13

Bicep resource definition

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

Resource groups - See resource group deployment commands

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

Resource format

To create a Microsoft.LabServices/labPlans resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.LabServices/labPlans@2023-06-07' = {
  identity: {
    type: 'SystemAssigned'
  }
  location: 'string'
  name: 'string'
  properties: {
    allowedRegions: [
      'string'
    ]
    defaultAutoShutdownProfile: {
      disconnectDelay: 'string'
      idleDelay: 'string'
      noConnectDelay: 'string'
      shutdownOnDisconnect: 'string'
      shutdownOnIdle: 'string'
      shutdownWhenNotConnected: 'string'
    }
    defaultConnectionProfile: {
      clientRdpAccess: 'string'
      clientSshAccess: 'string'
      webRdpAccess: 'string'
      webSshAccess: 'string'
    }
    defaultNetworkProfile: {
      subnetId: 'string'
    }
    linkedLmsInstance: 'string'
    sharedGalleryId: 'string'
    supportInfo: {
      email: 'string'
      instructions: 'string'
      phone: 'string'
      url: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Property Values

Microsoft.LabServices/labPlans

Name	Description	Value
identity	Managed Identity Information	Identity
location	The geo-location where the resource lives	string (required)
name	The resource name	string Constraints: Min length = 1 Max length = 100 (required)
properties	Lab plan resource properties	LabPlanProperties (required)
tags	Resource tags	Dictionary of tag names and values. See Tags in templates

AutoShutdownProfile

Name	Description	Value
disconnectDelay	The amount of time a VM will stay running after a user disconnects if this behavior is enabled.	string
idleDelay	The amount of time a VM will idle before it is shutdown if this behavior is enabled.	string
noConnectDelay	The amount of time a VM will stay running before it is shutdown if no connection is made and this behavior is enabled.	string
shutdownOnDisconnect	Whether shutdown on disconnect is enabled	'Disabled' 'Enabled'
shutdownOnIdle	Whether a VM will get shutdown when it has idled for a period of time.	'LowUsage' 'None' 'UserAbsence'
shutdownWhenNotConnected	Whether a VM will get shutdown when it hasn't been connected to after a period of time.	'Disabled' 'Enabled'

ConnectionProfile

Name	Description	Value
clientRdpAccess	The enabled access level for Client Access over RDP.	'None' 'Private' 'Public'
clientSshAccess	The enabled access level for Client Access over SSH.	'None' 'Private' 'Public'
webRdpAccess	The enabled access level for Web Access over RDP.	'None' 'Private' 'Public'
webSshAccess	The enabled access level for Web Access over SSH.	'None' 'Private' 'Public'

Identity

Name	Description	Value
type	The identity type.	'SystemAssigned'

LabPlanNetworkProfile

Name	Description	Value
subnetId	The external subnet resource id	string Constraints: Min length = 3 Max length = 2000

LabPlanProperties

Name	Description	Value
allowedRegions	The allowed regions for the lab creator to use when creating labs using this lab plan.	string[]
defaultAutoShutdownProfile	The default lab shutdown profile. This can be changed on a lab resource and only provides a default profile.	AutoShutdownProfile
defaultConnectionProfile	The default lab connection profile. This can be changed on a lab resource and only provides a default profile.	ConnectionProfile
defaultNetworkProfile	The lab plan network profile. To enforce lab network policies they must be defined here and cannot be changed when there are existing labs associated with this lab plan.	LabPlanNetworkProfile
linkedLmsInstance	Base Url of the lms instance this lab plan can link lab rosters against.	string Constraints: Min length = 3 Max length = 2000
sharedGalleryId	Resource ID of the Shared Image Gallery attached to this lab plan. When saving a lab template virtual machine image it will be persisted in this gallery. Shared images from the gallery can be made available to use when creating new labs.	string Constraints: Min length = 3 Max length = 2000
supportInfo	Support contact information and instructions for users of the lab plan. This information is displayed to lab owners and virtual machine users for all labs in the lab plan.	SupportInfo

SupportInfo

Name	Description	Value
email	Support contact email address.	string Constraints: Min length = 6 Max length = 254
instructions	Support instructions.	string
phone	Support contact phone number.	string Constraints: Min length = 1 Max length = 31
url	Support web address.	string Constraints: Min length = 3 Max length = 2000

TrackedResourceTags

Name	Description	Value

Usage Examples

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File	Description
Create Azure Lab Services lab plan	Create Azure Lab Services lab plan.

ARM template resource definition

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

Resource groups - See resource group deployment commands

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

Resource format

To create a Microsoft.LabServices/labPlans resource, add the following JSON to your template.

{
  "type": "Microsoft.LabServices/labPlans",
  "apiVersion": "2023-06-07",
  "name": "string",
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "string",
  "properties": {
    "allowedRegions": [ "string" ],
    "defaultAutoShutdownProfile": {
      "disconnectDelay": "string",
      "idleDelay": "string",
      "noConnectDelay": "string",
      "shutdownOnDisconnect": "string",
      "shutdownOnIdle": "string",
      "shutdownWhenNotConnected": "string"
    },
    "defaultConnectionProfile": {
      "clientRdpAccess": "string",
      "clientSshAccess": "string",
      "webRdpAccess": "string",
      "webSshAccess": "string"
    },
    "defaultNetworkProfile": {
      "subnetId": "string"
    },
    "linkedLmsInstance": "string",
    "sharedGalleryId": "string",
    "supportInfo": {
      "email": "string",
      "instructions": "string",
      "phone": "string",
      "url": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property Values

Microsoft.LabServices/labPlans

Name	Description	Value
apiVersion	The api version	'2023-06-07'
identity	Managed Identity Information	Identity
location	The geo-location where the resource lives	string (required)
name	The resource name	string Constraints: Min length = 1 Max length = 100 (required)
properties	Lab plan resource properties	LabPlanProperties (required)
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
type	The resource type	'Microsoft.LabServices/labPlans'

AutoShutdownProfile

Name	Description	Value
disconnectDelay	The amount of time a VM will stay running after a user disconnects if this behavior is enabled.	string
idleDelay	The amount of time a VM will idle before it is shutdown if this behavior is enabled.	string
noConnectDelay	The amount of time a VM will stay running before it is shutdown if no connection is made and this behavior is enabled.	string
shutdownOnDisconnect	Whether shutdown on disconnect is enabled	'Disabled' 'Enabled'
shutdownOnIdle	Whether a VM will get shutdown when it has idled for a period of time.	'LowUsage' 'None' 'UserAbsence'
shutdownWhenNotConnected	Whether a VM will get shutdown when it hasn't been connected to after a period of time.	'Disabled' 'Enabled'

ConnectionProfile

Name	Description	Value
clientRdpAccess	The enabled access level for Client Access over RDP.	'None' 'Private' 'Public'
clientSshAccess	The enabled access level for Client Access over SSH.	'None' 'Private' 'Public'
webRdpAccess	The enabled access level for Web Access over RDP.	'None' 'Private' 'Public'
webSshAccess	The enabled access level for Web Access over SSH.	'None' 'Private' 'Public'

Identity

Name	Description	Value
type	The identity type.	'SystemAssigned'

LabPlanNetworkProfile

Name	Description	Value
subnetId	The external subnet resource id	string Constraints: Min length = 3 Max length = 2000

LabPlanProperties

Name	Description	Value
allowedRegions	The allowed regions for the lab creator to use when creating labs using this lab plan.	string[]
defaultAutoShutdownProfile	The default lab shutdown profile. This can be changed on a lab resource and only provides a default profile.	AutoShutdownProfile
defaultConnectionProfile	The default lab connection profile. This can be changed on a lab resource and only provides a default profile.	ConnectionProfile
defaultNetworkProfile	The lab plan network profile. To enforce lab network policies they must be defined here and cannot be changed when there are existing labs associated with this lab plan.	LabPlanNetworkProfile
linkedLmsInstance	Base Url of the lms instance this lab plan can link lab rosters against.	string Constraints: Min length = 3 Max length = 2000
sharedGalleryId	Resource ID of the Shared Image Gallery attached to this lab plan. When saving a lab template virtual machine image it will be persisted in this gallery. Shared images from the gallery can be made available to use when creating new labs.	string Constraints: Min length = 3 Max length = 2000
supportInfo	Support contact information and instructions for users of the lab plan. This information is displayed to lab owners and virtual machine users for all labs in the lab plan.	SupportInfo

SupportInfo

Name	Description	Value
email	Support contact email address.	string Constraints: Min length = 6 Max length = 254
instructions	Support instructions.	string
phone	Support contact phone number.	string Constraints: Min length = 1 Max length = 31
url	Support web address.	string Constraints: Min length = 3 Max length = 2000

TrackedResourceTags

Name	Description	Value

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template	Description
Create Azure Lab Services lab plan	Create Azure Lab Services lab plan.

Terraform (AzAPI provider) resource definition

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.LabServices/labPlans@2023-06-07"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allowedRegions = [
        "string"
      ]
      defaultAutoShutdownProfile = {
        disconnectDelay = "string"
        idleDelay = "string"
        noConnectDelay = "string"
        shutdownOnDisconnect = "string"
        shutdownOnIdle = "string"
        shutdownWhenNotConnected = "string"
      }
      defaultConnectionProfile = {
        clientRdpAccess = "string"
        clientSshAccess = "string"
        webRdpAccess = "string"
        webSshAccess = "string"
      }
      defaultNetworkProfile = {
        subnetId = "string"
      }
      linkedLmsInstance = "string"
      sharedGalleryId = "string"
      supportInfo = {
        email = "string"
        instructions = "string"
        phone = "string"
        url = "string"
      }
    }
  }
}

Property Values

Microsoft.LabServices/labPlans

Name	Description	Value
identity	Managed Identity Information	Identity
location	The geo-location where the resource lives	string (required)
name	The resource name	string Constraints: Min length = 1 Max length = 100 (required)
properties	Lab plan resource properties	LabPlanProperties (required)
tags	Resource tags	Dictionary of tag names and values.
type	The resource type	"Microsoft.LabServices/labPlans@2023-06-07"

AutoShutdownProfile

Name	Description	Value
disconnectDelay	The amount of time a VM will stay running after a user disconnects if this behavior is enabled.	string
idleDelay	The amount of time a VM will idle before it is shutdown if this behavior is enabled.	string
noConnectDelay	The amount of time a VM will stay running before it is shutdown if no connection is made and this behavior is enabled.	string
shutdownOnDisconnect	Whether shutdown on disconnect is enabled	'Disabled' 'Enabled'
shutdownOnIdle	Whether a VM will get shutdown when it has idled for a period of time.	'LowUsage' 'None' 'UserAbsence'
shutdownWhenNotConnected	Whether a VM will get shutdown when it hasn't been connected to after a period of time.	'Disabled' 'Enabled'

ConnectionProfile

Name	Description	Value
clientRdpAccess	The enabled access level for Client Access over RDP.	'None' 'Private' 'Public'
clientSshAccess	The enabled access level for Client Access over SSH.	'None' 'Private' 'Public'
webRdpAccess	The enabled access level for Web Access over RDP.	'None' 'Private' 'Public'
webSshAccess	The enabled access level for Web Access over SSH.	'None' 'Private' 'Public'

Identity

Name	Description	Value
type	The identity type.	'SystemAssigned'

LabPlanNetworkProfile

Name	Description	Value
subnetId	The external subnet resource id	string Constraints: Min length = 3 Max length = 2000

LabPlanProperties

Name	Description	Value
allowedRegions	The allowed regions for the lab creator to use when creating labs using this lab plan.	string[]
defaultAutoShutdownProfile	The default lab shutdown profile. This can be changed on a lab resource and only provides a default profile.	AutoShutdownProfile
defaultConnectionProfile	The default lab connection profile. This can be changed on a lab resource and only provides a default profile.	ConnectionProfile
defaultNetworkProfile	The lab plan network profile. To enforce lab network policies they must be defined here and cannot be changed when there are existing labs associated with this lab plan.	LabPlanNetworkProfile
linkedLmsInstance	Base Url of the lms instance this lab plan can link lab rosters against.	string Constraints: Min length = 3 Max length = 2000
sharedGalleryId	Resource ID of the Shared Image Gallery attached to this lab plan. When saving a lab template virtual machine image it will be persisted in this gallery. Shared images from the gallery can be made available to use when creating new labs.	string Constraints: Min length = 3 Max length = 2000
supportInfo	Support contact information and instructions for users of the lab plan. This information is displayed to lab owners and virtual machine users for all labs in the lab plan.	SupportInfo

SupportInfo

Name	Description	Value
email	Support contact email address.	string Constraints: Min length = 6 Max length = 254
instructions	Support instructions.	string
phone	Support contact phone number.	string Constraints: Min length = 1 Max length = 31
url	Support web address.	string Constraints: Min length = 3 Max length = 2000

TrackedResourceTags

Name	Description	Value

Share via

Microsoft.LabServices labPlans

Bicep resource definition

Resource format

Property Values

Microsoft.LabServices/labPlans

AutoShutdownProfile

ConnectionProfile

Identity

LabPlanNetworkProfile

LabPlanProperties

SupportInfo

TrackedResourceTags

Usage Examples

Azure Quickstart Samples

ARM template resource definition

Resource format

Property Values

Microsoft.LabServices/labPlans

AutoShutdownProfile

ConnectionProfile

Identity

LabPlanNetworkProfile

LabPlanProperties

SupportInfo

TrackedResourceTags

Usage Examples

Azure Quickstart Templates

Terraform (AzAPI provider) resource definition

Resource format

Property Values

Microsoft.LabServices/labPlans

AutoShutdownProfile

ConnectionProfile

Identity

LabPlanNetworkProfile

LabPlanProperties

SupportInfo

TrackedResourceTags

Feedback

Additional resources