Partilhar via


Microsoft.DevCenter projects/environmentTypes 2026-01-01-preview

Definição de recursos do bíceps

O tipo de recurso projects/environmentTypes pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevCenter/projects/environmentTypes, adicione o seguinte Bicep ao seu modelo.

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

Valores de propriedade

Microsoft.DevCenter/projects/environmentTypes

Nome Description Valor
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
elemento principal No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte Recurso filho fora do recurso pai.
Nome simbólico para recurso do tipo: projetos
propriedades Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

EnvironmentRole

Nome Description Valor

ManagedServiceIdentity

Nome Description Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Nome Description Valor
creatorRoleAssignment A definição de função atribuída ao criador do ambiente em recursos de suporte. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Id de uma assinatura para a qual o tipo de ambiente será mapeado. Os recursos do ambiente serão implantados nesta assinatura. cadeia (de caracteres)
nome de exibição O nome para exibição do tipo de ambiente do projeto. cadeia (de caracteres)
estado Define se esse tipo de ambiente pode ser usado neste projeto. 'Disabled'
'Enabled'
userRoleAssignments Atribuições de função criadas em recursos de suporte do ambiente. Este é um mapeamento de um ID de objeto de usuário para um objeto de IDs de definição de função. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Nome Description Valor
roles Um mapa de funções a atribuir ao criador do ambiente. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Nome Description Valor

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Nome Description Valor

TrackedResourceTags

Nome Description Valor

UserAssignedIdentities

Nome Description Valor

UserAssignedIdentity

Nome Description Valor

UserRoleAssignment

Nome Description Valor
roles Um mapa de funções a atribuir ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Nome Description Valor

Exemplos de uso

Exemplos de início rápido do Azure

Os seguintes modelos de início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Description
de serviço Configurar Ambientes de Implantação Este modelo fornece uma maneira de configurar ambientes de implantação.

Definição de recurso de modelo ARM

O tipo de recurso projects/environmentTypes pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevCenter/projects/environmentTypes, adicione o seguinte JSON ao seu modelo.

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

Valores de propriedade

Microsoft.DevCenter/projects/environmentTypes

Nome Description Valor
apiVersion A versão api 'Pré-visualização 2026-01-01-Preview'
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
propriedades Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DevCenter/projects/environmentTypes'

EnvironmentRole

Nome Description Valor

ManagedServiceIdentity

Nome Description Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Nome Description Valor
creatorRoleAssignment A definição de função atribuída ao criador do ambiente em recursos de suporte. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Id de uma assinatura para a qual o tipo de ambiente será mapeado. Os recursos do ambiente serão implantados nesta assinatura. cadeia (de caracteres)
nome de exibição O nome para exibição do tipo de ambiente do projeto. cadeia (de caracteres)
estado Define se esse tipo de ambiente pode ser usado neste projeto. 'Disabled'
'Enabled'
userRoleAssignments Atribuições de função criadas em recursos de suporte do ambiente. Este é um mapeamento de um ID de objeto de usuário para um objeto de IDs de definição de função. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Nome Description Valor
roles Um mapa de funções a atribuir ao criador do ambiente. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Nome Description Valor

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Nome Description Valor

TrackedResourceTags

Nome Description Valor

UserAssignedIdentities

Nome Description Valor

UserAssignedIdentity

Nome Description Valor

UserRoleAssignment

Nome Description Valor
roles Um mapa de funções a atribuir ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Nome Description Valor

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantam esse tipo de recurso.

Template Description
de serviço Configurar Ambientes de Implantação

Implantar no Azure
Este modelo fornece uma maneira de configurar ambientes de implantação.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso projects/environmentTypes pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevCenter/projects/environmentTypes, adicione o seguinte Terraform ao seu modelo.

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} = {
            }
          }
        }
      }
    }
  }
}

Valores de propriedade

Microsoft.DevCenter/projects/environmentTypes

Nome Description Valor
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
nome O nome do recurso string

Constraints:
Comprimento mínimo = 3
Comprimento máximo = 63
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: projetos
propriedades Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DevCenter/projects/environmentTypes@2026-01-01-preview"

EnvironmentRole

Nome Description Valor

ManagedServiceIdentity

Nome Description Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Nome Description Valor
creatorRoleAssignment A definição de função atribuída ao criador do ambiente em recursos de suporte. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId Id de uma assinatura para a qual o tipo de ambiente será mapeado. Os recursos do ambiente serão implantados nesta assinatura. cadeia (de caracteres)
nome de exibição O nome para exibição do tipo de ambiente do projeto. cadeia (de caracteres)
estado Define se esse tipo de ambiente pode ser usado neste projeto. 'Disabled'
'Enabled'
userRoleAssignments Atribuições de função criadas em recursos de suporte do ambiente. Este é um mapeamento de um ID de objeto de usuário para um objeto de IDs de definição de função. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Nome Description Valor
roles Um mapa de funções a atribuir ao criador do ambiente. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignmentRoles

Nome Description Valor

ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

Nome Description Valor

TrackedResourceTags

Nome Description Valor

UserAssignedIdentities

Nome Description Valor

UserAssignedIdentity

Nome Description Valor

UserRoleAssignment

Nome Description Valor
roles Um mapa de funções a atribuir ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Nome Description Valor

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Tipo de Ambiente de Projeto do Centro de Desenvolvimento.

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