Microsoft. Pools de DevOpsInfrastructure 2026-06-02

Definición de recursos de Bicep

El tipo de recurso pools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Description
Pool de Infraestructura DevOps Módulo de recursos de AVM para el grupo de infraestructura de DevOps

Formato de recurso

Para crear un Microsoft. DevOpsInfrastructure/recursos de pools, añade el siguiente Bicep a tu plantilla.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2026-06-02' = {
  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'
  }
}

Objetos ResourcePredictionsProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  kind: 'Manual'
}

Objetos AgentProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para con estado , use:

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

Para sin estado , use:

{
  kind: 'Stateless'
}

Objetos OrganizationProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para AzureDevOps, use:

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

Para GitHub, usa:

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

Objetos FabricProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para Vmss, use:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      ephemeralType: 'string'
      provisioningScriptEntryPoint: 'string'
      provisioningScriptManagedIdentityClientId: 'string'
      provisioningScriptShouldRestart: bool
      provisioningScriptStorageAccountResourceId: '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: {
    linuxNvmePath: 'string'
    name: 'string'
    vmSizes: [
      {
        name: 'string'
      }
    ]
    windowsNvmeDrive: 'string'
  }
  storageProfile: {
    dataDisks: [
      {
        caching: 'string'
        diskSizeGiB: int
        driveLetter: 'string'
        storageAccountType: 'string'
      }
    ]
    osDiskStorageAccountType: 'string'
  }
}

Valores de propiedad

Microsoft.DevOpsInfrastructure/pools

Nombre Description Value
identity Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
location Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obligatorio)
properties Propiedades específicas del recurso para este recurso. PoolProperties
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

AgentProfile

Nombre Description Value
kind Establézcalo en "Stateful" para el tipo Stateful. Establézcalo en 'Stateless' para el tipo StatelessAgentProfile. 'Con estado'
'Apátrida' (obligatorio)
resourcePredictions Define los agentes de búfer de grupo o de stand-by. any
resourcePredictionsProfile Define cómo se proporcionan los agentes de búfer o de espera del grupo. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nombre Description Value
kind Determina cómo se debe proporcionar el esquema stand-by. 'Automático' (obligatorio)
predictionPreference Determina el equilibrio entre el costo y el rendimiento. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nombre Description Value
alias Un alias para hacer referencia al nombre del pool de Azure DevOps. string
description Una descripción extra para añadir al pool de Azure DevOps. string
kind Propiedad Discriminador para OrganizationProfile. 'AzureDevOps' (obligatorio)
organizations La lista de organizaciones de Azure DevOps en las que debería estar presente el pool. Organización[] (obligatorio)
permissionProfile El tipo de permiso que determina qué cuentas son administradoras en el pool de Azure DevOps. AzureDevOpsPermissionProfile
Descripción de la actualización Determina si el servicio actualiza la descripción del pool de Azure DevOps. bool

AzureDevOpsPermissionProfile

Nombre Description Value
groups Direcciones de correo electrónico de grupo string[]
kind Determina quién tiene permisos de administrador para el pool de Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obligatorio)
users Direcciones de correo electrónico de usuario string[]

DataDisk

Nombre Description Value
caching Tipo de almacenamiento en caché que se va a habilitar para los discos de datos. El valor predeterminado para el almacenamiento en caché es readwrite. Para información sobre las opciones de caché, véase: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Ninguno'
'ReadOnly'
'ReadWrite'
diskSizeGiB Tamaño inicial del disco en gigabytes. int
driveLetter Letra de unidad del disco de datos vacío. Si no se especifica, será la primera letra disponible. string
storageAccountType El tipo de cuenta de storage que se usará para el disco de datos. Si se omite, el valor predeterminado es "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nombre Description Value
linuxNvmePath El camino de montaje para el volumen striped NVMe en Linux (por ejemplo, '/mnt/azure_nvme_temp'). Por defecto se pone en '/mnt/azure_nvme_temp' cuando no está especificado. string
nombre El nombre SKU de Azure de las máquinas del pool. string (obligatorio)
vmTamaños Especifica tamaños de VM para la asignación de instancias de mezcla. VmSize[]
windowsNvmeDrive La letra de unidad para el volumen en rayas NVMe en Windows (por ejemplo, 'N'). Por defecto se pone en 'N' cuando no está especificado. string

FabricProfile

Nombre Description Value
kind Establézcalo en "Vmss" para el tipo VmssFabricProfile. 'Vmss' (obligatorio)

GitHubOrganization

Nombre Description Value
repositories Lista opcional de repositorios en los que se debe crear el grupo. string[]
url La URL de organización de GitHub en la que debe crearse el pool. string (obligatorio)

GitHubOrganizationProfile

Nombre Description Value
kind Propiedad Discriminador para OrganizationProfile. 'GitHub' (obligatorio)
organizations La lista de organizaciones/repositorios de GitHub en los que debería estar el pool. GitHubOrganization[] (obligatorio)

Identidad de Servicio Gestionado

Nombre Description Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. managedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nombre Description Value

ManualResourcePredictionsProfile

Nombre Description Value
kind Determina cómo se debe proporcionar el esquema stand-by. 'Manual' (obligatorio)

NetworkProfile

Nombre Description Value
staticIpAddressCount El número de direcciones IP públicas estáticas para las conexiones salientes asignadas al grupo. int
subnetId Identificador de subred en el que se van a colocar todas las máquinas creadas en el grupo. string

Organización

Nombre Description Value
alias Un alias para hacer referencia al nombre del pool de Azure DevOps. string
openAccess Determina si el grupo debe tener acceso abierto a todos los proyectos de esta organización. bool
parallelism Número máximo de máquinas que se pueden crear en esta organización fuera de la máxima simultaneidad del grupo. int
projects Lista opcional de proyectos en los que se debe crear el grupo. string[]
url La URL de organización de Azure DevOps en la que debe crearse el pool. string (obligatorio)

OrganizationProfile

Nombre Description Value
kind Establézcalo en "AzureDevOps" para el tipo AzureDevOpsOrganizationProfile. Configura en 'GitHub' para el tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obligatorio)

OsProfile

Nombre Description Value
logonType Determina cómo se debe ejecutar el servicio. De forma predeterminada, se establecerá en Servicio. 'Interactive'
"Servicio"
secretsManagementSettings Configuración de administración de secretos de las máquinas del grupo. SecretsManagementSettings

PoolImage

Nombre Description Value
aliases Lista de alias por los que hacer referencia a la imagen. string[]
buffer Porcentaje del búfer que se va a asignar a esta imagen. string
ephemeralType Tipo efímero de la imagen. 'Automático'
'Disco de caché'
'Disco de recursos'
provisioningScriptEntryPoint El punto de entrada del script de provisión para esta imagen. string
provisioningScriptManagedIdentityClientId El ID de cliente de identidad gestionada se utiliza para acceder al contenido de los scripts de provisión para esta imagen. string
provisioningScriptShouldRestart Determina si la máquina debe reiniciarse tras provisionar la ejecución del script para esta imagen. bool
provisioningScriptStorageAccountResourceId El ID de recurso ARM de la cuenta de almacenamiento que aloja scripts de provisión para esta imagen. string
resourceId Identificador de recurso de la imagen. string
wellKnownImageName Imagen que se va a usar desde un conjunto conocido de imágenes que están disponibles para los clientes. string

PoolProperties

Nombre Description Value
agentProfile Define cómo se controlará la máquina una vez que ejecutó un trabajo. AgentProfile (obligatorio)
devCenterProjectResourceId El ID de recurso del DevCenter Project al que pertenece el pool. string
fabricProfile Define el tipo de tejido en el que se ejecutará el agente. FabricProfile (obligatorio)
maximumConcurrency Define el número de recursos que se pueden crear en un momento dado. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 10000 (obligatorio)
organizationProfile Define la organización en la que se usará el grupo. OrganizationProfile (obligatorio)
provisioningState Estado de la operación actual. 'Aceptado'
'Canceled'
"Eliminar"
'Error'
"Aprovisionamiento"
"Correcto"
'Updating'
configuración de tiempo de ejecución La configuración en tiempo de ejecución del grupo. Configuración en tiempo de ejecución

ResourcePredictionsProfile

Nombre Description Value
kind Establézcalo en "Automático" para el tipo AutomaticResourcePredictionsProfile. Establézcalo en "Manual" para el tipo ManualResourcePredictionsProfile. 'Automático'
'Manual' (obligatorio)

Configuración en tiempo de ejecución

Nombre Description Value
workFolder La carpeta de trabajo de destino del agente de tareas en la máquina. string

SecretsManagementSettings

Nombre Description Value
certificateStoreLocation Dónde almacenar certificados en la máquina. string
certificateStoreName Nombre del almacén de certificados que se va a usar en la máquina, actualmente se admiten "My" y "Root". "Mi"
'Raíz'
keyExportable Define si la clave de los certificados debe ser exportable. bool (obligatorio)
observedCertificates Lista de certificados que se van a instalar en todas las máquinas del grupo. string[] (obligatorio)

Stateful

Nombre Description Value
gracePeriodTimeSpan Cuánto tiempo debe mantenerse la máquina después de ejecutar una carga de trabajo cuando no hay ningún agente independiente. El máximo es una semana. string
kind Propiedad Discriminador para AgentProfile. 'Stateful' (obligatorio)
maxAgentLifetime Cuánto tiempo deben mantenerse las máquinas con estado. El máximo es una semana. string

StatelessAgentProfile

Nombre Description Value
kind Propiedad Discriminador para AgentProfile. 'Apátrida' (obligatorio)

StorageProfile

Nombre Description Value
dataDisks Lista de discos de datos vacíos que se van a conectar. DataDisk[]
osDiskStorageAccountType El nombre SKU de Azure de las máquinas del pool. 'Premium'
'Estándar'
'StandardSSD'

TrackedResourceTags

Nombre Description Value

UserAssignedIdentity

Nombre Description Value

VmSize

Nombre Description Value
nombre Especifica el nombre del tamaño de máquina virtual. string

VmssFabricProfile

Nombre Description Value
images Imágenes de máquina virtual de las máquinas del grupo. PoolImage[] (obligatorio)
kind Propiedad Discriminador para FabricProfile. 'Vmss' (obligatorio)
networkProfile Perfil de red de las máquinas del grupo. NetworkProfile
osProfile Perfil del sistema operativo de las máquinas del grupo. OsProfile
sku El SKU de Azure de las máquinas del pool. DevOpsAzureSku (obligatorio)
storageProfile El perfil de storage de las máquinas en el pool. StorageProfile

Definición de recursos de plantilla de ARM

El tipo de recurso pools se puede implementar con operaciones destinadas a:

Ejemplos de uso

Formato de recurso

Para crear un Microsoft. DevOpsInfrastructure/pools resource, añade el siguiente JSON a tu plantilla.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2026-06-02",
  "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"
  }
}

Objetos ResourcePredictionsProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  "kind": "Manual"
}

Objetos AgentProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para con estado , use:

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

Para sin estado , use:

{
  "kind": "Stateless"
}

Objetos OrganizationProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para AzureDevOps, use:

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

Para GitHub, usa:

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

Objetos FabricProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para Vmss, use:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "ephemeralType": "string",
      "provisioningScriptEntryPoint": "string",
      "provisioningScriptManagedIdentityClientId": "string",
      "provisioningScriptShouldRestart": "bool",
      "provisioningScriptStorageAccountResourceId": "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": {
    "linuxNvmePath": "string",
    "name": "string",
    "vmSizes": [
      {
        "name": "string"
      }
    ],
    "windowsNvmeDrive": "string"
  },
  "storageProfile": {
    "dataDisks": [
      {
        "caching": "string",
        "diskSizeGiB": "int",
        "driveLetter": "string",
        "storageAccountType": "string"
      }
    ],
    "osDiskStorageAccountType": "string"
  }
}

Valores de propiedad

Microsoft.DevOpsInfrastructure/pools

Nombre Description Value
apiVersion La versión de api '2026-06-02'
identity Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
location Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obligatorio)
properties Propiedades específicas del recurso para este recurso. PoolProperties
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
type El tipo de recurso 'Microsoft. Infraestructura/pools de DevOps.

AgentProfile

Nombre Description Value
kind Establézcalo en "Stateful" para el tipo Stateful. Establézcalo en 'Stateless' para el tipo StatelessAgentProfile. 'Con estado'
'Apátrida' (obligatorio)
resourcePredictions Define los agentes de búfer de grupo o de stand-by. any
resourcePredictionsProfile Define cómo se proporcionan los agentes de búfer o de espera del grupo. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nombre Description Value
kind Determina cómo se debe proporcionar el esquema stand-by. 'Automático' (obligatorio)
predictionPreference Determina el equilibrio entre el costo y el rendimiento. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nombre Description Value
alias Un alias para hacer referencia al nombre del pool de Azure DevOps. string
description Una descripción extra para añadir al pool de Azure DevOps. string
kind Propiedad Discriminador para OrganizationProfile. 'AzureDevOps' (obligatorio)
organizations La lista de organizaciones de Azure DevOps en las que debería estar presente el pool. Organización[] (obligatorio)
permissionProfile El tipo de permiso que determina qué cuentas son administradoras en el pool de Azure DevOps. AzureDevOpsPermissionProfile
Descripción de la actualización Determina si el servicio actualiza la descripción del pool de Azure DevOps. bool

AzureDevOpsPermissionProfile

Nombre Description Value
groups Direcciones de correo electrónico de grupo string[]
kind Determina quién tiene permisos de administrador para el pool de Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obligatorio)
users Direcciones de correo electrónico de usuario string[]

DataDisk

Nombre Description Value
caching Tipo de almacenamiento en caché que se va a habilitar para los discos de datos. El valor predeterminado para el almacenamiento en caché es readwrite. Para información sobre las opciones de caché, véase: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Ninguno'
'ReadOnly'
'ReadWrite'
diskSizeGiB Tamaño inicial del disco en gigabytes. int
driveLetter Letra de unidad del disco de datos vacío. Si no se especifica, será la primera letra disponible. string
storageAccountType El tipo de cuenta de storage que se usará para el disco de datos. Si se omite, el valor predeterminado es "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nombre Description Value
linuxNvmePath El camino de montaje para el volumen striped NVMe en Linux (por ejemplo, '/mnt/azure_nvme_temp'). Por defecto se pone en '/mnt/azure_nvme_temp' cuando no está especificado. string
nombre El nombre SKU de Azure de las máquinas del pool. string (obligatorio)
vmTamaños Especifica tamaños de VM para la asignación de instancias de mezcla. VmSize[]
windowsNvmeDrive La letra de unidad para el volumen en rayas NVMe en Windows (por ejemplo, 'N'). Por defecto se pone en 'N' cuando no está especificado. string

FabricProfile

Nombre Description Value
kind Establézcalo en "Vmss" para el tipo VmssFabricProfile. 'Vmss' (obligatorio)

GitHubOrganization

Nombre Description Value
repositories Lista opcional de repositorios en los que se debe crear el grupo. string[]
url La URL de organización de GitHub en la que debe crearse el pool. string (obligatorio)

GitHubOrganizationProfile

Nombre Description Value
kind Propiedad Discriminador para OrganizationProfile. 'GitHub' (obligatorio)
organizations La lista de organizaciones/repositorios de GitHub en los que debería estar el pool. GitHubOrganization[] (obligatorio)

Identidad de Servicio Gestionado

Nombre Description Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. managedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nombre Description Value

ManualResourcePredictionsProfile

Nombre Description Value
kind Determina cómo se debe proporcionar el esquema stand-by. 'Manual' (obligatorio)

NetworkProfile

Nombre Description Value
staticIpAddressCount El número de direcciones IP públicas estáticas para las conexiones salientes asignadas al grupo. int
subnetId Identificador de subred en el que se van a colocar todas las máquinas creadas en el grupo. string

Organización

Nombre Description Value
alias Un alias para hacer referencia al nombre del pool de Azure DevOps. string
openAccess Determina si el grupo debe tener acceso abierto a todos los proyectos de esta organización. bool
parallelism Número máximo de máquinas que se pueden crear en esta organización fuera de la máxima simultaneidad del grupo. int
projects Lista opcional de proyectos en los que se debe crear el grupo. string[]
url La URL de organización de Azure DevOps en la que debe crearse el pool. string (obligatorio)

OrganizationProfile

Nombre Description Value
kind Establézcalo en "AzureDevOps" para el tipo AzureDevOpsOrganizationProfile. Configura en 'GitHub' para el tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obligatorio)

OsProfile

Nombre Description Value
logonType Determina cómo se debe ejecutar el servicio. De forma predeterminada, se establecerá en Servicio. 'Interactive'
"Servicio"
secretsManagementSettings Configuración de administración de secretos de las máquinas del grupo. SecretsManagementSettings

PoolImage

Nombre Description Value
aliases Lista de alias por los que hacer referencia a la imagen. string[]
buffer Porcentaje del búfer que se va a asignar a esta imagen. string
ephemeralType Tipo efímero de la imagen. 'Automático'
'Disco de caché'
'Disco de recursos'
provisioningScriptEntryPoint El punto de entrada del script de provisión para esta imagen. string
provisioningScriptManagedIdentityClientId El ID de cliente de identidad gestionada se utiliza para acceder al contenido de los scripts de provisión para esta imagen. string
provisioningScriptShouldRestart Determina si la máquina debe reiniciarse tras provisionar la ejecución del script para esta imagen. bool
provisioningScriptStorageAccountResourceId El ID de recurso ARM de la cuenta de almacenamiento que aloja scripts de provisión para esta imagen. string
resourceId Identificador de recurso de la imagen. string
wellKnownImageName Imagen que se va a usar desde un conjunto conocido de imágenes que están disponibles para los clientes. string

PoolProperties

Nombre Description Value
agentProfile Define cómo se controlará la máquina una vez que ejecutó un trabajo. AgentProfile (obligatorio)
devCenterProjectResourceId El ID de recurso del DevCenter Project al que pertenece el pool. string
fabricProfile Define el tipo de tejido en el que se ejecutará el agente. FabricProfile (obligatorio)
maximumConcurrency Define el número de recursos que se pueden crear en un momento dado. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 10000 (obligatorio)
organizationProfile Define la organización en la que se usará el grupo. OrganizationProfile (obligatorio)
provisioningState Estado de la operación actual. 'Aceptado'
'Canceled'
"Eliminar"
'Error'
"Aprovisionamiento"
"Correcto"
'Updating'
configuración de tiempo de ejecución La configuración en tiempo de ejecución del grupo. Configuración en tiempo de ejecución

ResourcePredictionsProfile

Nombre Description Value
kind Establézcalo en "Automático" para el tipo AutomaticResourcePredictionsProfile. Establézcalo en "Manual" para el tipo ManualResourcePredictionsProfile. 'Automático'
'Manual' (obligatorio)

Configuración en tiempo de ejecución

Nombre Description Value
workFolder La carpeta de trabajo de destino del agente de tareas en la máquina. string

SecretsManagementSettings

Nombre Description Value
certificateStoreLocation Dónde almacenar certificados en la máquina. string
certificateStoreName Nombre del almacén de certificados que se va a usar en la máquina, actualmente se admiten "My" y "Root". "Mi"
'Raíz'
keyExportable Define si la clave de los certificados debe ser exportable. bool (obligatorio)
observedCertificates Lista de certificados que se van a instalar en todas las máquinas del grupo. string[] (obligatorio)

Stateful

Nombre Description Value
gracePeriodTimeSpan Cuánto tiempo debe mantenerse la máquina después de ejecutar una carga de trabajo cuando no hay ningún agente independiente. El máximo es una semana. string
kind Propiedad Discriminador para AgentProfile. 'Stateful' (obligatorio)
maxAgentLifetime Cuánto tiempo deben mantenerse las máquinas con estado. El máximo es una semana. string

StatelessAgentProfile

Nombre Description Value
kind Propiedad Discriminador para AgentProfile. 'Apátrida' (obligatorio)

StorageProfile

Nombre Description Value
dataDisks Lista de discos de datos vacíos que se van a conectar. DataDisk[]
osDiskStorageAccountType El nombre SKU de Azure de las máquinas del pool. 'Premium'
'Estándar'
'StandardSSD'

TrackedResourceTags

Nombre Description Value

UserAssignedIdentity

Nombre Description Value

VmSize

Nombre Description Value
nombre Especifica el nombre del tamaño de máquina virtual. string

VmssFabricProfile

Nombre Description Value
images Imágenes de máquina virtual de las máquinas del grupo. PoolImage[] (obligatorio)
kind Propiedad Discriminador para FabricProfile. 'Vmss' (obligatorio)
networkProfile Perfil de red de las máquinas del grupo. NetworkProfile
osProfile Perfil del sistema operativo de las máquinas del grupo. OsProfile
sku El SKU de Azure de las máquinas del pool. DevOpsAzureSku (obligatorio)
storageProfile El perfil de storage de las máquinas en el pool. StorageProfile

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso pools se puede implementar con operaciones destinadas a:

  • Grupos de recursos Para una lista de propiedades modificadas en cada versión de la API, consulte registro de cambios.

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Description
Ops Módulo de recursos de AVM para grupos de DevOps

Formato de recurso

Para crear un Microsoft. DevOpsInfrastructure/pools resource, añade el siguiente Terraform a tu plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2026-06-02"
  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"
      }
    }
  }
}

Objetos ResourcePredictionsProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  kind = "Manual"
}

Objetos AgentProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para con estado , use:

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

Para sin estado , use:

{
  kind = "Stateless"
}

Objetos OrganizationProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para AzureDevOps, use:

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

Para GitHub, usa:

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

Objetos FabricProfile

Establezca la propiedad kind para especificar el tipo de objeto.

Para Vmss, use:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      ephemeralType = "string"
      provisioningScriptEntryPoint = "string"
      provisioningScriptManagedIdentityClientId = "string"
      provisioningScriptShouldRestart = bool
      provisioningScriptStorageAccountResourceId = "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 = {
    linuxNvmePath = "string"
    name = "string"
    vmSizes = [
      {
        name = "string"
      }
    ]
    windowsNvmeDrive = "string"
  }
  storageProfile = {
    dataDisks = [
      {
        caching = "string"
        diskSizeGiB = int
        driveLetter = "string"
        storageAccountType = "string"
      }
    ]
    osDiskStorageAccountType = "string"
  }
}

Valores de propiedad

Microsoft.DevOpsInfrastructure/pools

Nombre Description Value
identity Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
location Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obligatorio)
properties Propiedades específicas del recurso para este recurso. PoolProperties
tags Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
type El tipo de recurso "Microsoft. DevOpsInfrastructure/pools@2026-06-02"

AgentProfile

Nombre Description Value
kind Establézcalo en "Stateful" para el tipo Stateful. Establézcalo en 'Stateless' para el tipo StatelessAgentProfile. 'Con estado'
'Apátrida' (obligatorio)
resourcePredictions Define los agentes de búfer de grupo o de stand-by. any
resourcePredictionsProfile Define cómo se proporcionan los agentes de búfer o de espera del grupo. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nombre Description Value
kind Determina cómo se debe proporcionar el esquema stand-by. 'Automático' (obligatorio)
predictionPreference Determina el equilibrio entre el costo y el rendimiento. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nombre Description Value
alias Un alias para hacer referencia al nombre del pool de Azure DevOps. string
description Una descripción extra para añadir al pool de Azure DevOps. string
kind Propiedad Discriminador para OrganizationProfile. 'AzureDevOps' (obligatorio)
organizations La lista de organizaciones de Azure DevOps en las que debería estar presente el pool. Organización[] (obligatorio)
permissionProfile El tipo de permiso que determina qué cuentas son administradoras en el pool de Azure DevOps. AzureDevOpsPermissionProfile
Descripción de la actualización Determina si el servicio actualiza la descripción del pool de Azure DevOps. bool

AzureDevOpsPermissionProfile

Nombre Description Value
groups Direcciones de correo electrónico de grupo string[]
kind Determina quién tiene permisos de administrador para el pool de Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obligatorio)
users Direcciones de correo electrónico de usuario string[]

DataDisk

Nombre Description Value
caching Tipo de almacenamiento en caché que se va a habilitar para los discos de datos. El valor predeterminado para el almacenamiento en caché es readwrite. Para información sobre las opciones de caché, véase: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Ninguno'
'ReadOnly'
'ReadWrite'
diskSizeGiB Tamaño inicial del disco en gigabytes. int
driveLetter Letra de unidad del disco de datos vacío. Si no se especifica, será la primera letra disponible. string
storageAccountType El tipo de cuenta de storage que se usará para el disco de datos. Si se omite, el valor predeterminado es "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nombre Description Value
linuxNvmePath El camino de montaje para el volumen striped NVMe en Linux (por ejemplo, '/mnt/azure_nvme_temp'). Por defecto se pone en '/mnt/azure_nvme_temp' cuando no está especificado. string
nombre El nombre SKU de Azure de las máquinas del pool. string (obligatorio)
vmTamaños Especifica tamaños de VM para la asignación de instancias de mezcla. VmSize[]
windowsNvmeDrive La letra de unidad para el volumen en rayas NVMe en Windows (por ejemplo, 'N'). Por defecto se pone en 'N' cuando no está especificado. string

FabricProfile

Nombre Description Value
kind Establézcalo en "Vmss" para el tipo VmssFabricProfile. 'Vmss' (obligatorio)

GitHubOrganization

Nombre Description Value
repositories Lista opcional de repositorios en los que se debe crear el grupo. string[]
url La URL de organización de GitHub en la que debe crearse el pool. string (obligatorio)

GitHubOrganizationProfile

Nombre Description Value
kind Propiedad Discriminador para OrganizationProfile. 'GitHub' (obligatorio)
organizations La lista de organizaciones/repositorios de GitHub en los que debería estar el pool. GitHubOrganization[] (obligatorio)

Identidad de Servicio Gestionado

Nombre Description Value
type Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. managedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nombre Description Value

ManualResourcePredictionsProfile

Nombre Description Value
kind Determina cómo se debe proporcionar el esquema stand-by. 'Manual' (obligatorio)

NetworkProfile

Nombre Description Value
staticIpAddressCount El número de direcciones IP públicas estáticas para las conexiones salientes asignadas al grupo. int
subnetId Identificador de subred en el que se van a colocar todas las máquinas creadas en el grupo. string

Organización

Nombre Description Value
alias Un alias para hacer referencia al nombre del pool de Azure DevOps. string
openAccess Determina si el grupo debe tener acceso abierto a todos los proyectos de esta organización. bool
parallelism Número máximo de máquinas que se pueden crear en esta organización fuera de la máxima simultaneidad del grupo. int
projects Lista opcional de proyectos en los que se debe crear el grupo. string[]
url La URL de organización de Azure DevOps en la que debe crearse el pool. string (obligatorio)

OrganizationProfile

Nombre Description Value
kind Establézcalo en "AzureDevOps" para el tipo AzureDevOpsOrganizationProfile. Configura en 'GitHub' para el tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obligatorio)

OsProfile

Nombre Description Value
logonType Determina cómo se debe ejecutar el servicio. De forma predeterminada, se establecerá en Servicio. 'Interactive'
"Servicio"
secretsManagementSettings Configuración de administración de secretos de las máquinas del grupo. SecretsManagementSettings

PoolImage

Nombre Description Value
aliases Lista de alias por los que hacer referencia a la imagen. string[]
buffer Porcentaje del búfer que se va a asignar a esta imagen. string
ephemeralType Tipo efímero de la imagen. 'Automático'
'Disco de caché'
'Disco de recursos'
provisioningScriptEntryPoint El punto de entrada del script de provisión para esta imagen. string
provisioningScriptManagedIdentityClientId El ID de cliente de identidad gestionada se utiliza para acceder al contenido de los scripts de provisión para esta imagen. string
provisioningScriptShouldRestart Determina si la máquina debe reiniciarse tras provisionar la ejecución del script para esta imagen. bool
provisioningScriptStorageAccountResourceId El ID de recurso ARM de la cuenta de almacenamiento que aloja scripts de provisión para esta imagen. string
resourceId Identificador de recurso de la imagen. string
wellKnownImageName Imagen que se va a usar desde un conjunto conocido de imágenes que están disponibles para los clientes. string

PoolProperties

Nombre Description Value
agentProfile Define cómo se controlará la máquina una vez que ejecutó un trabajo. AgentProfile (obligatorio)
devCenterProjectResourceId El ID de recurso del DevCenter Project al que pertenece el pool. string
fabricProfile Define el tipo de tejido en el que se ejecutará el agente. FabricProfile (obligatorio)
maximumConcurrency Define el número de recursos que se pueden crear en un momento dado. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 10000 (obligatorio)
organizationProfile Define la organización en la que se usará el grupo. OrganizationProfile (obligatorio)
provisioningState Estado de la operación actual. 'Aceptado'
'Canceled'
"Eliminar"
'Error'
"Aprovisionamiento"
"Correcto"
'Updating'
configuración de tiempo de ejecución La configuración en tiempo de ejecución del grupo. Configuración en tiempo de ejecución

ResourcePredictionsProfile

Nombre Description Value
kind Establézcalo en "Automático" para el tipo AutomaticResourcePredictionsProfile. Establézcalo en "Manual" para el tipo ManualResourcePredictionsProfile. 'Automático'
'Manual' (obligatorio)

Configuración en tiempo de ejecución

Nombre Description Value
workFolder La carpeta de trabajo de destino del agente de tareas en la máquina. string

SecretsManagementSettings

Nombre Description Value
certificateStoreLocation Dónde almacenar certificados en la máquina. string
certificateStoreName Nombre del almacén de certificados que se va a usar en la máquina, actualmente se admiten "My" y "Root". "Mi"
'Raíz'
keyExportable Define si la clave de los certificados debe ser exportable. bool (obligatorio)
observedCertificates Lista de certificados que se van a instalar en todas las máquinas del grupo. string[] (obligatorio)

Stateful

Nombre Description Value
gracePeriodTimeSpan Cuánto tiempo debe mantenerse la máquina después de ejecutar una carga de trabajo cuando no hay ningún agente independiente. El máximo es una semana. string
kind Propiedad Discriminador para AgentProfile. 'Stateful' (obligatorio)
maxAgentLifetime Cuánto tiempo deben mantenerse las máquinas con estado. El máximo es una semana. string

StatelessAgentProfile

Nombre Description Value
kind Propiedad Discriminador para AgentProfile. 'Apátrida' (obligatorio)

StorageProfile

Nombre Description Value
dataDisks Lista de discos de datos vacíos que se van a conectar. DataDisk[]
osDiskStorageAccountType El nombre SKU de Azure de las máquinas del pool. 'Premium'
'Estándar'
'StandardSSD'

TrackedResourceTags

Nombre Description Value

UserAssignedIdentity

Nombre Description Value

VmSize

Nombre Description Value
nombre Especifica el nombre del tamaño de máquina virtual. string

VmssFabricProfile

Nombre Description Value
images Imágenes de máquina virtual de las máquinas del grupo. PoolImage[] (obligatorio)
kind Propiedad Discriminador para FabricProfile. 'Vmss' (obligatorio)
networkProfile Perfil de red de las máquinas del grupo. NetworkProfile
osProfile Perfil del sistema operativo de las máquinas del grupo. OsProfile
sku El SKU de Azure de las máquinas del pool. DevOpsAzureSku (obligatorio)
storageProfile El perfil de storage de las máquinas en el pool. StorageProfile
  • Last updated on