Share via

Microsoft.DevCenter projects/environmentTypes

Bicep resource definition

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

resource symbolicname 'Microsoft.DevCenter/projects/environmentTypes@2025-07-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    creatorRoleAssignment: {
      roles: {
        {customized property}: {}
      }
    }
    deploymentTargetId: 'string'
    displayName: 'string'
    status: 'string'
    userRoleAssignments: {
      {customized property}: {
        roles: {
          {customized property}: {}
        }
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Property Values

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
identity Managed identity properties ManagedServiceIdentity
location The geo-location for the environment type string
name The resource name string

Constraints:
Min length = 3
Max length = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.		 Symbolic name for resource of type: projects
properties Properties of an environment type. ProjectEnvironmentTypeProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates

EnvironmentRole

Name Description Value

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

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment The role definition assigned to the environment creator on backing resources. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Id of a subscription that the environment type will be mapped to. The environment's resources will be deployed into this subscription. string
displayName The display name of the project environment type. string
status Defines whether this Environment Type can be used in this Project. 'Disabled'
'Enabled'
userRoleAssignments Role Assignments created on environment backing resources. This is a mapping from a user object ID to an object of role definition IDs. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles A map of roles to assign to the environment creator. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name Description Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name Description Value

Tags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

UserRoleAssignmentRoles

Name Description Value

UserRoleAssignmentValue

Name Description Value
roles A map of roles to assign to the parent user. UserRoleAssignmentRoles

Usage Examples

Azure Quickstart Samples

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

Bicep File Description
Configure Deployment Environments service This template provides a way to configure Deployment Environments.

ARM template resource definition

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

{
  "type": "Microsoft.DevCenter/projects/environmentTypes",
  "apiVersion": "2025-07-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "creatorRoleAssignment": {
      "roles": {
        "{customized property}": {
        }
      }
    },
    "deploymentTargetId": "string",
    "displayName": "string",
    "status": "string",
    "userRoleAssignments": {
      "{customized property}": {
        "roles": {
          "{customized property}": {
          }
        }
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property Values

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
apiVersion The api version '2025-07-01-preview'
identity Managed identity properties ManagedServiceIdentity
location The geo-location for the environment type string
name The resource name string

Constraints:
Min length = 3
Max length = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (required)
properties Properties of an environment type. ProjectEnvironmentTypeProperties
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.DevCenter/projects/environmentTypes'

EnvironmentRole

Name Description Value

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

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment The role definition assigned to the environment creator on backing resources. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Id of a subscription that the environment type will be mapped to. The environment's resources will be deployed into this subscription. string
displayName The display name of the project environment type. string
status Defines whether this Environment Type can be used in this Project. 'Disabled'
'Enabled'
userRoleAssignments Role Assignments created on environment backing resources. This is a mapping from a user object ID to an object of role definition IDs. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles A map of roles to assign to the environment creator. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name Description Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name Description Value

Tags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

UserRoleAssignmentRoles

Name Description Value

UserRoleAssignmentValue

Name Description Value
roles A map of roles to assign to the parent user. UserRoleAssignmentRoles

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template Description
Configure Deployment Environments service

Deploy to Azure		 This template provides a way to configure Deployment Environments.

Terraform (AzAPI provider) resource definition

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/environmentTypes@2025-07-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      creatorRoleAssignment = {
        roles = {
          {customized property} = {
          }
        }
      }
      deploymentTargetId = "string"
      displayName = "string"
      status = "string"
      userRoleAssignments = {
        {customized property} = {
          roles = {
            {customized property} = {
            }
          }
        }
      }
    }
  }
}

Property Values

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
identity Managed identity properties ManagedServiceIdentity
location The geo-location for the environment type string
name The resource name string

Constraints:
Min length = 3
Max length = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: projects
properties Properties of an environment type. ProjectEnvironmentTypeProperties
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.DevCenter/projects/environmentTypes@2025-07-01-preview"

EnvironmentRole

Name Description Value

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

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment The role definition assigned to the environment creator on backing resources. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Id of a subscription that the environment type will be mapped to. The environment's resources will be deployed into this subscription. string
displayName The display name of the project environment type. string
status Defines whether this Environment Type can be used in this Project. 'Disabled'
'Enabled'
userRoleAssignments Role Assignments created on environment backing resources. This is a mapping from a user object ID to an object of role definition IDs. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles A map of roles to assign to the environment creator. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name Description Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name Description Value

Tags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

UserRoleAssignmentRoles

Name Description Value

UserRoleAssignmentValue

Name Description Value
roles A map of roles to assign to the parent user. UserRoleAssignmentRoles