Compartir a través de

Proyectos de Microsoft.DevCenter 2025-04-01-preview

Definición de recursos de Bicep

El tipo de recurso projects se puede implementar con operaciones destinadas a:

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, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.DevCenter/projects@2025-04-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    azureAiServicesSettings: {
      azureAiServicesMode: 'string'
    }
    catalogSettings: {
      catalogItemSyncTypes: [
        'string'
      ]
    }
    customizationSettings: {
      identities: [
        {
          identityResourceId: 'string'
          identityType: 'string'
        }
      ]
      userCustomizationsEnableStatus: 'string'
    }
    description: 'string'
    devBoxAutoDeleteSettings: {
      deleteMode: 'string'
      gracePeriod: 'string'
      inactiveThreshold: 'string'
    }
    devCenterId: 'string'
    displayName: 'string'
    maxDevBoxesPerUser: int
    serverlessGpuSessionsSettings: {
      maxConcurrentSessionsPerProject: int
      serverlessGpuSessionsMode: 'string'
    }
    workspaceStorageSettings: {
      workspaceStorageMode: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

Microsoft.DevCenter/projects

Nombre Descripción Importancia
identidad Propiedades de identidad administrada managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
Propiedades Propiedades de un proyecto. ProjectProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

AzureAiServicesSettings

Nombre Descripción Importancia
azureAiServicesMode La propiedad indica si los servicios de Azure AI están habilitados. 'Despliegue automático'
'Deshabilitado'

DevBoxAutoDeleteSettings

Nombre Descripción Importancia
deleteMode Indica el modo de eliminación de los equipos de desarrollo dentro de este proyecto. 'Auto'
'Manual'
período de gracia ISO8601 tiempo necesario para que el cuadro de desarrollo se marque para su eliminación antes de que se elimine. ISO8601 formato PT[n]H[n]M[n]S. cuerda / cadena
inactiveThreshold ISO8601 tiempo necesario para que el equipo de desarrollo no esté inactivo antes de que se programe su eliminación. ISO8601 formato PT[n]H[n]M[n]S. cuerda / cadena

ManagedServiceIdentity

Nombre Descripción Importancia
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario 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

ProjectCatalogSettings

Nombre Descripción Importancia
catalogItemSyncTypes Indica los tipos de elementos de catálogo que se pueden sincronizar. Matriz de cadenas que contiene cualquiera de:
'EnvironmentDefinition' (Definición de entorno)
'Definición de imagen'

ProjectCustomizationManagedIdentity

Nombre Descripción Importancia
identityResourceId Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity. cuerda / cadena
tipo de identidad Los valores pueden ser systemAssignedIdentity o userAssignedIdentity 'systemAssignedIdentity'
'userAssignedIdentity'

ProjectCustomizationSettings

Nombre Descripción Importancia
Identidades Las identidades que se pueden usar en escenarios de personalización; por ejemplo, para clonar un repositorio. ProjectCustomizationManagedIdentity[]
userCustomizationsEnableStatus Indica si las personalizaciones de usuario están habilitadas. 'Deshabilitado'
'Habilitado'

ProjectProperties

Nombre Descripción Importancia
azureAiServicesSettings Indica si los servicios de Azure AI están habilitados para un proyecto. AzureAiServicesSettings
catalogSettings Configuración que se usará al asociar un proyecto con un catálogo. ProjectCatalogSettings
customizationSettings Configuración que se utilizará para las personalizaciones. ProjectCustomizationSettings
descripción Descripción del proyecto. cuerda / cadena
devBoxAutoDeleteSettings Configuración de eliminación automática del Dev Box. DevBoxAutoDeleteSettings
devCenterId Identificador de recurso de un DevCenter asociado cuerda / cadena
Nombre para mostrar Nombre para mostrar del proyecto. cuerda / cadena
maxDevBoxesPerUser Cuando se especifica, limita el número máximo de Dev Boxes que un solo usuario puede crear en todos los grupos del proyecto. Esto no tendrá ningún efecto en los boxes de desarrollo existentes cuando se reduzca. Int

Restricciones:
Valor mínimo = 0
serverlessGpuSessionsSettings Configuración que se utilizará para la GPU sin servidor. ServerlessGpuSessionsSettings
workspaceStorageSettings Configuración que se utilizará para el almacenamiento del espacio de trabajo. WorkspaceStorageSettings

ServerlessGpuSessionsSettings

Nombre Descripción Importancia
maxConcurrentSessionsPerProject Cuando se especifica, limita el número máximo de sesiones simultáneas en todos los grupos del proyecto. Int

Restricciones:
Valor mínimo = 1
serverlessGpuSessionsMode La propiedad indica si el acceso a GPU sin servidor está habilitado en el proyecto. 'Despliegue automático'
'Deshabilitado'

TrackedResourceTags

Nombre Descripción Importancia

UserAssignedIdentities

Nombre Descripción Importancia

IdentidadAsignadaPorElUsuario

Nombre Descripción Importancia

WorkspaceStorageSettings

Nombre Descripción Importancia
workspaceStorageMode Indica si el almacenamiento del área de trabajo está habilitado. 'Despliegue automático'
'Deshabilitado'

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 Descripción
Configurar entornos de implementación Esta plantilla proporciona una manera de configurar entornos de implementación.
configuración del servicio Dev Box Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box (/azure/dev-box/quickstart-create-dev-box). Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer cuadro de desarrollo.
Implementación del servicio Dev Box Esta plantilla proporciona una forma de configurar todos los recursos necesarios para crear un Dev Box.
Implementación de Dev Box Service con una imagen integrada Esta plantilla proporciona una manera de implementar un servicio Dev Box con una imagen integrada.

Definición de recursos de plantilla de ARM

El tipo de recurso projects se puede implementar con operaciones destinadas a:

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, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.DevCenter/projects",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "azureAiServicesSettings": {
      "azureAiServicesMode": "string"
    },
    "catalogSettings": {
      "catalogItemSyncTypes": [ "string" ]
    },
    "customizationSettings": {
      "identities": [
        {
          "identityResourceId": "string",
          "identityType": "string"
        }
      ],
      "userCustomizationsEnableStatus": "string"
    },
    "description": "string",
    "devBoxAutoDeleteSettings": {
      "deleteMode": "string",
      "gracePeriod": "string",
      "inactiveThreshold": "string"
    },
    "devCenterId": "string",
    "displayName": "string",
    "maxDevBoxesPerUser": "int",
    "serverlessGpuSessionsSettings": {
      "maxConcurrentSessionsPerProject": "int",
      "serverlessGpuSessionsMode": "string"
    },
    "workspaceStorageSettings": {
      "workspaceStorageMode": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

Microsoft.DevCenter/projects

Nombre Descripción Importancia
apiVersion La versión de api "2025-04-01-preview"
identidad Propiedades de identidad administrada managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

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

AzureAiServicesSettings

Nombre Descripción Importancia
azureAiServicesMode La propiedad indica si los servicios de Azure AI están habilitados. 'Despliegue automático'
'Deshabilitado'

DevBoxAutoDeleteSettings

Nombre Descripción Importancia
deleteMode Indica el modo de eliminación de los equipos de desarrollo dentro de este proyecto. 'Auto'
'Manual'
período de gracia ISO8601 tiempo necesario para que el cuadro de desarrollo se marque para su eliminación antes de que se elimine. ISO8601 formato PT[n]H[n]M[n]S. cuerda / cadena
inactiveThreshold ISO8601 tiempo necesario para que el equipo de desarrollo no esté inactivo antes de que se programe su eliminación. ISO8601 formato PT[n]H[n]M[n]S. cuerda / cadena

ManagedServiceIdentity

Nombre Descripción Importancia
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario 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

ProjectCatalogSettings

Nombre Descripción Importancia
catalogItemSyncTypes Indica los tipos de elementos de catálogo que se pueden sincronizar. Matriz de cadenas que contiene cualquiera de:
'EnvironmentDefinition' (Definición de entorno)
'Definición de imagen'

ProjectCustomizationManagedIdentity

Nombre Descripción Importancia
identityResourceId Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity. cuerda / cadena
tipo de identidad Los valores pueden ser systemAssignedIdentity o userAssignedIdentity 'systemAssignedIdentity'
'userAssignedIdentity'

ProjectCustomizationSettings

Nombre Descripción Importancia
Identidades Las identidades que se pueden usar en escenarios de personalización; por ejemplo, para clonar un repositorio. ProjectCustomizationManagedIdentity[]
userCustomizationsEnableStatus Indica si las personalizaciones de usuario están habilitadas. 'Deshabilitado'
'Habilitado'

ProjectProperties

Nombre Descripción Importancia
azureAiServicesSettings Indica si los servicios de Azure AI están habilitados para un proyecto. AzureAiServicesSettings
catalogSettings Configuración que se usará al asociar un proyecto con un catálogo. ProjectCatalogSettings
customizationSettings Configuración que se utilizará para las personalizaciones. ProjectCustomizationSettings
descripción Descripción del proyecto. cuerda / cadena
devBoxAutoDeleteSettings Configuración de eliminación automática del Dev Box. DevBoxAutoDeleteSettings
devCenterId Identificador de recurso de un DevCenter asociado cuerda / cadena
Nombre para mostrar Nombre para mostrar del proyecto. cuerda / cadena
maxDevBoxesPerUser Cuando se especifica, limita el número máximo de Dev Boxes que un solo usuario puede crear en todos los grupos del proyecto. Esto no tendrá ningún efecto en los boxes de desarrollo existentes cuando se reduzca. Int

Restricciones:
Valor mínimo = 0
serverlessGpuSessionsSettings Configuración que se utilizará para la GPU sin servidor. ServerlessGpuSessionsSettings
workspaceStorageSettings Configuración que se utilizará para el almacenamiento del espacio de trabajo. WorkspaceStorageSettings

ServerlessGpuSessionsSettings

Nombre Descripción Importancia
maxConcurrentSessionsPerProject Cuando se especifica, limita el número máximo de sesiones simultáneas en todos los grupos del proyecto. Int

Restricciones:
Valor mínimo = 1
serverlessGpuSessionsMode La propiedad indica si el acceso a GPU sin servidor está habilitado en el proyecto. 'Despliegue automático'
'Deshabilitado'

TrackedResourceTags

Nombre Descripción Importancia

UserAssignedIdentities

Nombre Descripción Importancia

IdentidadAsignadaPorElUsuario

Nombre Descripción Importancia

WorkspaceStorageSettings

Nombre Descripción Importancia
workspaceStorageMode Indica si el almacenamiento del área de trabajo está habilitado. 'Despliegue automático'
'Deshabilitado'

Ejemplos de uso

Plantillas de inicio rápido de Azure

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

Plantilla Descripción
Configurar entornos de implementación

Implementación en Azure 		Esta plantilla proporciona una manera de configurar entornos de implementación.
configuración del servicio Dev Box

Implementación en Azure 		Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box (/azure/dev-box/quickstart-create-dev-box). Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer cuadro de desarrollo.
Implementación del servicio Dev Box

Implementación en Azure 		Esta plantilla proporciona una forma de configurar todos los recursos necesarios para crear un Dev Box.
Implementación de Dev Box Service con una imagen integrada

Implementación en Azure 		Esta plantilla proporciona una manera de implementar un servicio Dev Box con una imagen integrada.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso projects se puede implementar con operaciones destinadas a:

  • grupos de recursos de

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, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/projects@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      azureAiServicesSettings = {
        azureAiServicesMode = "string"
      }
      catalogSettings = {
        catalogItemSyncTypes = [
          "string"
        ]
      }
      customizationSettings = {
        identities = [
          {
            identityResourceId = "string"
            identityType = "string"
          }
        ]
        userCustomizationsEnableStatus = "string"
      }
      description = "string"
      devBoxAutoDeleteSettings = {
        deleteMode = "string"
        gracePeriod = "string"
        inactiveThreshold = "string"
      }
      devCenterId = "string"
      displayName = "string"
      maxDevBoxesPerUser = int
      serverlessGpuSessionsSettings = {
        maxConcurrentSessionsPerProject = int
        serverlessGpuSessionsMode = "string"
      }
      workspaceStorageSettings = {
        workspaceStorageMode = "string"
      }
    }
  }
}

Valores de propiedad

Microsoft.DevCenter/projects

Nombre Descripción Importancia
identidad Propiedades de identidad administrada managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
Propiedades Propiedades de un proyecto. ProjectProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.DevCenter/projects@2025-04-01-preview"

AzureAiServicesSettings

Nombre Descripción Importancia
azureAiServicesMode La propiedad indica si los servicios de Azure AI están habilitados. 'Despliegue automático'
'Deshabilitado'

DevBoxAutoDeleteSettings

Nombre Descripción Importancia
deleteMode Indica el modo de eliminación de los equipos de desarrollo dentro de este proyecto. 'Auto'
'Manual'
período de gracia ISO8601 tiempo necesario para que el cuadro de desarrollo se marque para su eliminación antes de que se elimine. ISO8601 formato PT[n]H[n]M[n]S. cuerda / cadena
inactiveThreshold ISO8601 tiempo necesario para que el equipo de desarrollo no esté inactivo antes de que se programe su eliminación. ISO8601 formato PT[n]H[n]M[n]S. cuerda / cadena

ManagedServiceIdentity

Nombre Descripción Importancia
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
identidades asignadas por el usuario 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

ProjectCatalogSettings

Nombre Descripción Importancia
catalogItemSyncTypes Indica los tipos de elementos de catálogo que se pueden sincronizar. Matriz de cadenas que contiene cualquiera de:
'EnvironmentDefinition' (Definición de entorno)
'Definición de imagen'

ProjectCustomizationManagedIdentity

Nombre Descripción Importancia
identityResourceId Por ejemplo: /subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/<grupo de recursos>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId. Mutuamente excluyente con identityType systemAssignedIdentity. cuerda / cadena
tipo de identidad Los valores pueden ser systemAssignedIdentity o userAssignedIdentity 'systemAssignedIdentity'
'userAssignedIdentity'

ProjectCustomizationSettings

Nombre Descripción Importancia
Identidades Las identidades que se pueden usar en escenarios de personalización; por ejemplo, para clonar un repositorio. ProjectCustomizationManagedIdentity[]
userCustomizationsEnableStatus Indica si las personalizaciones de usuario están habilitadas. 'Deshabilitado'
'Habilitado'

ProjectProperties

Nombre Descripción Importancia
azureAiServicesSettings Indica si los servicios de Azure AI están habilitados para un proyecto. AzureAiServicesSettings
catalogSettings Configuración que se usará al asociar un proyecto con un catálogo. ProjectCatalogSettings
customizationSettings Configuración que se utilizará para las personalizaciones. ProjectCustomizationSettings
descripción Descripción del proyecto. cuerda / cadena
devBoxAutoDeleteSettings Configuración de eliminación automática del Dev Box. DevBoxAutoDeleteSettings
devCenterId Identificador de recurso de un DevCenter asociado cuerda / cadena
Nombre para mostrar Nombre para mostrar del proyecto. cuerda / cadena
maxDevBoxesPerUser Cuando se especifica, limita el número máximo de Dev Boxes que un solo usuario puede crear en todos los grupos del proyecto. Esto no tendrá ningún efecto en los boxes de desarrollo existentes cuando se reduzca. Int

Restricciones:
Valor mínimo = 0
serverlessGpuSessionsSettings Configuración que se utilizará para la GPU sin servidor. ServerlessGpuSessionsSettings
workspaceStorageSettings Configuración que se utilizará para el almacenamiento del espacio de trabajo. WorkspaceStorageSettings

ServerlessGpuSessionsSettings

Nombre Descripción Importancia
maxConcurrentSessionsPerProject Cuando se especifica, limita el número máximo de sesiones simultáneas en todos los grupos del proyecto. Int

Restricciones:
Valor mínimo = 1
serverlessGpuSessionsMode La propiedad indica si el acceso a GPU sin servidor está habilitado en el proyecto. 'Despliegue automático'
'Deshabilitado'

TrackedResourceTags

Nombre Descripción Importancia

UserAssignedIdentities

Nombre Descripción Importancia

IdentidadAsignadaPorElUsuario

Nombre Descripción Importancia

WorkspaceStorageSettings

Nombre Descripción Importancia
workspaceStorageMode Indica si el almacenamiento del área de trabajo está habilitado. 'Despliegue automático'
'Deshabilitado'