Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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 |