Compartir a través de


Microsoft.DevCenter devcenters/catalogs

Definición de recursos de Bicep

El tipo de recurso de devcenters/catalogs se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevCenter/devcenters/catalogs, agregue el siguiente bicep a la plantilla.

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 propiedad

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
parent En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: centros de desarrollo
properties Propiedades del catálogo. CatalogProperties

CatalogProperties

Name Description Value
adoGit Propiedades de un tipo de catálogo de Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indica si el catálogo está configurado para crear automáticamente definiciones de imagen. El valor predeterminado es habilitado. 'Deshabilitado'
'Habilitado'
gitHub Propiedades de un tipo de catálogo de GitHub. GitCatalog
syncType Indica el tipo de sincronización que está configurado para el catálogo. 'Manual'
'Scheduled'
tags Etiquetas de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Rama de Git. string
path Carpeta donde se pueden encontrar los elementos de catálogo dentro del repositorio. string
secretIdentifier Referencia al secreto de Key Vault que contiene un token de seguridad para autenticarse en un repositorio de Git. string
uri URI de Git. string

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Description
Configurar entornos de implementación Esta plantilla proporciona una manera de configurar entornos de implementación.

Definición de recursos de plantilla de ARM

El tipo de recurso de devcenters/catalogs se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevCenter/devcenters/catalogs, agregue el siguiente JSON a la plantilla.

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

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
apiVersion La versión de api '2025-10-01-preview'
name El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
properties Propiedades del catálogo. CatalogProperties
type El tipo de recurso 'Microsoft.DevCenter/devcenters/catalogs'

CatalogProperties

Name Description Value
adoGit Propiedades de un tipo de catálogo de Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indica si el catálogo está configurado para crear automáticamente definiciones de imagen. El valor predeterminado es habilitado. 'Deshabilitado'
'Habilitado'
gitHub Propiedades de un tipo de catálogo de GitHub. GitCatalog
syncType Indica el tipo de sincronización que está configurado para el catálogo. 'Manual'
'Scheduled'
tags Etiquetas de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Rama de Git. string
path Carpeta donde se pueden encontrar los elementos de catálogo dentro del repositorio. string
secretIdentifier Referencia al secreto de Key Vault que contiene un token de seguridad para autenticarse en un repositorio de Git. string
uri URI de Git. string

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Template Description
Configurar entornos de implementación

Implementación en Azure
Esta plantilla proporciona una manera de configurar entornos de implementación.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso de devcenters/catalogs se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevCenter/devcenters/catalogs, agregue el siguiente terraform a la plantilla.

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 propiedad

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name El nombre del recurso string

Constraints:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: centros de desarrollo
properties Propiedades del catálogo. CatalogProperties
type El tipo de recurso "Microsoft.DevCenter/devcenters/catalogs@2025-10-01-preview"

CatalogProperties

Name Description Value
adoGit Propiedades de un tipo de catálogo de Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indica si el catálogo está configurado para crear automáticamente definiciones de imagen. El valor predeterminado es habilitado. 'Deshabilitado'
'Habilitado'
gitHub Propiedades de un tipo de catálogo de GitHub. GitCatalog
syncType Indica el tipo de sincronización que está configurado para el catálogo. 'Manual'
'Scheduled'
tags Etiquetas de recursos. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Rama de Git. string
path Carpeta donde se pueden encontrar los elementos de catálogo dentro del repositorio. string
secretIdentifier Referencia al secreto de Key Vault que contiene un token de seguridad para autenticarse en un repositorio de Git. string
uri URI de Git. string

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación del catálogo del Centro de desarrollo.

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