Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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 |