Partager via


Centres de développement/catalogues Microsoft.DevCenter

Définition de ressource Bicep

Le type de ressource devcenters/catalogs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevCenter/devcenters/catalogs, ajoutez le bicep suivant à votre modèle.

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

Valeurs de propriété

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name Nom de la ressource string

Constraints:
Longueur minimale = 3
Longueur maximale = 63
Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : devcenters
properties Propriétés du catalogue. CatalogProperties

CatalogProperties

Name Description Value
adoGit Propriétés d’un type de catalogue Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indique si le catalogue est configuré pour créer automatiquement des définitions d’image. La valeur par défaut est activé. 'Désactivé'
'Activé'
gitHub Propriétés d’un type de catalogue GitHub. GitCatalog
syncType Indique le type de synchronisation configuré pour le catalogue. 'Manual'
'Scheduled'
tags Balises de ressource. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Branche Git. string
path Dossier dans lequel se trouvent les éléments du catalogue dans le référentiel. string
secretIdentifier Référence au secret Key Vault contenant un jeton de sécurité pour s’authentifier auprès d’un dépôt Git. string
uri URI Git. string

Exemples d’utilisation

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Description
configurer le service Environnements de déploiement Ce modèle permet de configurer des environnements de déploiement.

Définition de ressource de modèle ARM

Le type de ressource devcenters/catalogs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevCenter/devcenters/catalogs, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriété

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
apiVersion Version de l’API '2025-10-01-preview'
name Nom de la ressource string

Constraints:
Longueur minimale = 3
Longueur maximale = 63
Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatoire)
properties Propriétés du catalogue. CatalogProperties
type Type de ressource 'Microsoft.DevCenter/devcenters/catalogs'

CatalogProperties

Name Description Value
adoGit Propriétés d’un type de catalogue Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indique si le catalogue est configuré pour créer automatiquement des définitions d’image. La valeur par défaut est activé. 'Désactivé'
'Activé'
gitHub Propriétés d’un type de catalogue GitHub. GitCatalog
syncType Indique le type de synchronisation configuré pour le catalogue. 'Manual'
'Scheduled'
tags Balises de ressource. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Branche Git. string
path Dossier dans lequel se trouvent les éléments du catalogue dans le référentiel. string
secretIdentifier Référence au secret Key Vault contenant un jeton de sécurité pour s’authentifier auprès d’un dépôt Git. string
uri URI Git. string

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Template Description
configurer le service Environnements de déploiement

Déployer sur Azure
Ce modèle permet de configurer des environnements de déploiement.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource devcenters/catalogs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DevCenter/devcenters/catalogs, ajoutez le terraform suivant à votre modèle.

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

Valeurs de propriété

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name Nom de la ressource string

Constraints:
Longueur minimale = 3
Longueur maximale = 63
Modèle = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : devcenters
properties Propriétés du catalogue. CatalogProperties
type Type de ressource « Microsoft.DevCenter/devcenters/catalogs@2025-10-01-preview »

CatalogProperties

Name Description Value
adoGit Propriétés d’un type de catalogue Azure DevOps. GitCatalog
autoImageBuildEnableStatus Indique si le catalogue est configuré pour créer automatiquement des définitions d’image. La valeur par défaut est activé. 'Désactivé'
'Activé'
gitHub Propriétés d’un type de catalogue GitHub. GitCatalog
syncType Indique le type de synchronisation configuré pour le catalogue. 'Manual'
'Scheduled'
tags Balises de ressource. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Branche Git. string
path Dossier dans lequel se trouvent les éléments du catalogue dans le référentiel. string
secretIdentifier Référence au secret Key Vault contenant un jeton de sécurité pour s’authentifier auprès d’un dépôt Git. string
uri URI Git. string

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement du catalogue du Centre de développement.

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