Partilhar via


Devcenters/catálogos Microsoft.DevCenter

Definição de recursos do bíceps

O tipo de recurso devcenters/catalogs 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/devcenters/catalogs, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.DevCenter/devcenters/catalogs@2025-10-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    adoGit: {
      branch: 'string'
      path: 'string'
      secretIdentifier: 'string'
      uri: 'string'
    }
    autoImageBuildEnableStatus: 'string'
    gitHub: {
      branch: 'string'
      path: 'string'
      secretIdentifier: 'string'
      uri: 'string'
    }
    syncType: 'string'
    tags: {
      {customized property}: 'string'
    }
  }
}

Valores de propriedade

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
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: devcenters
properties Propriedades do catálogo. CatalogProperties

CatalogProperties

Name Description Value
adoGit Propriedades para um tipo de catálogo do Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indica se o catálogo está configurado para criar automaticamente definições de imagem. O padrão é ativado. 'Desativado'
'Habilitado'
gitHub Propriedades para um tipo de catálogo do GitHub. GitCatalog
syncType Indica o tipo de sincronização configurado para o catálogo. 'Manual'
'Scheduled'
tags Tags de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
ramificar Ramo Git. cadeia (de caracteres)
caminho A pasta onde os itens do catálogo podem ser encontrados dentro do repositório. cadeia (de caracteres)
secretIdentifier Uma referência ao segredo do Cofre da Chave que contém um token de segurança para autenticação em um repositório Git. cadeia (de caracteres)
uri Git URI. cadeia (de caracteres)

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 devcenters/catalogs 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/devcenters/catalogs, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.DevCenter/devcenters/catalogs",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "properties": {
    "adoGit": {
      "branch": "string",
      "path": "string",
      "secretIdentifier": "string",
      "uri": "string"
    },
    "autoImageBuildEnableStatus": "string",
    "gitHub": {
      "branch": "string",
      "path": "string",
      "secretIdentifier": "string",
      "uri": "string"
    },
    "syncType": "string",
    "tags": {
      "{customized property}": "string"
    }
  }
}

Valores de propriedade

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
apiVersion A versão api '2025-10-01-pré-visualização'
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 do catálogo. CatalogProperties
tipo O tipo de recurso 'Microsoft.DevCenter/devcenters/catalogs'

CatalogProperties

Name Description Value
adoGit Propriedades para um tipo de catálogo do Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indica se o catálogo está configurado para criar automaticamente definições de imagem. O padrão é ativado. 'Desativado'
'Habilitado'
gitHub Propriedades para um tipo de catálogo do GitHub. GitCatalog
syncType Indica o tipo de sincronização configurado para o catálogo. 'Manual'
'Scheduled'
tags Tags de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
ramificar Ramo Git. cadeia (de caracteres)
caminho A pasta onde os itens do catálogo podem ser encontrados dentro do repositório. cadeia (de caracteres)
secretIdentifier Uma referência ao segredo do Cofre da Chave que contém um token de segurança para autenticação em um repositório Git. cadeia (de caracteres)
uri Git URI. cadeia (de caracteres)

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 devcenters/catalogs 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/devcenters/catalogs, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters/catalogs@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      adoGit = {
        branch = "string"
        path = "string"
        secretIdentifier = "string"
        uri = "string"
      }
      autoImageBuildEnableStatus = "string"
      gitHub = {
        branch = "string"
        path = "string"
        secretIdentifier = "string"
        uri = "string"
      }
      syncType = "string"
      tags = {
        {customized property} = "string"
      }
    }
  }
}

Valores de propriedade

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
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 para recurso do tipo: devcenters
properties Propriedades do catálogo. CatalogProperties
tipo O tipo de recurso "Microsoft.DevCenter/devcenters/catalogs@2025-10-01-preview"

CatalogProperties

Name Description Value
adoGit Propriedades para um tipo de catálogo do Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indica se o catálogo está configurado para criar automaticamente definições de imagem. O padrão é ativado. 'Desativado'
'Habilitado'
gitHub Propriedades para um tipo de catálogo do GitHub. GitCatalog
syncType Indica o tipo de sincronização configurado para o catálogo. 'Manual'
'Scheduled'
tags Tags de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
ramificar Ramo Git. cadeia (de caracteres)
caminho A pasta onde os itens do catálogo podem ser encontrados dentro do repositório. cadeia (de caracteres)
secretIdentifier Uma referência ao segredo do Cofre da Chave que contém um token de segurança para autenticação em um repositório Git. cadeia (de caracteres)
uri Git URI. cadeia (de caracteres)

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação do Catálogo do Centro de Desenvolvimento.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus"
}

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      = "${substr(var.resource_name, 0, 22)}-dc"
  location  = var.location
  identity {
    type = "SystemAssigned"
  }
  body = {
    properties = {}
  }
}

resource "azapi_resource" "catalog" {
  type      = "Microsoft.DevCenter/devCenters/catalogs@2025-02-01"
  parent_id = azapi_resource.devCenter.id
  name      = "${substr(var.resource_name, 0, 17)}-catalog"
  body = {
    properties = {
      adoGit = {
        branch           = "main"
        path             = "/template"
        secretIdentifier = "https://amlim-kv.vault.azure.net/secrets/ado/6279752c2bdd4a38a3e79d958cc36a75"
        uri              = "https://amlim@dev.azure.com/amlim/testCatalog/_git/testCatalog"
      }
    }
  }
}