Progetti/environmentTypes di Microsoft.DevCenter

• Latest
• Anteprima 2026-01-01-
• 2025-10-01-anteprima
• 2025-07-01-preview
• 2025-04-01-preview
• 2025-02-01
• 2024-10-01-preview
• 2024-08-01-preview
• 2024-07-01-preview
• 2024-06-01-preview
• 2024-05-01-preview
• 2024-02-01
• 2023-10-01-preview
• 2023-08-01-preview
• 2023-04-01
• 2023-01-01-preview
• 2022-11-11-preview
• 2022-10-12-preview
• 2022-09-01-preview
• 2022-08-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa projects/environmentTypes può essere distribuito con operazioni destinate a:

• gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione del tipo di ambiente del progetto Dev Center.

param resourceName string
param location string

resource project 'Microsoft.DevCenter/projects@2025-02-01' = {
  name: '${resourceName}-proj'
  location: location
  properties: {
    description: ''
    devCenterId: devCenter.id
    maxDevBoxesPerUser: 0
  }
}

resource environmenttype1 'Microsoft.DevCenter/projects/environmentTypes@2025-02-01' = {
  name: 'azapi_resource.environmentType.name'
  parent: project
  properties: {
    deploymentTargetId: '/subscriptions/${subscription().subscriptionId}'
    status: 'Enabled'
  }
}

resource devCenter 'Microsoft.DevCenter/devCenters@2025-02-01' = {
  name: resourceName
  location: location
  properties: {}
}

resource environmentType 'Microsoft.DevCenter/devCenters/environmentTypes@2025-02-01' = {
  name: '${resourceName}-envtype'
  parent: devCenter
}

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite	Description
Configurare il servizio Ambienti di distribuzione	Questo modello consente di configurare gli ambienti di distribuzione.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/projects/environmentTypes, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/projects/environmentTypes

Name	Description	Value
identity	Proprietà dell'identità gestita.	ManagedServiceIdentity
location	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
name	Nome della risorsa	string Constraints: Lunghezza minima = 3 Lunghezza massima = 63 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
parent	In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.	Nome simbolico per la risorsa di tipo: progetti
properties	Proprietà di un tipo di ambiente.	ProjectEnvironmentTypeProperties
tags	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

EnvironmentRole

Name	Description	Value

ManagedServiceIdentity

Name	Description	Value
type	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
userAssignedIdentities	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name	Description	Value
creatorRoleAssignment	Definizione del ruolo assegnata all'autore dell'ambiente sulle risorse di backup.	ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId	ID di una sottoscrizione a cui verrà eseguito il mapping del tipo di ambiente. Le risorse dell'ambiente verranno distribuite in questa sottoscrizione.	string
displayName	Nome visualizzato del tipo di ambiente del progetto.	string
status	Definisce se questo tipo di ambiente può essere utilizzato in questo progetto.	'Disabled' 'Enabled'
userRoleAssignments	Assegnazioni di ruolo create nelle risorse di backup dell'ambiente. Si tratta di un mapping da un ID oggetto utente a un oggetto di ID definizione ruolo.	ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name	Description	Value
roles	Mappa dei ruoli da assegnare all'autore dell'ambiente.	ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name	Description	Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name	Description	Value

TrackedResourceTags

Name	Description	Value

UserAssignedIdentities

Name	Description	Value

UserAssignedIdentity

Name	Description	Value

UserRoleAssignment

Name	Description	Value
roles	Mappa dei ruoli da assegnare all'utente padre.	UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name	Description	Value

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa projects/environmentTypes può essere distribuito con operazioni destinate a:

• Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Template	Description
Configurare il servizio Ambienti di distribuzione	Questo modello consente di configurare gli ambienti di distribuzione.

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/projects/environmentTypes, aggiungere il codice JSON seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/projects/environmentTypes

Name	Description	Value
apiVersion	Versione dell'API	'anteprima 2026-01-01-preview'
identity	Proprietà dell'identità gestita.	ManagedServiceIdentity
location	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
name	Nome della risorsa	string Constraints: Lunghezza minima = 3 Lunghezza massima = 63 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
properties	Proprietà di un tipo di ambiente.	ProjectEnvironmentTypeProperties
tags	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
type	Tipo di risorsa	'Microsoft.DevCenter/projects/environmentTypes'

EnvironmentRole

Name	Description	Value

ManagedServiceIdentity

Name	Description	Value
type	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
userAssignedIdentities	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name	Description	Value
creatorRoleAssignment	Definizione del ruolo assegnata all'autore dell'ambiente sulle risorse di backup.	ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId	ID di una sottoscrizione a cui verrà eseguito il mapping del tipo di ambiente. Le risorse dell'ambiente verranno distribuite in questa sottoscrizione.	string
displayName	Nome visualizzato del tipo di ambiente del progetto.	string
status	Definisce se questo tipo di ambiente può essere utilizzato in questo progetto.	'Disabled' 'Enabled'
userRoleAssignments	Assegnazioni di ruolo create nelle risorse di backup dell'ambiente. Si tratta di un mapping da un ID oggetto utente a un oggetto di ID definizione ruolo.	ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name	Description	Value
roles	Mappa dei ruoli da assegnare all'autore dell'ambiente.	ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name	Description	Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name	Description	Value

TrackedResourceTags

Name	Description	Value

UserAssignedIdentities

Name	Description	Value

UserAssignedIdentity

Name	Description	Value

UserRoleAssignment

Name	Description	Value
roles	Mappa dei ruoli da assegnare all'utente padre.	UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name	Description	Value

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa projects/environmentTypes può essere distribuito con operazioni destinate a:

• Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione del tipo di ambiente del progetto Dev Center.

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"
    }
  }
}

Formato risorsa

Per creare una risorsa Microsoft.DevCenter/projects/environmentTypes, aggiungere il file Terraform seguente al modello.

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

Valori delle proprietà

Microsoft.DevCenter/projects/environmentTypes

Name	Description	Value
identity	Proprietà dell'identità gestita.	ManagedServiceIdentity
location	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
name	Nome della risorsa	string Constraints: Lunghezza minima = 3 Lunghezza massima = 63 Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: progetti
properties	Proprietà di un tipo di ambiente.	ProjectEnvironmentTypeProperties
tags	Tag delle risorse	Dizionario di nomi e valori di tag.
type	Tipo di risorsa	"Microsoft.DevCenter/projects/environmentTypes@2026-01-01-preview"

EnvironmentRole

Name	Description	Value

ManagedServiceIdentity

Name	Description	Value
type	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
userAssignedIdentities	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name	Description	Value
creatorRoleAssignment	Definizione del ruolo assegnata all'autore dell'ambiente sulle risorse di backup.	ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId	ID di una sottoscrizione a cui verrà eseguito il mapping del tipo di ambiente. Le risorse dell'ambiente verranno distribuite in questa sottoscrizione.	string
displayName	Nome visualizzato del tipo di ambiente del progetto.	string
status	Definisce se questo tipo di ambiente può essere utilizzato in questo progetto.	'Disabled' 'Enabled'
userRoleAssignments	Assegnazioni di ruolo create nelle risorse di backup dell'ambiente. Si tratta di un mapping da un ID oggetto utente a un oggetto di ID definizione ruolo.	ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name	Description	Value
roles	Mappa dei ruoli da assegnare all'autore dell'ambiente.	ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Name	Description	Value

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Name	Description	Value

TrackedResourceTags

Name	Description	Value

UserAssignedIdentities

Name	Description	Value

UserAssignedIdentity

Name	Description	Value

UserRoleAssignment

Name	Description	Value
roles	Mappa dei ruoli da assegnare all'utente padre.	UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name	Description	Value