Partilhar via


Microsoft.DevCenter projetos/environmentTypes

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@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 gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (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)
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
properties Propriedades de um tipo de ambiente. ProjectEnvironmentTypeProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

EnvironmentRole

Name Description Value

ManagedServiceIdentity

Name Description Value
tipo Tipo de identidade de serviço gerenciado (onde 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 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

Name Description Value
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)
displayName 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

Name Description Value
roles Um mapa de funções a atribuir 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 atribuir ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Exemplos de uso

Exemplos de início rápido do Azure

Os seguintes modelos 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": "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 api '2025-10-01-pré-visualização'
identidade Propriedades de identidade gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (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 tags. Consulte Tags 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 (onde 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 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

Name Description Value
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)
displayName 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

Name Description Value
roles Um mapa de funções a atribuir 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 atribuir ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar 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@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 gerenciadas. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (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 para este 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 tags.
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 (onde 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 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

Name Description Value
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)
displayName 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

Name Description Value
roles Um mapa de funções a atribuir 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 atribuir ao usuário pai. UserRoleAssignmentRoles

UserRoleAssignmentRoles

Name Description Value

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