Compartilhar via


Microsoft.DevCenter projects/environmentTypes

Definição de recurso do Bicep

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

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

Formato de recurso

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

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 propriedade

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
identidade Propriedades de identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
name 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)
pai 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 o recurso do tipo: projetos
properties Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment A definição de função atribuída ao criador do ambiente no backup de recursos. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId ID de uma assinatura para a qual o tipo de ambiente será mapeado. Os recursos do ambiente serão implantados nessa assinatura. cadeia
displayName O nome de exibição do tipo de ambiente do projeto. cadeia
status Define se esse tipo de ambiente pode ser usado neste Projeto. 'Disabled'
'Enabled'
userRoleAssignments Atribuições de função criadas em recursos de backup de ambiente. Este é um mapeamento de uma ID de objeto de usuário para um objeto de IDs de definição de função. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles Um mapa de funções a serem atribuídas ao criador do 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 Um mapa de funções a serem atribuídas ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Exemplos de uso

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Description
configurar o serviço ambientes de implantação Esse modelo fornece uma maneira de configurar ambientes de implantação.

Definição de recurso de modelo do ARM

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

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

Formato de recurso

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

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

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
apiVersion A versão da API '2025-10-01-preview'
identidade Propriedades de identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
name 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)
properties Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DevCenter/projects/environmentTypes'

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment A definição de função atribuída ao criador do ambiente no backup de recursos. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId ID de uma assinatura para a qual o tipo de ambiente será mapeado. Os recursos do ambiente serão implantados nessa assinatura. cadeia
displayName O nome de exibição do tipo de ambiente do projeto. cadeia
status Define se esse tipo de ambiente pode ser usado neste Projeto. 'Disabled'
'Enabled'
userRoleAssignments Atribuições de função criadas em recursos de backup de ambiente. Este é um mapeamento de uma ID de objeto de usuário para um objeto de IDs de definição de função. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles Um mapa de funções a serem atribuídas ao criador do 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 Um mapa de funções a serem atribuídas ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template Description
configurar o serviço ambientes de implantação

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

Definição de recurso do Terraform (provedor de AzAPI)

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

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

Formato de recurso

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

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 propriedade

Microsoft.DevCenter/projects/environmentTypes

Name Description Value
identidade Propriedades de identidade gerenciada. ManagedServiceIdentity
local A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
name 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 desse recurso. ID do recurso do tipo: projetos
properties Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DevCenter/projects/environmentTypes@2025-10-01-preview"

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

ProjectEnvironmentTypeProperties

Name Description Value
creatorRoleAssignment A definição de função atribuída ao criador do ambiente no backup de recursos. ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment
deploymentTargetId ID de uma assinatura para a qual o tipo de ambiente será mapeado. Os recursos do ambiente serão implantados nessa assinatura. cadeia
displayName O nome de exibição do tipo de ambiente do projeto. cadeia
status Define se esse tipo de ambiente pode ser usado neste Projeto. 'Disabled'
'Enabled'
userRoleAssignments Atribuições de função criadas em recursos de backup de ambiente. Este é um mapeamento de uma ID de objeto de usuário para um objeto de IDs de definição de função. ProjectEnvironmentTypeUpdatePropertiesUserRoleAssignments

ProjectEnvironmentTypeUpdatePropertiesCreatorRoleAssignment

Name Description Value
roles Um mapa de funções a serem atribuídas ao criador do 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 Um mapa de funções a serem atribuídas ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Exemplos de uso

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