Compartir a través de


Microsoft.DevCenter projects/environmentTypes

Definición de recursos de Bicep

El tipo de recurso projects/environmentTypes se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevCenter/projects/environmentTypes, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.DevCenter/projects/environmentTypes@2025-10-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'
  }
}

Valores de propiedad

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
identity Propiedades de identidad administrada. ManagedServiceIdentity
location Ubicación geográfica donde reside el recurso string (obligatorio)
name El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
parent En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: proyectos
properties Propiedades de un tipo de entorno. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'None'
'SystemAssigned'
'Asignado al sistema, asignado al usuario'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment Definición de roles asignada al creador del entorno en los recursos de respaldo. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Identificador de una suscripción a la que se asignará el tipo de entorno. Los recursos del entorno se implementarán en esta suscripción. string
displayName Nombre para mostrar del tipo de entorno del proyecto. string
status Define si este tipo de entorno se puede usar en este proyecto. 'Disabled'
'Enabled'
userRoleAssignments Asignaciones de roles creadas en los recursos de respaldo del entorno. Se trata de una asignación de un identificador de objeto de usuario a un objeto de identificadores de definición de roles. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles Mapa de roles que se asignarán al creador del entorno. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name Description Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name Description Value

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Asignación de roles de usuario

Name Description Value
roles Asignación de roles que se asignarán al usuario primario. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Description
Configurar entornos de implementación Esta plantilla proporciona una manera de configurar entornos de implementación.

Definición de recursos de plantilla de ARM

El tipo de recurso projects/environmentTypes se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevCenter/projects/environmentTypes, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.DevCenter/projects/environmentTypes",
  "apiVersion": "2025-10-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"
  }
}

Valores de propiedad

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
apiVersion La versión de api '2025-10-01-preview'
identity Propiedades de identidad administrada. ManagedServiceIdentity
location Ubicación geográfica donde reside el recurso string (obligatorio)
name El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
properties Propiedades de un tipo de entorno. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
type El tipo de recurso 'Microsoft.DevCenter/projects/environmentTypes'

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'None'
'SystemAssigned'
'Asignado al sistema, asignado al usuario'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment Definición de roles asignada al creador del entorno en los recursos de respaldo. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Identificador de una suscripción a la que se asignará el tipo de entorno. Los recursos del entorno se implementarán en esta suscripción. string
displayName Nombre para mostrar del tipo de entorno del proyecto. string
status Define si este tipo de entorno se puede usar en este proyecto. 'Disabled'
'Enabled'
userRoleAssignments Asignaciones de roles creadas en los recursos de respaldo del entorno. Se trata de una asignación de un identificador de objeto de usuario a un objeto de identificadores de definición de roles. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles Mapa de roles que se asignarán al creador del entorno. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name Description Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name Description Value

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Asignación de roles de usuario

Name Description Value
roles Asignación de roles que se asignarán al usuario primario. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Description
Configurar entornos de implementación

Implementación en Azure
Esta plantilla proporciona una manera de configurar entornos de implementación.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso projects/environmentTypes se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevCenter/projects/environmentTypes, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects/environmentTypes@2025-10-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} = {
            }
          }
        }
      }
    }
  }
}

Valores de propiedad

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
identity Propiedades de identidad administrada. ManagedServiceIdentity
location Ubicación geográfica donde reside el recurso string (obligatorio)
name El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: proyectos de
properties Propiedades de un tipo de entorno. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
type El tipo de recurso "Microsoft.DevCenter/projects/environmentTypes@2025-10-01-preview"

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'None'
'SystemAssigned'
'Asignado al sistema, asignado al usuario'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment Definición de roles asignada al creador del entorno en los recursos de respaldo. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Identificador de una suscripción a la que se asignará el tipo de entorno. Los recursos del entorno se implementarán en esta suscripción. string
displayName Nombre para mostrar del tipo de entorno del proyecto. string
status Define si este tipo de entorno se puede usar en este proyecto. 'Disabled'
'Enabled'
userRoleAssignments Asignaciones de roles creadas en los recursos de respaldo del entorno. Se trata de una asignación de un identificador de objeto de usuario a un objeto de identificadores de definición de roles. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles Mapa de roles que se asignarán al creador del entorno. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name Description Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name Description Value

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

Asignación de roles de usuario

Name Description Value
roles Asignación de roles que se asignarán al usuario primario. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación del tipo de entorno de proyecto del Centro de desarrollo.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

data "azapi_client_config" "current" {}

variable "resource_name" {
  type = string
}

variable "location" {
  type = string
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "devCenter" {
  type      = "Microsoft.DevCenter/devCenters@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type = "SystemAssigned"
  }
  body = {
    properties = {}
  }
}

resource "azapi_resource" "environmentType" {
  type      = "Microsoft.DevCenter/devCenters/environmentTypes@2025-02-01"
  parent_id = azapi_resource.devCenter.id
  name      = "${var.resource_name}-envtype"
}

resource "azapi_resource" "project" {
  type      = "Microsoft.DevCenter/projects@2025-02-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-proj"
  location  = var.location
  body = {
    properties = {
      description        = ""
      devCenterId        = azapi_resource.devCenter.id
      maxDevBoxesPerUser = 0
    }
  }
}

resource "azapi_resource" "environmentType_1" {
  type      = "Microsoft.DevCenter/projects/environmentTypes@2025-02-01"
  parent_id = azapi_resource.project.id
  name      = azapi_resource.environmentType.name
  body = {
    properties = {
      deploymentTargetId = "/subscriptions/${data.azapi_client_config.current.subscription_id}"
      status             = "Enabled"
    }
  }
}