Pool Microsoft.DevOpsInfrastructure 2025-09-20

Definizione della risorsa Bicep

Il tipo di risorsa pool può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Moduli verificati di Azure

I seguenti Azure Moduli Verificati possono essere utilizzati per distribuire questo tipo di risorsa.

Modulo Description
Pool di Infrastruttura DevOps Modulo di risorse AVM per il pool di infrastruttura DevOps

Formato risorsa

Per creare una risorsa Microsoft.DevOpsInfrastructure/pools, aggiungi il seguente Bicep al tuo template.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  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'
  }
}

Oggetti AgentProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Stateful, utilizzare:

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

Per gli apolidi, utilizzare:

{
  kind: 'Stateless'
}

Oggetti ResourcePredictionsProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per l'Automatico, utilizzare:

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

Per il manuale, utilizzare:

{
  kind: 'Manual'
}

Oggetti OrganizationProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AzureDevOps, usare:

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

Per GitHub, si utilizza:

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

Oggetti FabricProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Vmss, utilizzare:

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

Valori delle proprietà

Microsoft.DevOpsInfrastructure/pools

Nome Description Value
identity Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa string

Vincoli:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obbligatorio)
proprietà Proprietà specifiche della risorsa. PoolProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

AgentProfile

Nome Description Value
tipo/gentile Impostare su "Stateful" per il tipo Stateful. Impostare su 'Stateless' per il tipo StatelessAgentProfile. 'Stateful'
"Apolide" (obbligatorio)
resourcePredictions Definisce gli agenti di buffer/stand-by del pool. any
resourcePredictionsProfile Definisce il modo in cui vengono forniti gli agenti buffer/stand-by del pool. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Description Value
tipo/gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Automatico' (obbligatorio)
predictionPreference Determina l'equilibrio tra costi e prestazioni. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Description Value
alias Un alias per fare riferimento al nome del pool Azure DevOps. corda
tipo/gentile Proprietà discriminatoria per OrganizationProfile. 'AzureDevOps' (obbligatorio)
organizations L'elenco delle organizzazioni Azure DevOps in cui il pool dovrebbe essere presente. Organizzazione[] (richiesto)
permissionProfile Il tipo di permesso che determina quali account sono amministratori nel pool Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Description Value
groups Indirizzi di posta elettronica del gruppo string[]
tipo/gentile Determina chi ha i permessi amministratori per il pool Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obbligatorio)
users Indirizzi di posta elettronica utente string[]

Disco dati

Nome Description Value
caching Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Nessuno'
'Sola lettura'
'LeggiScrivi'
diskSizeGiB Dimensioni iniziali del disco in gigabyte. int
driveLetter Lettera di unità per il disco dati vuoto. Se non specificato, sarà la prima lettera disponibile. corda
storageAccountType Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nome Description Value
nome Il nome SKU Azure delle macchine nel pool. stringa (obbligatorio)

TessutoProfilo

Nome Description Value
tipo/gentile Impostare su 'Vmss' per il tipo VmssFabricProfile. 'Vmss' (obbligatorio)

GitHubOrganization

Nome Description Value
repositories Elenco facoltativo di repository in cui creare il pool. string[]
URL L'URL dell'organizzazione di GitHub in cui il pool dovrebbe essere creato. stringa (obbligatorio)

GitHubOrganizationProfile

Nome Description Value
tipo/gentile Proprietà discriminatoria per OrganizationProfile. 'GitHub' (richiesto)
organizations L'elenco delle organizzazioni/repository GitHub in cui il pool dovrebbe essere presente. GitHubOrganization[] (obbligatorio)

ManagedServiceIdentity

Nome Description Value
type Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
identità assegnate dall'utente Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Description Value

ManualResourcePredictionsProfile

Nome Description Value
tipo/gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Manual' (obbligatorio)

Profilo di rete

Nome Description Value
staticIpAddressCount Numero di indirizzi IP pubblici statici per le connessioni in uscita assegnate al pool. int
subnetId ID subnet in cui inserire tutti i computer creati nel pool. corda

Organizzazione

Nome Description Value
alias Un alias per fare riferimento al nome del pool Azure DevOps. corda
openAccess Determina se il pool deve avere accesso aperto a tutti i progetti dell'organizzazione. bool
parallelism Numero massimo di computer che possono essere creati in questa organizzazione al di fuori della concorrenza massima del pool. int
projects Elenco facoltativo di progetti in cui creare il pool. string[]
URL L'URL dell'organizzazione Azure DevOps in cui il pool dovrebbe essere creato. stringa (obbligatorio)

OrganizationProfile

Nome Description Value
tipo/gentile Impostare su 'AzureDevOps' per il tipo AzureDevOpsOrganizationProfile. Impostato su 'GitHub' per il tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (richiesto)

OsProfile

Nome Description Value
logonType Determina la modalità di esecuzione del servizio. Per impostazione predefinita, questa opzione verrà impostata su Servizio. 'Interactive'
'Servizio'
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings

PoolImage

Nome Description Value
aliases Elenco di alias per cui fare riferimento all'immagine. string[]
buffer Percentuale del buffer da allocare a questa immagine. corda
ephemeralType Tipo temporaneo dell'immagine. 'Automatico'
'CacheDisk'
'ResourceDisk'
resourceId ID risorsa dell'immagine. corda
wellKnownImageName Immagine da usare da un set noto di immagini rese disponibili ai clienti. corda

PoolProprietà

Nome Description Value
agentProfile Definisce la modalità di gestione del computer dopo l'esecuzione di un processo. AgentProfile (obbligatorio)
devCenterProjectResourceId ID risorsa del progetto DevCenter a cui appartiene il pool. stringa (obbligatorio)
in tessutoProfilo Definisce il tipo di infrastruttura in cui verrà eseguito l'agente. FabricProfile (richiesto)
maximumConcurrency Definisce il numero di risorse che è possibile creare in qualsiasi momento. int

Vincoli:
Valore minimo = 1
Valore massimo = 10000 (obbligatorio)
organizationProfile Definisce l'organizzazione in cui verrà usato il pool. OrganizationProfile (obbligatorio)
provisioningState Stato dell'operazione corrente. 'Accettato'
'Annullato'
'Eliminazione'
'Fallito'
'Accantonamento'
'Riuscito'
'Aggiornamento'
runtimeConfiguration Configurazione di runtime del pool. Configurazione del runtime

ResourcePredictionsProfile

Nome Description Value
tipo/gentile Impostare su "Automatico" per il tipo AutomaticResourcePredictionsProfile. Impostare su 'Manual' per il tipo ManualResourcePredictionsProfile. 'Automatico'
'Manual' (obbligatorio)

Configurazione del runtime

Nome Description Value
cartella di lavoro Cartella di lavoro di destinazione dell'agente attività nel computer. corda

SecretsManagementSettings

Nome Description Value
certificateStoreLocation Dove archiviare i certificati nel computer. corda
certificateStoreName Il nome dell'archivio certificati da usare nel computer, attualmente sono supportati "My" e "Root". 'Mio'
'Radice'
keyExportable Definisce se la chiave dei certificati deve essere esportabile. bool (obbligatorio)
observedCertificates Elenco di certificati da installare in tutti i computer nel pool. string[] (obbligatorio)

Stateful

Nome Description Value
gracePeriodTimeSpan Quanto tempo deve essere mantenuto il computer dopo l'esecuzione di un carico di lavoro quando non sono presenti agenti stand-by. Il valore massimo è una settimana. corda
tipo/gentile Proprietà discriminatoria per AgentProfile. 'Stateful' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. corda

StatelessAgentProfile

Nome Description Value
tipo/gentile Proprietà discriminatoria per AgentProfile. "Apolide" (obbligatorio)

Profilo di archiviazione

Nome Description Value
Dischi dati Elenco di dischi dati vuoti da collegare. DataDisk[]
osDiskStorageAccountType Il nome SKU Azure delle macchine nel pool. 'Premium'
'Standard'
'SSD standard'

TrackedResourceTags

Nome Description Value

UserAssignedIdentity

Nome Description Value

VmssFabricProfile

Nome Description Value
images Immagini di macchine virtuali dei computer nel pool. PoolImage[] (obbligatorio)
tipo/gentile Proprietà discriminatoria per FabricProfile. 'Vmss' (obbligatorio)
Profilo di rete Profilo di rete dei computer nel pool. NetworkProfile
osProfile Profilo del sistema operativo dei computer nel pool. OsProfile
sku Lo SKU Azure delle macchine nel pool. DevOpsAzureSku (obbligatorio)
storageProfile Profilo di archiviazione dei computer nel pool. Profilo di archiviazione

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa pool può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Formato risorsa

Per creare una risorsa Microsoft.DevOpsInfrastructure/pools, aggiungere il codice JSON seguente al modello.

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

Oggetti AgentProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Stateful, utilizzare:

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

Per gli apolidi, utilizzare:

{
  "kind": "Stateless"
}

Oggetti ResourcePredictionsProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per l'Automatico, utilizzare:

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

Per il manuale, utilizzare:

{
  "kind": "Manual"
}

Oggetti OrganizationProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AzureDevOps, usare:

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

Per GitHub, si utilizza:

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

Oggetti FabricProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Vmss, utilizzare:

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

Valori delle proprietà

Microsoft.DevOpsInfrastructure/pools

Nome Description Value
versione dell'API Versione dell'API '2025-09-20'
identity Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa string

Vincoli:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obbligatorio)
proprietà Proprietà specifiche della risorsa. PoolProperties
tags Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
type Tipo di risorsa 'Microsoft.DevOpsInfrastructure/pools'

AgentProfile

Nome Description Value
tipo/gentile Impostare su "Stateful" per il tipo Stateful. Impostare su 'Stateless' per il tipo StatelessAgentProfile. 'Stateful'
"Apolide" (obbligatorio)
resourcePredictions Definisce gli agenti di buffer/stand-by del pool. any
resourcePredictionsProfile Definisce il modo in cui vengono forniti gli agenti buffer/stand-by del pool. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Description Value
tipo/gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Automatico' (obbligatorio)
predictionPreference Determina l'equilibrio tra costi e prestazioni. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Description Value
alias Un alias per fare riferimento al nome del pool Azure DevOps. corda
tipo/gentile Proprietà discriminatoria per OrganizationProfile. 'AzureDevOps' (obbligatorio)
organizations L'elenco delle organizzazioni Azure DevOps in cui il pool dovrebbe essere presente. Organizzazione[] (richiesto)
permissionProfile Il tipo di permesso che determina quali account sono amministratori nel pool Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Description Value
groups Indirizzi di posta elettronica del gruppo string[]
tipo/gentile Determina chi ha i permessi amministratori per il pool Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obbligatorio)
users Indirizzi di posta elettronica utente string[]

Disco dati

Nome Description Value
caching Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Nessuno'
'Sola lettura'
'LeggiScrivi'
diskSizeGiB Dimensioni iniziali del disco in gigabyte. int
driveLetter Lettera di unità per il disco dati vuoto. Se non specificato, sarà la prima lettera disponibile. corda
storageAccountType Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nome Description Value
nome Il nome SKU Azure delle macchine nel pool. stringa (obbligatorio)

TessutoProfilo

Nome Description Value
tipo/gentile Impostare su 'Vmss' per il tipo VmssFabricProfile. 'Vmss' (obbligatorio)

GitHubOrganization

Nome Description Value
repositories Elenco facoltativo di repository in cui creare il pool. string[]
URL L'URL dell'organizzazione di GitHub in cui il pool dovrebbe essere creato. stringa (obbligatorio)

GitHubOrganizationProfile

Nome Description Value
tipo/gentile Proprietà discriminatoria per OrganizationProfile. 'GitHub' (richiesto)
organizations L'elenco delle organizzazioni/repository GitHub in cui il pool dovrebbe essere presente. GitHubOrganization[] (obbligatorio)

ManagedServiceIdentity

Nome Description Value
type Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
identità assegnate dall'utente Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Description Value

ManualResourcePredictionsProfile

Nome Description Value
tipo/gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Manual' (obbligatorio)

Profilo di rete

Nome Description Value
staticIpAddressCount Numero di indirizzi IP pubblici statici per le connessioni in uscita assegnate al pool. int
subnetId ID subnet in cui inserire tutti i computer creati nel pool. corda

Organizzazione

Nome Description Value
alias Un alias per fare riferimento al nome del pool Azure DevOps. corda
openAccess Determina se il pool deve avere accesso aperto a tutti i progetti dell'organizzazione. bool
parallelism Numero massimo di computer che possono essere creati in questa organizzazione al di fuori della concorrenza massima del pool. int
projects Elenco facoltativo di progetti in cui creare il pool. string[]
URL L'URL dell'organizzazione Azure DevOps in cui il pool dovrebbe essere creato. stringa (obbligatorio)

OrganizationProfile

Nome Description Value
tipo/gentile Impostare su 'AzureDevOps' per il tipo AzureDevOpsOrganizationProfile. Impostato su 'GitHub' per il tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (richiesto)

OsProfile

Nome Description Value
logonType Determina la modalità di esecuzione del servizio. Per impostazione predefinita, questa opzione verrà impostata su Servizio. 'Interactive'
'Servizio'
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings

PoolImage

Nome Description Value
aliases Elenco di alias per cui fare riferimento all'immagine. string[]
buffer Percentuale del buffer da allocare a questa immagine. corda
ephemeralType Tipo temporaneo dell'immagine. 'Automatico'
'CacheDisk'
'ResourceDisk'
resourceId ID risorsa dell'immagine. corda
wellKnownImageName Immagine da usare da un set noto di immagini rese disponibili ai clienti. corda

PoolProprietà

Nome Description Value
agentProfile Definisce la modalità di gestione del computer dopo l'esecuzione di un processo. AgentProfile (obbligatorio)
devCenterProjectResourceId ID risorsa del progetto DevCenter a cui appartiene il pool. stringa (obbligatorio)
in tessutoProfilo Definisce il tipo di infrastruttura in cui verrà eseguito l'agente. FabricProfile (richiesto)
maximumConcurrency Definisce il numero di risorse che è possibile creare in qualsiasi momento. int

Vincoli:
Valore minimo = 1
Valore massimo = 10000 (obbligatorio)
organizationProfile Definisce l'organizzazione in cui verrà usato il pool. OrganizationProfile (obbligatorio)
provisioningState Stato dell'operazione corrente. 'Accettato'
'Annullato'
'Eliminazione'
'Fallito'
'Accantonamento'
'Riuscito'
'Aggiornamento'
runtimeConfiguration Configurazione di runtime del pool. Configurazione del runtime

ResourcePredictionsProfile

Nome Description Value
tipo/gentile Impostare su "Automatico" per il tipo AutomaticResourcePredictionsProfile. Impostare su 'Manual' per il tipo ManualResourcePredictionsProfile. 'Automatico'
'Manual' (obbligatorio)

Configurazione del runtime

Nome Description Value
cartella di lavoro Cartella di lavoro di destinazione dell'agente attività nel computer. corda

SecretsManagementSettings

Nome Description Value
certificateStoreLocation Dove archiviare i certificati nel computer. corda
certificateStoreName Il nome dell'archivio certificati da usare nel computer, attualmente sono supportati "My" e "Root". 'Mio'
'Radice'
keyExportable Definisce se la chiave dei certificati deve essere esportabile. bool (obbligatorio)
observedCertificates Elenco di certificati da installare in tutti i computer nel pool. string[] (obbligatorio)

Stateful

Nome Description Value
gracePeriodTimeSpan Quanto tempo deve essere mantenuto il computer dopo l'esecuzione di un carico di lavoro quando non sono presenti agenti stand-by. Il valore massimo è una settimana. corda
tipo/gentile Proprietà discriminatoria per AgentProfile. 'Stateful' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. corda

StatelessAgentProfile

Nome Description Value
tipo/gentile Proprietà discriminatoria per AgentProfile. "Apolide" (obbligatorio)

Profilo di archiviazione

Nome Description Value
Dischi dati Elenco di dischi dati vuoti da collegare. DataDisk[]
osDiskStorageAccountType Il nome SKU Azure delle macchine nel pool. 'Premium'
'Standard'
'SSD standard'

TrackedResourceTags

Nome Description Value

UserAssignedIdentity

Nome Description Value

VmssFabricProfile

Nome Description Value
images Immagini di macchine virtuali dei computer nel pool. PoolImage[] (obbligatorio)
tipo/gentile Proprietà discriminatoria per FabricProfile. 'Vmss' (obbligatorio)
Profilo di rete Profilo di rete dei computer nel pool. NetworkProfile
osProfile Profilo del sistema operativo dei computer nel pool. OsProfile
sku Lo SKU Azure delle macchine nel pool. DevOpsAzureSku (obbligatorio)
storageProfile Profilo di archiviazione dei computer nel pool. Profilo di archiviazione

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa pool può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Moduli verificati di Azure

I seguenti Azure Moduli Verificati possono essere utilizzati per distribuire questo tipo di risorsa.

Modulo Description
DevOps Pool Modulo di risorse AVM per i pool DevOps

Formato risorsa

Per creare una risorsa Microsoft.DevOpsInfrastructure/pools, aggiungere il codice Terraform seguente al modello.

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

Oggetti AgentProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Stateful, utilizzare:

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

Per gli apolidi, utilizzare:

{
  kind = "Stateless"
}

Oggetti ResourcePredictionsProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per l'Automatico, utilizzare:

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

Per il manuale, utilizzare:

{
  kind = "Manual"
}

Oggetti OrganizationProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AzureDevOps, usare:

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

Per GitHub, si utilizza:

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

Oggetti FabricProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per Vmss, utilizzare:

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

Valori delle proprietà

Microsoft.DevOpsInfrastructure/pools

Nome Description Value
identity Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa string

Vincoli:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obbligatorio)
proprietà Proprietà specifiche della risorsa. PoolProperties
tags Tag delle risorse Dizionario di nomi e valori di tag.
type Tipo di risorsa "Microsoft.DevOpsInfrastructure/pools@2025-09-20"

AgentProfile

Nome Description Value
tipo/gentile Impostare su "Stateful" per il tipo Stateful. Impostare su 'Stateless' per il tipo StatelessAgentProfile. 'Stateful'
"Apolide" (obbligatorio)
resourcePredictions Definisce gli agenti di buffer/stand-by del pool. any
resourcePredictionsProfile Definisce il modo in cui vengono forniti gli agenti buffer/stand-by del pool. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Description Value
tipo/gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Automatico' (obbligatorio)
predictionPreference Determina l'equilibrio tra costi e prestazioni. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Description Value
alias Un alias per fare riferimento al nome del pool Azure DevOps. corda
tipo/gentile Proprietà discriminatoria per OrganizationProfile. 'AzureDevOps' (obbligatorio)
organizations L'elenco delle organizzazioni Azure DevOps in cui il pool dovrebbe essere presente. Organizzazione[] (richiesto)
permissionProfile Il tipo di permesso che determina quali account sono amministratori nel pool Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Description Value
groups Indirizzi di posta elettronica del gruppo string[]
tipo/gentile Determina chi ha i permessi amministratori per il pool Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obbligatorio)
users Indirizzi di posta elettronica utente string[]

Disco dati

Nome Description Value
caching Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Nessuno'
'Sola lettura'
'LeggiScrivi'
diskSizeGiB Dimensioni iniziali del disco in gigabyte. int
driveLetter Lettera di unità per il disco dati vuoto. Se non specificato, sarà la prima lettera disponibile. corda
storageAccountType Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nome Description Value
nome Il nome SKU Azure delle macchine nel pool. stringa (obbligatorio)

TessutoProfilo

Nome Description Value
tipo/gentile Impostare su 'Vmss' per il tipo VmssFabricProfile. 'Vmss' (obbligatorio)

GitHubOrganization

Nome Description Value
repositories Elenco facoltativo di repository in cui creare il pool. string[]
URL L'URL dell'organizzazione di GitHub in cui il pool dovrebbe essere creato. stringa (obbligatorio)

GitHubOrganizationProfile

Nome Description Value
tipo/gentile Proprietà discriminatoria per OrganizationProfile. 'GitHub' (richiesto)
organizations L'elenco delle organizzazioni/repository GitHub in cui il pool dovrebbe essere presente. GitHubOrganization[] (obbligatorio)

ManagedServiceIdentity

Nome Description Value
type Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
identità assegnate dall'utente Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Description Value

ManualResourcePredictionsProfile

Nome Description Value
tipo/gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Manual' (obbligatorio)

Profilo di rete

Nome Description Value
staticIpAddressCount Numero di indirizzi IP pubblici statici per le connessioni in uscita assegnate al pool. int
subnetId ID subnet in cui inserire tutti i computer creati nel pool. corda

Organizzazione

Nome Description Value
alias Un alias per fare riferimento al nome del pool Azure DevOps. corda
openAccess Determina se il pool deve avere accesso aperto a tutti i progetti dell'organizzazione. bool
parallelism Numero massimo di computer che possono essere creati in questa organizzazione al di fuori della concorrenza massima del pool. int
projects Elenco facoltativo di progetti in cui creare il pool. string[]
URL L'URL dell'organizzazione Azure DevOps in cui il pool dovrebbe essere creato. stringa (obbligatorio)

OrganizationProfile

Nome Description Value
tipo/gentile Impostare su 'AzureDevOps' per il tipo AzureDevOpsOrganizationProfile. Impostato su 'GitHub' per il tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (richiesto)

OsProfile

Nome Description Value
logonType Determina la modalità di esecuzione del servizio. Per impostazione predefinita, questa opzione verrà impostata su Servizio. 'Interactive'
'Servizio'
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings

PoolImage

Nome Description Value
aliases Elenco di alias per cui fare riferimento all'immagine. string[]
buffer Percentuale del buffer da allocare a questa immagine. corda
ephemeralType Tipo temporaneo dell'immagine. 'Automatico'
'CacheDisk'
'ResourceDisk'
resourceId ID risorsa dell'immagine. corda
wellKnownImageName Immagine da usare da un set noto di immagini rese disponibili ai clienti. corda

PoolProprietà

Nome Description Value
agentProfile Definisce la modalità di gestione del computer dopo l'esecuzione di un processo. AgentProfile (obbligatorio)
devCenterProjectResourceId ID risorsa del progetto DevCenter a cui appartiene il pool. stringa (obbligatorio)
in tessutoProfilo Definisce il tipo di infrastruttura in cui verrà eseguito l'agente. FabricProfile (richiesto)
maximumConcurrency Definisce il numero di risorse che è possibile creare in qualsiasi momento. int

Vincoli:
Valore minimo = 1
Valore massimo = 10000 (obbligatorio)
organizationProfile Definisce l'organizzazione in cui verrà usato il pool. OrganizationProfile (obbligatorio)
provisioningState Stato dell'operazione corrente. 'Accettato'
'Annullato'
'Eliminazione'
'Fallito'
'Accantonamento'
'Riuscito'
'Aggiornamento'
runtimeConfiguration Configurazione di runtime del pool. Configurazione del runtime

ResourcePredictionsProfile

Nome Description Value
tipo/gentile Impostare su "Automatico" per il tipo AutomaticResourcePredictionsProfile. Impostare su 'Manual' per il tipo ManualResourcePredictionsProfile. 'Automatico'
'Manual' (obbligatorio)

Configurazione del runtime

Nome Description Value
cartella di lavoro Cartella di lavoro di destinazione dell'agente attività nel computer. corda

SecretsManagementSettings

Nome Description Value
certificateStoreLocation Dove archiviare i certificati nel computer. corda
certificateStoreName Il nome dell'archivio certificati da usare nel computer, attualmente sono supportati "My" e "Root". 'Mio'
'Radice'
keyExportable Definisce se la chiave dei certificati deve essere esportabile. bool (obbligatorio)
observedCertificates Elenco di certificati da installare in tutti i computer nel pool. string[] (obbligatorio)

Stateful

Nome Description Value
gracePeriodTimeSpan Quanto tempo deve essere mantenuto il computer dopo l'esecuzione di un carico di lavoro quando non sono presenti agenti stand-by. Il valore massimo è una settimana. corda
tipo/gentile Proprietà discriminatoria per AgentProfile. 'Stateful' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. corda

StatelessAgentProfile

Nome Description Value
tipo/gentile Proprietà discriminatoria per AgentProfile. "Apolide" (obbligatorio)

Profilo di archiviazione

Nome Description Value
Dischi dati Elenco di dischi dati vuoti da collegare. DataDisk[]
osDiskStorageAccountType Il nome SKU Azure delle macchine nel pool. 'Premium'
'Standard'
'SSD standard'

TrackedResourceTags

Nome Description Value

UserAssignedIdentity

Nome Description Value

VmssFabricProfile

Nome Description Value
images Immagini di macchine virtuali dei computer nel pool. PoolImage[] (obbligatorio)
tipo/gentile Proprietà discriminatoria per FabricProfile. 'Vmss' (obbligatorio)
Profilo di rete Profilo di rete dei computer nel pool. NetworkProfile
osProfile Profilo del sistema operativo dei computer nel pool. OsProfile
sku Lo SKU Azure delle macchine nel pool. DevOpsAzureSku (obbligatorio)
storageProfile Profilo di archiviazione dei computer nel pool. Profilo di archiviazione
  • Last updated on