Sdílet prostřednictvím


Fondy infrastruktury Microsoft.DevOpsInfrastructure

Definice prostředku Bicep

Typ prostředku fondů je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevOpsInfrastructure/pools, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(...)
      resourcePredictionsProfile: {
        kind: 'string'
        // For remaining properties, see ResourcePredictionsProfile objects
      }
      kind: 'string'
      // For remaining properties, see AgentProfile objects
    }
    devCenterProjectResourceId: 'string'
    fabricProfile: {
      kind: 'string'
      // For remaining properties, see FabricProfile objects
    }
    maximumConcurrency: int
    organizationProfile: {
      kind: 'string'
      // For remaining properties, see OrganizationProfile objects
    }
    provisioningState: 'string'
    runtimeConfiguration: {
      workFolder: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objekty AgentProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Stateful použijte:

{
  gracePeriodTimeSpan: 'string'
  kind: 'Stateful'
  maxAgentLifetime: 'string'
}

V případě bezstavové metody použijte:

{
  kind: 'Stateless'
}

Objekty FabricProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Vmss použijte:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      ephemeralType: 'string'
      resourceId: 'string'
      wellKnownImageName: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    staticIpAddressCount: int
    subnetId: 'string'
  }
  osProfile: {
    logonType: 'string'
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      certificateStoreName: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
  }
  storageProfile: {
    dataDisks: [
      {
        caching: 'string'
        diskSizeGiB: int
        driveLetter: 'string'
        storageAccountType: 'string'
      }
    ]
    osDiskStorageAccountType: 'string'
  }
}

Objekty OrganizationProfile

Nastavením vlastnosti kind určete typ objektu.

Pro AzureDevOps použijte:

{
  alias: 'string'
  kind: 'AzureDevOps'
  organizations: [
    {
      alias: 'string'
      openAccess: bool
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
  permissionProfile: {
    groups: [
      'string'
    ]
    kind: 'string'
    users: [
      'string'
    ]
  }
}

Pro GitHub použijte:

{
  kind: 'GitHub'
  organizations: [
    {
      repositories: [
        'string'
      ]
      url: 'string'
    }
  ]
}

Objekty ResourcePredictionsProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Automaticky použijte:

{
  kind: 'Automatic'
  predictionPreference: 'string'
}

Pro ruční použití použijte:

{
  kind: 'Manual'
}

Hodnoty vlastností

Microsoft.DevOpsInfrastructure/pools

Name Description Value
identita Identity spravované služby přiřazené k tomuto prostředku. ManagedServiceIdentity
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
name Název prostředku string

Constraints:
Model = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (povinné)
properties Vlastnosti specifické pro prostředek pro tento prostředek. PoolProperties
obor Slouží k vytvoření prostředku v oboru, který se liší od oboru nasazení. Nastavte tuto vlastnost na symbolický název prostředku, který použijeprostředku rozšíření .
tags Štítky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách

AgentProfile

Name Description Value
kind Nastavte na "Stavový" pro typ Stavový. Nastavte na "Stateless" pro typ StatelessAgentProfile. 'Stateful'
"Bez státní příslušnosti" (povinné)
resourcePredictions Definuje vyrovnávací paměť fondu nebo samostatné agenty. any
resourcePredictionsProfile Definuje, jak se poskytuje vyrovnávací paměť fondu nebo samostatné agenty. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description Value
kind Určuje, jak má být poskytováno schéma stand-by. "Automaticky" (povinné)
predictionPreference Určuje rovnováhu mezi náklady a výkonem. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Description Value
alias Alias pro odkazování na název fondu Azure DevOps. řetězec
kind Diskriminující vlastnost pro OrganizationProfile. "AzureDevOps" (povinné)
organizations Seznam organizací Azure DevOps, ve které by fond měl být. Organizace[] (povinné)
permissionProfile Typ oprávnění, které určuje, které účty jsou správci ve fondu Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description Value
groups Seskupovat e-mailové adresy string[]
kind Určuje, kdo má oprávnění správce pro fond Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (povinné)
users E-mailové adresy uživatelů string[]

DataDisk

Name Description Value
mezipaměť Typ ukládání do mezipaměti, který se má povolit pro datové disky. Výchozí hodnota pro ukládání do mezipaměti je readwrite. Informace o možnostech ukládání do mezipaměti naleznete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB Počáteční velikost disku v gigabajtech. int
driveLetter Písmeno jednotky pro prázdný datový disk. Pokud ho nezadáte, bude to první dostupné písmeno. řetězec
storageAccountType Typ účtu úložiště, který se má použít pro datový disk. Pokud tuto hodnotu vynecháte, výchozí hodnota je standard_lrs. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Description Value
name Název skladové položky Azure počítačů ve fondu. string (povinné)

FabricProfile

Name Description Value
kind Nastavte na hodnotu Vmss pro typ VmssFabricProfile. "Vmss" (povinné)

GitHubOrganization

Name Description Value
repositories Volitelný seznam úložišť, ve kterých se má fond vytvořit. string[]
url Adresa URL organizace GitHubu, ve které se má fond vytvořit. string (povinné)

GitHubOrganizationProfile

Name Description Value
kind Diskriminující vlastnost pro OrganizationProfile. GitHub (povinné)
organizations Seznam organizací a úložišť GitHubu, ve které by měl být fond. GitHubOrganization[] (povinné)

ManagedServiceIdentity

Name Description Value
typ Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (povinné)
userAssignedIdentities Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Určuje, jak má být poskytováno schéma stand-by. "Ručně" (vyžadováno)

NetworkProfile

Name Description Value
staticIpAddressCount Počet statických veřejných IP adres pro odchozí připojení přiřazená k fondu. int
subnetId ID podsítě, do které se mají umístit všechny počítače vytvořené ve fondu. řetězec

Organization

Name Description Value
alias Alias pro odkazování na název fondu Azure DevOps. řetězec
openAccess Určuje, jestli má mít fond otevřený přístup ke všem projektům v této organizaci. bool
parallelism Kolik počítačů lze v této organizaci vytvořit maximálně z maximálního počtu instancí fondu. int
projects Volitelný seznam projektů, ve kterých má být fond vytvořen. string[]
url Adresa URL organizace Azure DevOps, ve které se má fond vytvořit. string (povinné)

OrganizationProfile

Name Description Value
kind Nastavte na "AzureDevOps" pro typ AzureDevOpsOrganizationProfile. Nastavte GitHub pro typ GitHubOrganizationProfile. 'AzureDevOps'
GitHub (povinné)

OsProfile

Name Description Value
logonType Určuje způsob spuštění služby. Ve výchozím nastavení se tato možnost nastaví na Službu. 'Interactive'
'Service'
secretsManagementSettings Nastavení správy tajných kódů počítačů ve fondu. SecretsManagementSettings

PoolImage

Name Description Value
aliases Seznam aliasů odkazovaných na obrázek podle string[]
ukládat do vyrovnávací paměti Procento vyrovnávací paměti, která se má přidělit tomuto obrázku. řetězec
ephemeralType Dočasný typ obrázku. 'Automatic'
'CacheDisk'
'ResourceDisk'
resourceId ID prostředku image. řetězec
wellKnownImageName Obrázek, který se má použít z dobře známé sady imagí zpřístupněných zákazníkům. řetězec

PoolProperties

Name Description Value
agentProfile Definuje způsob zpracování počítače po spuštění úlohy. AgentProfile (povinné)
devCenterProjectResourceId ID zdroje projektu DevCenter, do které fond patří. string (povinné)
fabricProfile Definuje typ prostředků infrastruktury, na které bude agent běžet. FabricProfile (povinné)
maximumConcurrency Definuje, kolik prostředků lze v daném okamžiku vytvořit. int

Constraints:
Minimální hodnota = 1
Maximální hodnota = 1 0000 (povinné)
organizationProfile Definuje organizaci, ve které se bude fond používat. OrganizationProfile (povinné)
provisioningState Stav aktuální operace. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'
konfigurace runtimeConfiguration Konfigurace fondu za běhu. Konfigurace modulu runtime

ResourcePredictionsProfile

Name Description Value
kind Nastavte na "Automaticky" pro typ AutomaticResourcePredictionsProfile. Nastavte na "Ručně" pro typ ManualResourcePredictionsProfile. 'Automatic'
"Ručně" (vyžadováno)

Konfigurace modulu runtime

Name Description Value
pracovní složka Cílová pracovní složka agenta úloh v počítači. řetězec

SecretsManagementSettings

Name Description Value
certificateStoreLocation Kde na počítači ukládat certifikáty. řetězec
certificateStoreName Název úložiště certifikátů, které se mají použít na počítači, se v současné době podporuje My a Root. 'My'
'Root'
keyExportable Definuje, jestli má být klíč certifikátů exportovatelný. bool (povinné)
observedCertificates Seznam certifikátů, které se mají nainstalovat na všechny počítače ve fondu. string[] (povinné)

Stateful

Name Description Value
gracePeriodTimeSpan Jak dlouho by se měl počítač uchovávat po spuštění úlohy, když neexistují žádní agenti. Maximum je jeden týden. řetězec
kind Diskriminující vlastnost agentaProfile. "Stavový" (povinné)
maxAgentLifetime Jak dlouho by měly být stavové počítače udržovány. Maximum je jeden týden. řetězec

StatelessAgentProfile

Name Description Value
kind Diskriminující vlastnost agentaProfile. "Bez státní příslušnosti" (povinné)

StorageProfile

Name Description Value
dataDisks Seznam prázdných datových disků, které se mají připojit. DataDisk[]
osDiskStorageAccountType Název skladové položky Azure počítačů ve fondu. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images Image virtuálníchpočítačůch PoolImage[] (povinné)
kind Diskriminující vlastnost pro FabricProfile. "Vmss" (povinné)
networkProfile Profil sítě počítačů ve fondu. NetworkProfile
osProfile Profil operačního systému počítačů ve fondu. OsProfile
sku Skladová položka Azure počítačů ve fondu. DevOpsAzureSku (povinné)
storageProfile Profil úložiště počítačů ve fondu. StorageProfile

Příklady použití

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Module Description
Fond infrastruktury DevOps Modul prostředků AVM pro fond infrastruktury DevOps

Definice prostředku šablony ARM

Typ prostředku fondů je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevOpsInfrastructure/pools, přidejte do šablony následující JSON.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2025-09-20",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "resourcePredictionsProfile": {
        "kind": "string"
        // For remaining properties, see ResourcePredictionsProfile objects
      },
      "kind": "string"
      // For remaining properties, see AgentProfile objects
    },
    "devCenterProjectResourceId": "string",
    "fabricProfile": {
      "kind": "string"
      // For remaining properties, see FabricProfile objects
    },
    "maximumConcurrency": "int",
    "organizationProfile": {
      "kind": "string"
      // For remaining properties, see OrganizationProfile objects
    },
    "provisioningState": "string",
    "runtimeConfiguration": {
      "workFolder": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objekty AgentProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Stateful použijte:

{
  "gracePeriodTimeSpan": "string",
  "kind": "Stateful",
  "maxAgentLifetime": "string"
}

V případě bezstavové metody použijte:

{
  "kind": "Stateless"
}

Objekty FabricProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Vmss použijte:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "ephemeralType": "string",
      "resourceId": "string",
      "wellKnownImageName": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "staticIpAddressCount": "int",
    "subnetId": "string"
  },
  "osProfile": {
    "logonType": "string",
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "certificateStoreName": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string"
  },
  "storageProfile": {
    "dataDisks": [
      {
        "caching": "string",
        "diskSizeGiB": "int",
        "driveLetter": "string",
        "storageAccountType": "string"
      }
    ],
    "osDiskStorageAccountType": "string"
  }
}

Objekty OrganizationProfile

Nastavením vlastnosti kind určete typ objektu.

Pro AzureDevOps použijte:

{
  "alias": "string",
  "kind": "AzureDevOps",
  "organizations": [
    {
      "alias": "string",
      "openAccess": "bool",
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ],
  "permissionProfile": {
    "groups": [ "string" ],
    "kind": "string",
    "users": [ "string" ]
  }
}

Pro GitHub použijte:

{
  "kind": "GitHub",
  "organizations": [
    {
      "repositories": [ "string" ],
      "url": "string"
    }
  ]
}

Objekty ResourcePredictionsProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Automaticky použijte:

{
  "kind": "Automatic",
  "predictionPreference": "string"
}

Pro ruční použití použijte:

{
  "kind": "Manual"
}

Hodnoty vlastností

Microsoft.DevOpsInfrastructure/pools

Name Description Value
apiVersion Verze rozhraní API '2025-09-20'
identita Identity spravované služby přiřazené k tomuto prostředku. ManagedServiceIdentity
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
name Název prostředku string

Constraints:
Model = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (povinné)
properties Vlastnosti specifické pro prostředek pro tento prostředek. PoolProperties
tags Štítky prostředků Slovník názvů a hodnot značek Viz Značky v šablonách
typ Typ prostředku 'Microsoft.DevOpsInfrastructure/pools'

AgentProfile

Name Description Value
kind Nastavte na "Stavový" pro typ Stavový. Nastavte na "Stateless" pro typ StatelessAgentProfile. 'Stateful'
"Bez státní příslušnosti" (povinné)
resourcePredictions Definuje vyrovnávací paměť fondu nebo samostatné agenty. any
resourcePredictionsProfile Definuje, jak se poskytuje vyrovnávací paměť fondu nebo samostatné agenty. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description Value
kind Určuje, jak má být poskytováno schéma stand-by. "Automaticky" (povinné)
predictionPreference Určuje rovnováhu mezi náklady a výkonem. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Description Value
alias Alias pro odkazování na název fondu Azure DevOps. řetězec
kind Diskriminující vlastnost pro OrganizationProfile. "AzureDevOps" (povinné)
organizations Seznam organizací Azure DevOps, ve které by fond měl být. Organizace[] (povinné)
permissionProfile Typ oprávnění, které určuje, které účty jsou správci ve fondu Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description Value
groups Seskupovat e-mailové adresy string[]
kind Určuje, kdo má oprávnění správce pro fond Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (povinné)
users E-mailové adresy uživatelů string[]

DataDisk

Name Description Value
mezipaměť Typ ukládání do mezipaměti, který se má povolit pro datové disky. Výchozí hodnota pro ukládání do mezipaměti je readwrite. Informace o možnostech ukládání do mezipaměti naleznete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB Počáteční velikost disku v gigabajtech. int
driveLetter Písmeno jednotky pro prázdný datový disk. Pokud ho nezadáte, bude to první dostupné písmeno. řetězec
storageAccountType Typ účtu úložiště, který se má použít pro datový disk. Pokud tuto hodnotu vynecháte, výchozí hodnota je standard_lrs. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Description Value
name Název skladové položky Azure počítačů ve fondu. string (povinné)

FabricProfile

Name Description Value
kind Nastavte na hodnotu Vmss pro typ VmssFabricProfile. "Vmss" (povinné)

GitHubOrganization

Name Description Value
repositories Volitelný seznam úložišť, ve kterých se má fond vytvořit. string[]
url Adresa URL organizace GitHubu, ve které se má fond vytvořit. string (povinné)

GitHubOrganizationProfile

Name Description Value
kind Diskriminující vlastnost pro OrganizationProfile. GitHub (povinné)
organizations Seznam organizací a úložišť GitHubu, ve které by měl být fond. GitHubOrganization[] (povinné)

ManagedServiceIdentity

Name Description Value
typ Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (povinné)
userAssignedIdentities Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Určuje, jak má být poskytováno schéma stand-by. "Ručně" (vyžadováno)

NetworkProfile

Name Description Value
staticIpAddressCount Počet statických veřejných IP adres pro odchozí připojení přiřazená k fondu. int
subnetId ID podsítě, do které se mají umístit všechny počítače vytvořené ve fondu. řetězec

Organization

Name Description Value
alias Alias pro odkazování na název fondu Azure DevOps. řetězec
openAccess Určuje, jestli má mít fond otevřený přístup ke všem projektům v této organizaci. bool
parallelism Kolik počítačů lze v této organizaci vytvořit maximálně z maximálního počtu instancí fondu. int
projects Volitelný seznam projektů, ve kterých má být fond vytvořen. string[]
url Adresa URL organizace Azure DevOps, ve které se má fond vytvořit. string (povinné)

OrganizationProfile

Name Description Value
kind Nastavte na "AzureDevOps" pro typ AzureDevOpsOrganizationProfile. Nastavte GitHub pro typ GitHubOrganizationProfile. 'AzureDevOps'
GitHub (povinné)

OsProfile

Name Description Value
logonType Určuje způsob spuštění služby. Ve výchozím nastavení se tato možnost nastaví na Službu. 'Interactive'
'Service'
secretsManagementSettings Nastavení správy tajných kódů počítačů ve fondu. SecretsManagementSettings

PoolImage

Name Description Value
aliases Seznam aliasů odkazovaných na obrázek podle string[]
ukládat do vyrovnávací paměti Procento vyrovnávací paměti, která se má přidělit tomuto obrázku. řetězec
ephemeralType Dočasný typ obrázku. 'Automatic'
'CacheDisk'
'ResourceDisk'
resourceId ID prostředku image. řetězec
wellKnownImageName Obrázek, který se má použít z dobře známé sady imagí zpřístupněných zákazníkům. řetězec

PoolProperties

Name Description Value
agentProfile Definuje způsob zpracování počítače po spuštění úlohy. AgentProfile (povinné)
devCenterProjectResourceId ID zdroje projektu DevCenter, do které fond patří. string (povinné)
fabricProfile Definuje typ prostředků infrastruktury, na které bude agent běžet. FabricProfile (povinné)
maximumConcurrency Definuje, kolik prostředků lze v daném okamžiku vytvořit. int

Constraints:
Minimální hodnota = 1
Maximální hodnota = 1 0000 (povinné)
organizationProfile Definuje organizaci, ve které se bude fond používat. OrganizationProfile (povinné)
provisioningState Stav aktuální operace. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'
konfigurace runtimeConfiguration Konfigurace fondu za běhu. Konfigurace modulu runtime

ResourcePredictionsProfile

Name Description Value
kind Nastavte na "Automaticky" pro typ AutomaticResourcePredictionsProfile. Nastavte na "Ručně" pro typ ManualResourcePredictionsProfile. 'Automatic'
"Ručně" (vyžadováno)

Konfigurace modulu runtime

Name Description Value
pracovní složka Cílová pracovní složka agenta úloh v počítači. řetězec

SecretsManagementSettings

Name Description Value
certificateStoreLocation Kde na počítači ukládat certifikáty. řetězec
certificateStoreName Název úložiště certifikátů, které se mají použít na počítači, se v současné době podporuje My a Root. 'My'
'Root'
keyExportable Definuje, jestli má být klíč certifikátů exportovatelný. bool (povinné)
observedCertificates Seznam certifikátů, které se mají nainstalovat na všechny počítače ve fondu. string[] (povinné)

Stateful

Name Description Value
gracePeriodTimeSpan Jak dlouho by se měl počítač uchovávat po spuštění úlohy, když neexistují žádní agenti. Maximum je jeden týden. řetězec
kind Diskriminující vlastnost agentaProfile. "Stavový" (povinné)
maxAgentLifetime Jak dlouho by měly být stavové počítače udržovány. Maximum je jeden týden. řetězec

StatelessAgentProfile

Name Description Value
kind Diskriminující vlastnost agentaProfile. "Bez státní příslušnosti" (povinné)

StorageProfile

Name Description Value
dataDisks Seznam prázdných datových disků, které se mají připojit. DataDisk[]
osDiskStorageAccountType Název skladové položky Azure počítačů ve fondu. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images Image virtuálníchpočítačůch PoolImage[] (povinné)
kind Diskriminující vlastnost pro FabricProfile. "Vmss" (povinné)
networkProfile Profil sítě počítačů ve fondu. NetworkProfile
osProfile Profil operačního systému počítačů ve fondu. OsProfile
sku Skladová položka Azure počítačů ve fondu. DevOpsAzureSku (povinné)
storageProfile Profil úložiště počítačů ve fondu. StorageProfile

Příklady použití

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku fondů je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.DevOpsInfrastructure/pools, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2025-09-20"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      agentProfile = {
        resourcePredictions = ?
        resourcePredictionsProfile = {
          kind = "string"
          // For remaining properties, see ResourcePredictionsProfile objects
        }
        kind = "string"
        // For remaining properties, see AgentProfile objects
      }
      devCenterProjectResourceId = "string"
      fabricProfile = {
        kind = "string"
        // For remaining properties, see FabricProfile objects
      }
      maximumConcurrency = int
      organizationProfile = {
        kind = "string"
        // For remaining properties, see OrganizationProfile objects
      }
      provisioningState = "string"
      runtimeConfiguration = {
        workFolder = "string"
      }
    }
  }
}

Objekty AgentProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Stateful použijte:

{
  gracePeriodTimeSpan = "string"
  kind = "Stateful"
  maxAgentLifetime = "string"
}

V případě bezstavové metody použijte:

{
  kind = "Stateless"
}

Objekty FabricProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Vmss použijte:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      ephemeralType = "string"
      resourceId = "string"
      wellKnownImageName = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    staticIpAddressCount = int
    subnetId = "string"
  }
  osProfile = {
    logonType = "string"
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      certificateStoreName = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
  }
  storageProfile = {
    dataDisks = [
      {
        caching = "string"
        diskSizeGiB = int
        driveLetter = "string"
        storageAccountType = "string"
      }
    ]
    osDiskStorageAccountType = "string"
  }
}

Objekty OrganizationProfile

Nastavením vlastnosti kind určete typ objektu.

Pro AzureDevOps použijte:

{
  alias = "string"
  kind = "AzureDevOps"
  organizations = [
    {
      alias = "string"
      openAccess = bool
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
  permissionProfile = {
    groups = [
      "string"
    ]
    kind = "string"
    users = [
      "string"
    ]
  }
}

Pro GitHub použijte:

{
  kind = "GitHub"
  organizations = [
    {
      repositories = [
        "string"
      ]
      url = "string"
    }
  ]
}

Objekty ResourcePredictionsProfile

Nastavením vlastnosti kind určete typ objektu.

Pro Automaticky použijte:

{
  kind = "Automatic"
  predictionPreference = "string"
}

Pro ruční použití použijte:

{
  kind = "Manual"
}

Hodnoty vlastností

Microsoft.DevOpsInfrastructure/pools

Name Description Value
identita Identity spravované služby přiřazené k tomuto prostředku. ManagedServiceIdentity
poloha Geografické umístění, ve kterém se nachází zdroj string (povinné)
name Název prostředku string

Constraints:
Model = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (povinné)
parent_id ID prostředku, na který se má tento prostředek rozšíření použít. string (povinné)
properties Vlastnosti specifické pro prostředek pro tento prostředek. PoolProperties
tags Štítky prostředků Slovník názvů a hodnot značek
typ Typ prostředku "Microsoft.DevOpsInfrastructure/pools@2025-09-20"

AgentProfile

Name Description Value
kind Nastavte na "Stavový" pro typ Stavový. Nastavte na "Stateless" pro typ StatelessAgentProfile. 'Stateful'
"Bez státní příslušnosti" (povinné)
resourcePredictions Definuje vyrovnávací paměť fondu nebo samostatné agenty. any
resourcePredictionsProfile Definuje, jak se poskytuje vyrovnávací paměť fondu nebo samostatné agenty. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description Value
kind Určuje, jak má být poskytováno schéma stand-by. "Automaticky" (povinné)
predictionPreference Určuje rovnováhu mezi náklady a výkonem. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Description Value
alias Alias pro odkazování na název fondu Azure DevOps. řetězec
kind Diskriminující vlastnost pro OrganizationProfile. "AzureDevOps" (povinné)
organizations Seznam organizací Azure DevOps, ve které by fond měl být. Organizace[] (povinné)
permissionProfile Typ oprávnění, které určuje, které účty jsou správci ve fondu Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description Value
groups Seskupovat e-mailové adresy string[]
kind Určuje, kdo má oprávnění správce pro fond Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (povinné)
users E-mailové adresy uživatelů string[]

DataDisk

Name Description Value
mezipaměť Typ ukládání do mezipaměti, který se má povolit pro datové disky. Výchozí hodnota pro ukládání do mezipaměti je readwrite. Informace o možnostech ukládání do mezipaměti naleznete v tématu: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB Počáteční velikost disku v gigabajtech. int
driveLetter Písmeno jednotky pro prázdný datový disk. Pokud ho nezadáte, bude to první dostupné písmeno. řetězec
storageAccountType Typ účtu úložiště, který se má použít pro datový disk. Pokud tuto hodnotu vynecháte, výchozí hodnota je standard_lrs. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Description Value
name Název skladové položky Azure počítačů ve fondu. string (povinné)

FabricProfile

Name Description Value
kind Nastavte na hodnotu Vmss pro typ VmssFabricProfile. "Vmss" (povinné)

GitHubOrganization

Name Description Value
repositories Volitelný seznam úložišť, ve kterých se má fond vytvořit. string[]
url Adresa URL organizace GitHubu, ve které se má fond vytvořit. string (povinné)

GitHubOrganizationProfile

Name Description Value
kind Diskriminující vlastnost pro OrganizationProfile. GitHub (povinné)
organizations Seznam organizací a úložišť GitHubu, ve které by měl být fond. GitHubOrganization[] (povinné)

ManagedServiceIdentity

Name Description Value
typ Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (povinné)
userAssignedIdentities Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Určuje, jak má být poskytováno schéma stand-by. "Ručně" (vyžadováno)

NetworkProfile

Name Description Value
staticIpAddressCount Počet statických veřejných IP adres pro odchozí připojení přiřazená k fondu. int
subnetId ID podsítě, do které se mají umístit všechny počítače vytvořené ve fondu. řetězec

Organization

Name Description Value
alias Alias pro odkazování na název fondu Azure DevOps. řetězec
openAccess Určuje, jestli má mít fond otevřený přístup ke všem projektům v této organizaci. bool
parallelism Kolik počítačů lze v této organizaci vytvořit maximálně z maximálního počtu instancí fondu. int
projects Volitelný seznam projektů, ve kterých má být fond vytvořen. string[]
url Adresa URL organizace Azure DevOps, ve které se má fond vytvořit. string (povinné)

OrganizationProfile

Name Description Value
kind Nastavte na "AzureDevOps" pro typ AzureDevOpsOrganizationProfile. Nastavte GitHub pro typ GitHubOrganizationProfile. 'AzureDevOps'
GitHub (povinné)

OsProfile

Name Description Value
logonType Určuje způsob spuštění služby. Ve výchozím nastavení se tato možnost nastaví na Službu. 'Interactive'
'Service'
secretsManagementSettings Nastavení správy tajných kódů počítačů ve fondu. SecretsManagementSettings

PoolImage

Name Description Value
aliases Seznam aliasů odkazovaných na obrázek podle string[]
ukládat do vyrovnávací paměti Procento vyrovnávací paměti, která se má přidělit tomuto obrázku. řetězec
ephemeralType Dočasný typ obrázku. 'Automatic'
'CacheDisk'
'ResourceDisk'
resourceId ID prostředku image. řetězec
wellKnownImageName Obrázek, který se má použít z dobře známé sady imagí zpřístupněných zákazníkům. řetězec

PoolProperties

Name Description Value
agentProfile Definuje způsob zpracování počítače po spuštění úlohy. AgentProfile (povinné)
devCenterProjectResourceId ID zdroje projektu DevCenter, do které fond patří. string (povinné)
fabricProfile Definuje typ prostředků infrastruktury, na které bude agent běžet. FabricProfile (povinné)
maximumConcurrency Definuje, kolik prostředků lze v daném okamžiku vytvořit. int

Constraints:
Minimální hodnota = 1
Maximální hodnota = 1 0000 (povinné)
organizationProfile Definuje organizaci, ve které se bude fond používat. OrganizationProfile (povinné)
provisioningState Stav aktuální operace. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'
konfigurace runtimeConfiguration Konfigurace fondu za běhu. Konfigurace modulu runtime

ResourcePredictionsProfile

Name Description Value
kind Nastavte na "Automaticky" pro typ AutomaticResourcePredictionsProfile. Nastavte na "Ručně" pro typ ManualResourcePredictionsProfile. 'Automatic'
"Ručně" (vyžadováno)

Konfigurace modulu runtime

Name Description Value
pracovní složka Cílová pracovní složka agenta úloh v počítači. řetězec

SecretsManagementSettings

Name Description Value
certificateStoreLocation Kde na počítači ukládat certifikáty. řetězec
certificateStoreName Název úložiště certifikátů, které se mají použít na počítači, se v současné době podporuje My a Root. 'My'
'Root'
keyExportable Definuje, jestli má být klíč certifikátů exportovatelný. bool (povinné)
observedCertificates Seznam certifikátů, které se mají nainstalovat na všechny počítače ve fondu. string[] (povinné)

Stateful

Name Description Value
gracePeriodTimeSpan Jak dlouho by se měl počítač uchovávat po spuštění úlohy, když neexistují žádní agenti. Maximum je jeden týden. řetězec
kind Diskriminující vlastnost agentaProfile. "Stavový" (povinné)
maxAgentLifetime Jak dlouho by měly být stavové počítače udržovány. Maximum je jeden týden. řetězec

StatelessAgentProfile

Name Description Value
kind Diskriminující vlastnost agentaProfile. "Bez státní příslušnosti" (povinné)

StorageProfile

Name Description Value
dataDisks Seznam prázdných datových disků, které se mají připojit. DataDisk[]
osDiskStorageAccountType Název skladové položky Azure počítačů ve fondu. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images Image virtuálníchpočítačůch PoolImage[] (povinné)
kind Diskriminující vlastnost pro FabricProfile. "Vmss" (povinné)
networkProfile Profil sítě počítačů ve fondu. NetworkProfile
osProfile Profil operačního systému počítačů ve fondu. OsProfile
sku Skladová položka Azure počítačů ve fondu. DevOpsAzureSku (povinné)
storageProfile Profil úložiště počítačů ve fondu. StorageProfile

Příklady použití

Ověřené moduly Azure

K nasazení tohoto typu prostředku je možné použít následující ověřené moduly Azure.

Module Description
Fondy DevOps Modul prostředků AVM pro fondy DevOps