Microsoft.Devcenters/каталоги 2026-01-01-preview

Определение ресурсов Bicep

Тип ресурса devcenters/catalogs можно развернуть с помощью операций, предназначенных для следующих целей:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/devcenters/catalogs, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.DevCenter/devcenters/catalogs@2026-01-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'
    }
  }
}

Значения свойств

Microsoft.DevCenter/devcenters/catalogs

Имя Description Ценность
имя имя ресурса. string

Constraints:
Минимальная длина = 3
Максимальная длина = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (обязательно)
parent В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе "Дочерний ресурс вне родительского ресурса".
Символьное имя ресурса типа: центрам разработки
properties Свойства каталога. CatalogProperties

CatalogProperties

Имя Description Ценность
adoGit Свойства для типа каталога Azure DevOps. GitCatalog
autoImageBuildEnableStatus Указывает, настроен ли каталог на автоматическое построение определений образов. По умолчанию включено. 'Disabled'
'Enabled'
gitHub Свойства для типа каталога GitHub. GitCatalog
syncType Указывает тип синхронизации, настроенный для каталога. «Ручной»
"Запланировано"
tags Теги ресурсов. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Имя Description Ценность

GitCatalog

Имя Description Ценность
ветвь Ветвь Git. струна
путь Папка, в которой элементы каталога находятся в репозитории. струна
secretIdentifier Ссылка на секрет Key Vault, содержащий маркер безопасности для проверки подлинности в репозитории Git. струна
УРИ URI Git. струна

Примеры использования

Примеры Bicep

Простой пример развертывания каталога Центра разработки.

param resourceName string = 'acctest0001'
param location string = 'westus'

resource devCenter 'Microsoft.DevCenter/devCenters@2025-02-01' = {
  name: '${substring(resourceName, 0, 22)}-dc'
  location: location
  properties: {}
}

resource catalog 'Microsoft.DevCenter/devCenters/catalogs@2025-02-01' = {
  parent: devCenter
  name: '${substring(resourceName, 0, 17)}-catalog'
  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'
    }
  }
}

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Файл Bicep Description
Настройка службы сред развертывания Этот шаблон предоставляет способ настройки сред развертывания.

Определение ресурса шаблона ARM

Тип ресурса devcenters/catalogs можно развернуть с помощью операций, предназначенных для следующих целей:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/devcenters/catalogs, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.DevCenter/devcenters/catalogs",
  "apiVersion": "2026-01-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"
    }
  }
}

Значения свойств

Microsoft.DevCenter/devcenters/catalogs

Имя Description Ценность
apiVersion Версия API «2026-01-01-превью»
имя имя ресурса. string

Constraints:
Минимальная длина = 3
Максимальная длина = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (обязательно)
properties Свойства каталога. CatalogProperties
type Тип ресурса 'Microsoft.DevCenter/devcenters/catalogs'

CatalogProperties

Имя Description Ценность
adoGit Свойства для типа каталога Azure DevOps. GitCatalog
autoImageBuildEnableStatus Указывает, настроен ли каталог на автоматическое построение определений образов. По умолчанию включено. 'Disabled'
'Enabled'
gitHub Свойства для типа каталога GitHub. GitCatalog
syncType Указывает тип синхронизации, настроенный для каталога. «Ручной»
"Запланировано"
tags Теги ресурсов. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Имя Description Ценность

GitCatalog

Имя Description Ценность
ветвь Ветвь Git. струна
путь Папка, в которой элементы каталога находятся в репозитории. струна
secretIdentifier Ссылка на секрет Key Vault, содержащий маркер безопасности для проверки подлинности в репозитории Git. струна
УРИ URI Git. струна

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template Description
Настройка службы сред развертывания

Развертывание в Azure
Этот шаблон предоставляет способ настройки сред развертывания.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса devcenters/catalogs можно развернуть с помощью операций, предназначенных для следующих целей:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevCenter/devcenters/catalogs, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevCenter/devcenters/catalogs@2026-01-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"
      }
    }
  }
}

Значения свойств

Microsoft.DevCenter/devcenters/catalogs

Имя Description Ценность
имя имя ресурса. string

Constraints:
Минимальная длина = 3
Максимальная длина = 63
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: центра разработки
properties Свойства каталога. CatalogProperties
type Тип ресурса "Microsoft.DevCenter/devcenters/catalogs@2026-01-01-preview"

CatalogProperties

Имя Description Ценность
adoGit Свойства для типа каталога Azure DevOps. GitCatalog
autoImageBuildEnableStatus Указывает, настроен ли каталог на автоматическое построение определений образов. По умолчанию включено. 'Disabled'
'Enabled'
gitHub Свойства для типа каталога GitHub. GitCatalog
syncType Указывает тип синхронизации, настроенный для каталога. «Ручной»
"Запланировано"
tags Теги ресурсов. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Имя Description Ценность

GitCatalog

Имя Description Ценность
ветвь Ветвь Git. струна
путь Папка, в которой элементы каталога находятся в репозитории. струна
secretIdentifier Ссылка на секрет Key Vault, содержащий маркер безопасности для проверки подлинности в репозитории Git. струна
УРИ URI Git. струна

Примеры использования

Примеры Terraform

Простой пример развертывания каталога Центра разработки.

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