Delen via


Microsoft.DevOpsInfrastructure-pools

Bicep-resourcedefinitie

Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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

AgentProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor Stateful:

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

Gebruik voor staatlozen:

{
  kind: 'Stateless'
}

FabricProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor VMS'en:

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

Objecten voor organisatieprofiel

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor AzureDevOps:

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

Gebruik voor GitHub:

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

ResourcePredictionsProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor Automatic:

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

Gebruik voor handmatig:

{
  kind: 'Manual'
}

Eigenschapswaarden

Microsoft.DevOpsInfrastructure/pools

Name Description Value
identity De beheerde service-identiteiten die zijn toegewezen aan deze resource. ManagedServiceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam string

Constraints:
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist)
properties De resourcespecifieke eigenschappen voor deze resource. PoolProperties
omvang Gebruik deze functie bij het maken van een resource in een bereik dat anders is dan het implementatiebereik. Stel deze eigenschap in op de symbolische naam van een resource om de extensieresource toe te passen.
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

AgentProfile

Name Description Value
kind Zet op 'Stateful' voor het type Stateful. Stel in op 'Stateless' voor het type StatelessAgentProfile. 'Stateful'
'Staatloos' (verplicht)
resourcePredictions Definieert poolbuffer/stand-by-agents. any
resourcePredictionsProfile Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description Value
kind Bepaalt hoe het standaardschema moet worden verstrekt. 'Automatisch' (verplicht)
predictionPreference Bepaalt de balans tussen kosten en prestaties. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Description Value
alias Een alias om te verwijzen naar de naam van de Azure DevOps-pool. string
kind De eigenschap Discriminator voor OrganizationProfile. 'AzureDevOps' (verplicht)
organizations De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. Organisatie[] (verplicht)
permissionProfile Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description Value
groups E-mailadressen groeperen string[]
kind Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. 'CreatorOnly'
'Inherit'
'Specifieke accounts' (verplicht)
users E-mailadressen van gebruikers string[]

DataDisk

Name Description Value
caching Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB De initiële schijfgrootte in gigabytes. int
driveLetter De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. string
storageAccountType Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Description Value
name De Azure SKU-naam van de machines in de pool. tekenreeks (vereist)

FabricProfile

Name Description Value
kind Stel in op 'Vmss' voor het type VmssFabricProfile. 'Vmss' (verplicht)

GitHubOrganization

Name Description Value
repositories Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. string[]
url De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

GitHubOrganizationProfile

Name Description Value
kind De eigenschap Discriminator voor OrganizationProfile. 'GitHub' (verplicht)
organizations De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. GitHubOrganization (verplicht)

ManagedServiceIdentity

Name Description Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De woordenlijstwaarden kunnen lege objecten ({}) zijn in aanvragen. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Bepaalt hoe het standaardschema moet worden verstrekt. 'Handmatig' (verplicht)

NetworkProfile

Name Description Value
staticIpAddressCount Het aantal statische openbare IP-adressen voor uitgaande verbindingen dat aan de groep is toegewezen. int
subnetId De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. string

Organization

Name Description Value
alias Een alias om te verwijzen naar de naam van de Azure DevOps-pool. string
openAccess Bepaalt of de pool open toegang moet hebben tot alle projecten in deze organisatie. bool
parallelism Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. int
projects Optionele lijst met projecten waarin de pool moet worden gemaakt. string[]
url De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

OrganizationProfile

Name Description Value
kind Stel in op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Stel in op 'GitHub' voor het type GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (verplicht)

OsProfile

Name Description Value
logonType Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. 'Interactive'
'Service'
secretsManagementSettings De geheime beheerinstellingen van de machines in de pool. SecretsManagementSettings

PoolImage

Name Description Value
aliases Lijst met aliassen om naar de afbeelding te verwijzen. string[]
buffer Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. string
ephemeralType Het tijdelijke type van de afbeelding. 'Automatic'
'CacheDisk'
'ResourceDisk'
resourceId De resource-id van de installatiekopieën. string
wellKnownImageName De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. string

PoolProperties

Name Description Value
agentProfile Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. AgentProfile (verplicht)
devCenterProjectResourceId De resource-id van het DevCenter-project waartoe de pool behoort. tekenreeks (vereist)
fabricProfile Definieert het type infrastructuur waarop de agent wordt uitgevoerd. FabricProfile (verplicht)
maximumConcurrency Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. int

Constraints:
Minimumwaarde = 1
Maximumwaarde = 10000 (vereist)
organizationProfile Definieert de organisatie waarin de pool wordt gebruikt. OrganisatieProfiel (verplicht)
provisioningState De status van de huidige bewerking. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'
runtimeConfiguratie De runtime-configuratie van de pool. Runtime-configuratie

ResourcePredictionsProfile

Name Description Value
kind Stel in op 'Automatisch' voor het type AutomaticResourcePredictionsProfile. Stel in op 'Handmatig' voor het type ManualResourcePredictionsProfile. 'Automatic'
'Handmatig' (verplicht)

Runtime-configuratie

Name Description Value
werkMap De doelwerkmap van de taakagent op de machine. string

SecretsManagementSettings

Name Description Value
certificateStoreLocation Waar certificaten op de computer worden opgeslagen. string
certificateStoreName De naam van het certificaatarchief dat op de computer moet worden gebruikt, worden momenteel 'Mijn' en 'Basis' ondersteund. 'My'
'Root'
keyExportable Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. bool (verplicht)
observedCertificates De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. Tekenreeks[] (verplicht)

Stateful

Name Description Value
gracePeriodTimeSpan Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. string
kind De eigenschap Discriminator voor AgentProfile. 'Stateful' (verplicht)
maxAgentLifetime Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. string

StatelessAgentProfile

Name Description Value
kind De eigenschap Discriminator voor AgentProfile. 'Staatloos' (verplicht)

StorageProfile

Name Description Value
dataDisks Een lijst met lege gegevensschijven die moeten worden gekoppeld. DataDisk[]
osDiskStorageAccountType De Azure SKU-naam van de machines in de pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images De VM-installatiekopieën van de machines in de pool. PoolImage[] (verplicht)
kind De eigenschap Discriminator voor FabricProfile. 'Vmss' (verplicht)
networkProfile Het netwerkprofiel van de machines in de groep. NetworkProfile
osProfile Het besturingssysteemprofiel van de machines in de pool. OsProfile
sku De Azure-SKU van de machines in de pool. DevOpsAzureSku (verplicht)
storageProfile Het opslagprofiel van de machines in de pool. StorageProfile

Gebruiksvoorbeelden

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module Description
DevOps-infrastructuurgroep AVM-resourcemodule voor DevOps-infrastructuurgroep

Resourcedefinitie van ARM-sjabloon

Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

AgentProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor Stateful:

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

Gebruik voor staatlozen:

{
  "kind": "Stateless"
}

FabricProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor VMS'en:

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

Objecten voor organisatieprofiel

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor AzureDevOps:

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

Gebruik voor GitHub:

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

ResourcePredictionsProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor Automatic:

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

Gebruik voor handmatig:

{
  "kind": "Manual"
}

Eigenschapswaarden

Microsoft.DevOpsInfrastructure/pools

Name Description Value
apiVersion De API-versie '2025-09-20'
identity De beheerde service-identiteiten die zijn toegewezen aan deze resource. ManagedServiceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam string

Constraints:
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist)
properties De resourcespecifieke eigenschappen voor deze resource. PoolProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het brontype 'Microsoft.DevOpsInfrastructure/pools'

AgentProfile

Name Description Value
kind Zet op 'Stateful' voor het type Stateful. Stel in op 'Stateless' voor het type StatelessAgentProfile. 'Stateful'
'Staatloos' (verplicht)
resourcePredictions Definieert poolbuffer/stand-by-agents. any
resourcePredictionsProfile Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description Value
kind Bepaalt hoe het standaardschema moet worden verstrekt. 'Automatisch' (verplicht)
predictionPreference Bepaalt de balans tussen kosten en prestaties. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Description Value
alias Een alias om te verwijzen naar de naam van de Azure DevOps-pool. string
kind De eigenschap Discriminator voor OrganizationProfile. 'AzureDevOps' (verplicht)
organizations De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. Organisatie[] (verplicht)
permissionProfile Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description Value
groups E-mailadressen groeperen string[]
kind Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. 'CreatorOnly'
'Inherit'
'Specifieke accounts' (verplicht)
users E-mailadressen van gebruikers string[]

DataDisk

Name Description Value
caching Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB De initiële schijfgrootte in gigabytes. int
driveLetter De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. string
storageAccountType Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Description Value
name De Azure SKU-naam van de machines in de pool. tekenreeks (vereist)

FabricProfile

Name Description Value
kind Stel in op 'Vmss' voor het type VmssFabricProfile. 'Vmss' (verplicht)

GitHubOrganization

Name Description Value
repositories Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. string[]
url De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

GitHubOrganizationProfile

Name Description Value
kind De eigenschap Discriminator voor OrganizationProfile. 'GitHub' (verplicht)
organizations De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. GitHubOrganization (verplicht)

ManagedServiceIdentity

Name Description Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De woordenlijstwaarden kunnen lege objecten ({}) zijn in aanvragen. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Bepaalt hoe het standaardschema moet worden verstrekt. 'Handmatig' (verplicht)

NetworkProfile

Name Description Value
staticIpAddressCount Het aantal statische openbare IP-adressen voor uitgaande verbindingen dat aan de groep is toegewezen. int
subnetId De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. string

Organization

Name Description Value
alias Een alias om te verwijzen naar de naam van de Azure DevOps-pool. string
openAccess Bepaalt of de pool open toegang moet hebben tot alle projecten in deze organisatie. bool
parallelism Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. int
projects Optionele lijst met projecten waarin de pool moet worden gemaakt. string[]
url De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

OrganizationProfile

Name Description Value
kind Stel in op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Stel in op 'GitHub' voor het type GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (verplicht)

OsProfile

Name Description Value
logonType Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. 'Interactive'
'Service'
secretsManagementSettings De geheime beheerinstellingen van de machines in de pool. SecretsManagementSettings

PoolImage

Name Description Value
aliases Lijst met aliassen om naar de afbeelding te verwijzen. string[]
buffer Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. string
ephemeralType Het tijdelijke type van de afbeelding. 'Automatic'
'CacheDisk'
'ResourceDisk'
resourceId De resource-id van de installatiekopieën. string
wellKnownImageName De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. string

PoolProperties

Name Description Value
agentProfile Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. AgentProfile (verplicht)
devCenterProjectResourceId De resource-id van het DevCenter-project waartoe de pool behoort. tekenreeks (vereist)
fabricProfile Definieert het type infrastructuur waarop de agent wordt uitgevoerd. FabricProfile (verplicht)
maximumConcurrency Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. int

Constraints:
Minimumwaarde = 1
Maximumwaarde = 10000 (vereist)
organizationProfile Definieert de organisatie waarin de pool wordt gebruikt. OrganisatieProfiel (verplicht)
provisioningState De status van de huidige bewerking. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'
runtimeConfiguratie De runtime-configuratie van de pool. Runtime-configuratie

ResourcePredictionsProfile

Name Description Value
kind Stel in op 'Automatisch' voor het type AutomaticResourcePredictionsProfile. Stel in op 'Handmatig' voor het type ManualResourcePredictionsProfile. 'Automatic'
'Handmatig' (verplicht)

Runtime-configuratie

Name Description Value
werkMap De doelwerkmap van de taakagent op de machine. string

SecretsManagementSettings

Name Description Value
certificateStoreLocation Waar certificaten op de computer worden opgeslagen. string
certificateStoreName De naam van het certificaatarchief dat op de computer moet worden gebruikt, worden momenteel 'Mijn' en 'Basis' ondersteund. 'My'
'Root'
keyExportable Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. bool (verplicht)
observedCertificates De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. Tekenreeks[] (verplicht)

Stateful

Name Description Value
gracePeriodTimeSpan Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. string
kind De eigenschap Discriminator voor AgentProfile. 'Stateful' (verplicht)
maxAgentLifetime Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. string

StatelessAgentProfile

Name Description Value
kind De eigenschap Discriminator voor AgentProfile. 'Staatloos' (verplicht)

StorageProfile

Name Description Value
dataDisks Een lijst met lege gegevensschijven die moeten worden gekoppeld. DataDisk[]
osDiskStorageAccountType De Azure SKU-naam van de machines in de pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images De VM-installatiekopieën van de machines in de pool. PoolImage[] (verplicht)
kind De eigenschap Discriminator voor FabricProfile. 'Vmss' (verplicht)
networkProfile Het netwerkprofiel van de machines in de groep. NetworkProfile
osProfile Het besturingssysteemprofiel van de machines in de pool. OsProfile
sku De Azure-SKU van de machines in de pool. DevOpsAzureSku (verplicht)
storageProfile Het opslagprofiel van de machines in de pool. StorageProfile

Gebruiksvoorbeelden

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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

AgentProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor Stateful:

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

Gebruik voor staatlozen:

{
  kind = "Stateless"
}

FabricProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor VMS'en:

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

Objecten voor organisatieprofiel

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor AzureDevOps:

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

Gebruik voor GitHub:

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

ResourcePredictionsProfile-objecten

Stel de eigenschap kind in om het type object op te geven.

Gebruik voor Automatic:

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

Gebruik voor handmatig:

{
  kind = "Manual"
}

Eigenschapswaarden

Microsoft.DevOpsInfrastructure/pools

Name Description Value
identity De beheerde service-identiteiten die zijn toegewezen aan deze resource. ManagedServiceIdentity
location De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
name De resourcenaam string

Constraints:
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist)
parent_id De id van de resource waar deze extensieresource op moet worden toegepast. tekenreeks (vereist)
properties De resourcespecifieke eigenschappen voor deze resource. PoolProperties
tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het brontype "Microsoft.DevOpsInfrastructure/pools@2025-09-20"

AgentProfile

Name Description Value
kind Zet op 'Stateful' voor het type Stateful. Stel in op 'Stateless' voor het type StatelessAgentProfile. 'Stateful'
'Staatloos' (verplicht)
resourcePredictions Definieert poolbuffer/stand-by-agents. any
resourcePredictionsProfile Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description Value
kind Bepaalt hoe het standaardschema moet worden verstrekt. 'Automatisch' (verplicht)
predictionPreference Bepaalt de balans tussen kosten en prestaties. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Description Value
alias Een alias om te verwijzen naar de naam van de Azure DevOps-pool. string
kind De eigenschap Discriminator voor OrganizationProfile. 'AzureDevOps' (verplicht)
organizations De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. Organisatie[] (verplicht)
permissionProfile Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description Value
groups E-mailadressen groeperen string[]
kind Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. 'CreatorOnly'
'Inherit'
'Specifieke accounts' (verplicht)
users E-mailadressen van gebruikers string[]

DataDisk

Name Description Value
caching Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB De initiële schijfgrootte in gigabytes. int
driveLetter De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. string
storageAccountType Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Description Value
name De Azure SKU-naam van de machines in de pool. tekenreeks (vereist)

FabricProfile

Name Description Value
kind Stel in op 'Vmss' voor het type VmssFabricProfile. 'Vmss' (verplicht)

GitHubOrganization

Name Description Value
repositories Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. string[]
url De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

GitHubOrganizationProfile

Name Description Value
kind De eigenschap Discriminator voor OrganizationProfile. 'GitHub' (verplicht)
organizations De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. GitHubOrganization (verplicht)

ManagedServiceIdentity

Name Description Value
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De woordenlijstwaarden kunnen lege objecten ({}) zijn in aanvragen. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Bepaalt hoe het standaardschema moet worden verstrekt. 'Handmatig' (verplicht)

NetworkProfile

Name Description Value
staticIpAddressCount Het aantal statische openbare IP-adressen voor uitgaande verbindingen dat aan de groep is toegewezen. int
subnetId De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. string

Organization

Name Description Value
alias Een alias om te verwijzen naar de naam van de Azure DevOps-pool. string
openAccess Bepaalt of de pool open toegang moet hebben tot alle projecten in deze organisatie. bool
parallelism Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. int
projects Optionele lijst met projecten waarin de pool moet worden gemaakt. string[]
url De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

OrganizationProfile

Name Description Value
kind Stel in op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Stel in op 'GitHub' voor het type GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (verplicht)

OsProfile

Name Description Value
logonType Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. 'Interactive'
'Service'
secretsManagementSettings De geheime beheerinstellingen van de machines in de pool. SecretsManagementSettings

PoolImage

Name Description Value
aliases Lijst met aliassen om naar de afbeelding te verwijzen. string[]
buffer Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. string
ephemeralType Het tijdelijke type van de afbeelding. 'Automatic'
'CacheDisk'
'ResourceDisk'
resourceId De resource-id van de installatiekopieën. string
wellKnownImageName De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. string

PoolProperties

Name Description Value
agentProfile Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. AgentProfile (verplicht)
devCenterProjectResourceId De resource-id van het DevCenter-project waartoe de pool behoort. tekenreeks (vereist)
fabricProfile Definieert het type infrastructuur waarop de agent wordt uitgevoerd. FabricProfile (verplicht)
maximumConcurrency Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. int

Constraints:
Minimumwaarde = 1
Maximumwaarde = 10000 (vereist)
organizationProfile Definieert de organisatie waarin de pool wordt gebruikt. OrganisatieProfiel (verplicht)
provisioningState De status van de huidige bewerking. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'
runtimeConfiguratie De runtime-configuratie van de pool. Runtime-configuratie

ResourcePredictionsProfile

Name Description Value
kind Stel in op 'Automatisch' voor het type AutomaticResourcePredictionsProfile. Stel in op 'Handmatig' voor het type ManualResourcePredictionsProfile. 'Automatic'
'Handmatig' (verplicht)

Runtime-configuratie

Name Description Value
werkMap De doelwerkmap van de taakagent op de machine. string

SecretsManagementSettings

Name Description Value
certificateStoreLocation Waar certificaten op de computer worden opgeslagen. string
certificateStoreName De naam van het certificaatarchief dat op de computer moet worden gebruikt, worden momenteel 'Mijn' en 'Basis' ondersteund. 'My'
'Root'
keyExportable Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. bool (verplicht)
observedCertificates De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. Tekenreeks[] (verplicht)

Stateful

Name Description Value
gracePeriodTimeSpan Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. string
kind De eigenschap Discriminator voor AgentProfile. 'Stateful' (verplicht)
maxAgentLifetime Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. string

StatelessAgentProfile

Name Description Value
kind De eigenschap Discriminator voor AgentProfile. 'Staatloos' (verplicht)

StorageProfile

Name Description Value
dataDisks Een lijst met lege gegevensschijven die moeten worden gekoppeld. DataDisk[]
osDiskStorageAccountType De Azure SKU-naam van de machines in de pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images De VM-installatiekopieën van de machines in de pool. PoolImage[] (verplicht)
kind De eigenschap Discriminator voor FabricProfile. 'Vmss' (verplicht)
networkProfile Het netwerkprofiel van de machines in de groep. NetworkProfile
osProfile Het besturingssysteemprofiel van de machines in de pool. OsProfile
sku De Azure-SKU van de machines in de pool. DevOpsAzureSku (verplicht)
storageProfile Het opslagprofiel van de machines in de pool. StorageProfile

Gebruiksvoorbeelden

Geverifieerde Azure-modules

De volgende azure-geverifieerde modules kunnen worden gebruikt om dit resourcetype te implementeren.

Module Description
DevOps-pools AVM-resourcemodule voor DevOps-pools