Udostępnij przez


Microsoft.DevCenter devcenters/catalogs

Definicja zasobu Bicep

Typ zasobu devcenters/catalogs można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/devcenters/catalogs, dodaj następujący kod Bicep do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: centrów deweloperskich
properties Właściwości katalogu. CatalogProperties

CatalogProperties

Name Description Value
adoGit Właściwości typu wykazu usługi Azure DevOps. GitCatalog
autoImageBuildEnableStatus (stan włączenia) Wskazuje, czy wykaz jest skonfigurowany do automatycznego kompilowania definicji obrazów. Wartość domyślna to włączona. "Wyłączone"
"Włączone"
gitHub Właściwości typu wykazu usługi GitHub. GitCatalog
syncType Wskazuje typ synchronizacji skonfigurowany dla wykazu. 'Manual'
'Scheduled'
tags Tagi zasobów. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Gałąź usługi Git. ciąg
ścieżka Folder, w którym można znaleźć elementy wykazu w repozytorium. ciąg
secretIdentifier Odwołanie do wpisu tajnego usługi Key Vault zawierającego token zabezpieczający do uwierzytelniania w repozytorium Git. ciąg
uri Identyfikator URI usługi Git. ciąg

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Description
Konfigurowanie usługi środowiska wdrażania Ten szablon umożliwia konfigurowanie środowisk wdrażania.

Definicja zasobu szablonu usługi ARM

Typ zasobu devcenters/catalogs można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/devcenters/catalogs, dodaj następujący kod JSON do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
apiVersion Wersja interfejsu API "2025-10-01-podgląd"
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane)
properties Właściwości katalogu. CatalogProperties
typ Typ zasobu 'Microsoft.DevCenter/devcenters/catalogs'

CatalogProperties

Name Description Value
adoGit Właściwości typu wykazu usługi Azure DevOps. GitCatalog
autoImageBuildEnableStatus (stan włączenia) Wskazuje, czy wykaz jest skonfigurowany do automatycznego kompilowania definicji obrazów. Wartość domyślna to włączona. "Wyłączone"
"Włączone"
gitHub Właściwości typu wykazu usługi GitHub. GitCatalog
syncType Wskazuje typ synchronizacji skonfigurowany dla wykazu. 'Manual'
'Scheduled'
tags Tagi zasobów. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Gałąź usługi Git. ciąg
ścieżka Folder, w którym można znaleźć elementy wykazu w repozytorium. ciąg
secretIdentifier Odwołanie do wpisu tajnego usługi Key Vault zawierającego token zabezpieczający do uwierzytelniania w repozytorium Git. ciąg
uri Identyfikator URI usługi Git. ciąg

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Template Description
Konfigurowanie usługi środowiska wdrażania

wdrażanie w usłudze Azure
Ten szablon umożliwia konfigurowanie środowisk wdrażania.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu devcenters/catalogs można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevCenter/devcenters/catalogs, dodaj następujący program Terraform do szablonu.

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

Wartości właściwości

Microsoft.DevCenter/devcenters/catalogs

Name Description Value
name Nazwa zasobu string

Constraints:
Minimalna długość = 3
Maksymalna długość = 63
Wzorzec = ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$ (wymagane)
parent_id Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: centrów deweloperskich
properties Właściwości katalogu. CatalogProperties
typ Typ zasobu "Microsoft.DevCenter/devcenters/catalogs@2025-10-01-preview"

CatalogProperties

Name Description Value
adoGit Właściwości typu wykazu usługi Azure DevOps. GitCatalog
autoImageBuildEnableStatus (stan włączenia) Wskazuje, czy wykaz jest skonfigurowany do automatycznego kompilowania definicji obrazów. Wartość domyślna to włączona. "Wyłączone"
"Włączone"
gitHub Właściwości typu wykazu usługi GitHub. GitCatalog
syncType Wskazuje typ synchronizacji skonfigurowany dla wykazu. 'Manual'
'Scheduled'
tags Tagi zasobów. CatalogUpdatePropertiesTags

CatalogUpdatePropertiesTags

Name Description Value

GitCatalog

Name Description Value
branch Gałąź usługi Git. ciąg
ścieżka Folder, w którym można znaleźć elementy wykazu w repozytorium. ciąg
secretIdentifier Odwołanie do wpisu tajnego usługi Key Vault zawierającego token zabezpieczający do uwierzytelniania w repozytorium Git. ciąg
uri Identyfikator URI usługi Git. ciąg

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania wykazu Centrum deweloperów.

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