Microsoft. Pools DevOpsInfrastructure 2026-06-02

Definição de recursos do bíceps

O tipo de recurso de pools pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
Pool de Infraestrutura DevOps Módulo de recursos AVM para pool de infraestrutura de DevOps

Formato do recurso

Para criar uma Microsoft. DevOpsInfrastructure/recursos de pools, adicione o seguinte Bicep ao seu modelo.

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

Defina a propriedade kind para especificar o tipo de objeto.

Para Automático, utilize:

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

Para o Manual, use:

{
  kind: 'Manual'
}

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para Apátrida, use:

{
  kind: 'Stateless'
}

Objetos OrganizationProfile

Defina a propriedade kind para especificar o 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 do GitHub, use:

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

Objetos FabricProfile

Defina a propriedade kind para especificar o 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 propriedade

Microsoft.DevOpsInfrastructure/pools

Name Descrição Value
identidade As identidades de serviço gerenciado atribuídas a este recurso. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
Nome O nome do recurso string

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obrigatório)
Propriedades As propriedades específicas do recurso para este recurso. PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

AgentProfile

Name Descrição Value
kind Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Apátrida'
«Apátrida» (obrigatório)
resourcePredictions Define agentes de buffer/stand-by de pool. qualquer
resourcePredictionsProfile Define como os agentes de buffer/stand-by do pool são fornecidos. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Descrição Value
kind Determina como o esquema de stand-by deve ser fornecido. 'Automático' (obrigatório)
predictionPreference Determina o equilíbrio entre custo e desempenho. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Descrição Value
alias Um alias para referenciar o nome do pool Azure DevOps. cadeia (de caracteres)
description Uma descrição extra para adicionar ao pool Azure DevOps. cadeia (de caracteres)
kind Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizations A lista de organizações Azure DevOps onde o pool deve estar presente. Organização[] (obrigatório)
permissionProfile O tipo de permissão que determina quais as contas que são administradoras no pool DevOps do Azure. AzureDevOpsPermissionProfile
Descrição da atualização Determina se o serviço atualiza a descrição do pool Azure DevOps. bool

AzureDevOpsPermissionProfile

Name Descrição Value
groups Endereços de e-mail do grupo string[]
kind Determina quem tem permissões de administrador para o pool de DevOps do Azure. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obrigatório)
users Endereços de e-mail do usuário string[]

DataDisk

Name Descrição Value
colocação em cache O tipo de cache a ser habilitado para os discos de dados. O valor padrão para cache é readwrite. Para informações sobre as opções de cache, veja: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB O tamanho inicial do disco em gigabytes. int
driveLetter A letra da unidade para o disco de dados vazio. Se não for especificado, será a primeira carta disponível. cadeia (de caracteres)
storageAccountType O tipo de conta de storage a ser usado para o disco de dados. Se omitido, o padrão é "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Descrição Value
linuxNvmePath O caminho de montagem para o volume riscado NVMe no Linux (por exemplo, '/mnt/azure_nvme_temp'). Por defeito é '/mnt/azure_nvme_temp' quando não especificado. cadeia (de caracteres)
Nome O nome Azure SKU das máquinas no pool. string (obrigatório)
vmTamanhos Especifica tamanhos de VM para a alocação de instance-mix. VmSize[]
windowsNvmeDrive A letra da unidade para o volume riscado NVMe no Windows (por exemplo, 'N'). Por defeito é 'N' quando não especificado. cadeia (de caracteres)

FabricProfile

Name Descrição Value
kind Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

GitHubOrganization

Name Descrição Value
repositories Lista opcional de repositórios nos quais o pool deve ser criado. string[]
url A URL de organização do GitHub onde o pool deve ser criado. string (obrigatório)

GitHubOrganizationProfile

Name Descrição Value
kind Propriedade Discriminator para OrganizationProfile. 'GitHub' (obrigatório)
organizations A lista de organizações/repositórios do GitHub onde o pool deve estar presente. GitHubOrganization[] (obrigatório)

ManagedServiceIdentity

Name Descrição Value
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Descrição Value

ManualResourcePredictionsProfile

Name Descrição Value
kind Determina como o esquema de stand-by deve ser fornecido. 'Manual' (obrigatório)

NetworkProfile

Name Descrição Value
staticIpAddressCount O número de endereços IP públicos estáticos para conexões de saída atribuídas ao pool. int
subnetId O id da sub-rede no qual colocar todas as máquinas criadas no pool. cadeia (de caracteres)

Organização

Name Descrição Value
alias Um alias para referenciar o nome do pool Azure DevOps. cadeia (de caracteres)
openAccess Determina se o pool deve ter acesso aberto a todos os projetos nesta organização. bool
parallelism Quantas máquinas podem ser criadas no máximo nesta organização fora da simultaneidade máxima do pool. int
projects Lista opcional de projetos nos quais o pool deve ser criado. string[]
url O URL da organização Azure DevOps onde o pool deve ser criado. string (obrigatório)

OrganizationProfile

Name Descrição Value
kind Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. Definir para 'GitHub' para o tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obrigatório)

OsProfile

Name Descrição Value
logonType Determina como o serviço deve ser executado. Por padrão, isso será definido como Serviço. 'Interactive'
'Serviço'
secretsManagementSettings As configurações secretas de gerenciamento das máquinas no pool. SecretsManagementSettings

PoolImage

Name Descrição Value
aliases Lista de aliases para referenciar a imagem por. string[]
colocar em memória intermédia A porcentagem do buffer a ser alocado para esta imagem. cadeia (de caracteres)
ephemeralType O tipo efêmero da imagem. 'Automático'
'CacheDisk'
'ResourceDisk'
provisioningScriptEntryPoint O ponto de entrada do script de provisão para esta imagem. cadeia (de caracteres)
provisioningScriptManagedIdentityClientId O ID de cliente de identidade gerida é usado para aceder ao conteúdo do script de provisão desta imagem. cadeia (de caracteres)
provisioningScriptShouldRestart Determina se a máquina deve ser reiniciada após provisionar a execução do script para esta imagem. bool
provisioningScriptStorageAccountResourceId O ID de recurso ARM da conta de armazenamento que hospeda scripts de provisionamento para esta imagem. cadeia (de caracteres)
resourceId O id de recurso da imagem. cadeia (de caracteres)
wellKnownImageName A imagem a utilizar a partir de um conhecido conjunto de imagens disponibilizadas aos clientes. cadeia (de caracteres)

PoolProperties

Name Descrição Value
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId O ID de recurso do DevCenter Project a que pertence o pool. cadeia (de caracteres)
fabricProfile Define o tipo de malha em que o agente será executado. FabricProfile (obrigatório)
maximumConcurrency Define quantos recursos podem ser criados a qualquer momento. int

Restrições:
Valor mínimo = 1
Valor máximo = 10000 (obrigatório)
organizationProfile Define a organização na qual o pool será usado. OrganizationProfile (obrigatório)
provisioningState O status da operação atual. 'Aceito'
'Canceled'
'Eliminação'
'Falhou'
'Provisionamento'
'Conseguiu'
'Updating'
runtimeConfiguration A configuração de tempo de execução do pool. RuntimeConfiguration

ResourcePredictionsProfile

Name Descrição Value
kind Defina como 'Automatic' para o tipo AutomaticResourcePredictionsProfile. Defina como 'Manual' para digitar ManualResourcePredictionsProfile. 'Automático'
'Manual' (obrigatório)

RuntimeConfiguration

Name Descrição Value
workFolder A pasta de trabalho de destino do agente de tarefas na máquina. cadeia (de caracteres)

SecretsManagementSettings

Name Descrição Value
certificateStoreLocation Onde armazenar certificados na máquina. cadeia (de caracteres)
certificateStoreName Nome do armazenamento de certificados a ser usado na máquina, atualmente 'Meu' e 'Raiz' são suportados. 'My'
'Root'
keyExportable Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificates A lista de certificados a serem instalados em todas as máquinas do pool. string[] (obrigatório)

Stateful

Name Descrição Value
gracePeriodTimeSpan Por quanto tempo a máquina deve ser mantida por perto depois de executar uma carga de trabalho quando não há agentes em stand-by. O máximo é de uma semana. cadeia (de caracteres)
kind Propriedade Discriminator para AgentProfile. «Com estado» (obrigatório)
maxAgentLifetime Por quanto tempo as máquinas stateful devem ser mantidas por perto. O máximo é de uma semana. cadeia (de caracteres)

StatelessAgentProfile

Name Descrição Value
kind Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

Perfil de armazenamento

Name Descrição Value
dataDisks Uma lista de discos de dados vazios para anexar. DataDisk[]
osDiskStorageAccountType O nome Azure SKU das máquinas no pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Descrição Value

UserAssignedIdentity

Name Descrição Value

VmSize

Name Descrição Value
Nome Especifica o nome do Tamanho da VM. cadeia (de caracteres)

VmssFabricProfile

Name Descrição Value
images As imagens VM das máquinas no pool. PoolImage[] (obrigatório)
kind Propriedade Discriminator para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede das máquinas no pool. NetworkProfile
osProfile O perfil do SO das máquinas no pool. OsProfile
sku O SKU Azure das máquinas do pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de storage das máquinas na piscina. StorageProfile

Definição de recurso de modelo ARM

O tipo de recurso de pools pode ser implantado com operações que visam:

Exemplos de uso

Formato do recurso

Para criar uma Microsoft. DevOpsInfrastructure/pools resource, adicione o seguinte JSON ao seu modelo.

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

Defina a propriedade kind para especificar o tipo de objeto.

Para Automático, utilize:

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

Para o Manual, use:

{
  "kind": "Manual"
}

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para Apátrida, use:

{
  "kind": "Stateless"
}

Objetos OrganizationProfile

Defina a propriedade kind para especificar o 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 do GitHub, use:

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

Objetos FabricProfile

Defina a propriedade kind para especificar o 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 propriedade

Microsoft.DevOpsInfrastructure/pools

Name Descrição Value
apiVersion A versão api '2026-06-02'
identidade As identidades de serviço gerenciado atribuídas a este recurso. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
Nome O nome do recurso string

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obrigatório)
Propriedades As propriedades específicas do recurso para este recurso. PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft. DevOpsInfrastructure/pools

AgentProfile

Name Descrição Value
kind Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Apátrida'
«Apátrida» (obrigatório)
resourcePredictions Define agentes de buffer/stand-by de pool. qualquer
resourcePredictionsProfile Define como os agentes de buffer/stand-by do pool são fornecidos. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Descrição Value
kind Determina como o esquema de stand-by deve ser fornecido. 'Automático' (obrigatório)
predictionPreference Determina o equilíbrio entre custo e desempenho. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Descrição Value
alias Um alias para referenciar o nome do pool Azure DevOps. cadeia (de caracteres)
description Uma descrição extra para adicionar ao pool Azure DevOps. cadeia (de caracteres)
kind Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizations A lista de organizações Azure DevOps onde o pool deve estar presente. Organização[] (obrigatório)
permissionProfile O tipo de permissão que determina quais as contas que são administradoras no pool DevOps do Azure. AzureDevOpsPermissionProfile
Descrição da atualização Determina se o serviço atualiza a descrição do pool Azure DevOps. bool

AzureDevOpsPermissionProfile

Name Descrição Value
groups Endereços de e-mail do grupo string[]
kind Determina quem tem permissões de administrador para o pool de DevOps do Azure. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obrigatório)
users Endereços de e-mail do usuário string[]

DataDisk

Name Descrição Value
colocação em cache O tipo de cache a ser habilitado para os discos de dados. O valor padrão para cache é readwrite. Para informações sobre as opções de cache, veja: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB O tamanho inicial do disco em gigabytes. int
driveLetter A letra da unidade para o disco de dados vazio. Se não for especificado, será a primeira carta disponível. cadeia (de caracteres)
storageAccountType O tipo de conta de storage a ser usado para o disco de dados. Se omitido, o padrão é "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Descrição Value
linuxNvmePath O caminho de montagem para o volume riscado NVMe no Linux (por exemplo, '/mnt/azure_nvme_temp'). Por defeito é '/mnt/azure_nvme_temp' quando não especificado. cadeia (de caracteres)
Nome O nome Azure SKU das máquinas no pool. string (obrigatório)
vmTamanhos Especifica tamanhos de VM para a alocação de instance-mix. VmSize[]
windowsNvmeDrive A letra da unidade para o volume riscado NVMe no Windows (por exemplo, 'N'). Por defeito é 'N' quando não especificado. cadeia (de caracteres)

FabricProfile

Name Descrição Value
kind Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

GitHubOrganization

Name Descrição Value
repositories Lista opcional de repositórios nos quais o pool deve ser criado. string[]
url A URL de organização do GitHub onde o pool deve ser criado. string (obrigatório)

GitHubOrganizationProfile

Name Descrição Value
kind Propriedade Discriminator para OrganizationProfile. 'GitHub' (obrigatório)
organizations A lista de organizações/repositórios do GitHub onde o pool deve estar presente. GitHubOrganization[] (obrigatório)

ManagedServiceIdentity

Name Descrição Value
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Descrição Value

ManualResourcePredictionsProfile

Name Descrição Value
kind Determina como o esquema de stand-by deve ser fornecido. 'Manual' (obrigatório)

NetworkProfile

Name Descrição Value
staticIpAddressCount O número de endereços IP públicos estáticos para conexões de saída atribuídas ao pool. int
subnetId O id da sub-rede no qual colocar todas as máquinas criadas no pool. cadeia (de caracteres)

Organização

Name Descrição Value
alias Um alias para referenciar o nome do pool Azure DevOps. cadeia (de caracteres)
openAccess Determina se o pool deve ter acesso aberto a todos os projetos nesta organização. bool
parallelism Quantas máquinas podem ser criadas no máximo nesta organização fora da simultaneidade máxima do pool. int
projects Lista opcional de projetos nos quais o pool deve ser criado. string[]
url O URL da organização Azure DevOps onde o pool deve ser criado. string (obrigatório)

OrganizationProfile

Name Descrição Value
kind Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. Definir para 'GitHub' para o tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obrigatório)

OsProfile

Name Descrição Value
logonType Determina como o serviço deve ser executado. Por padrão, isso será definido como Serviço. 'Interactive'
'Serviço'
secretsManagementSettings As configurações secretas de gerenciamento das máquinas no pool. SecretsManagementSettings

PoolImage

Name Descrição Value
aliases Lista de aliases para referenciar a imagem por. string[]
colocar em memória intermédia A porcentagem do buffer a ser alocado para esta imagem. cadeia (de caracteres)
ephemeralType O tipo efêmero da imagem. 'Automático'
'CacheDisk'
'ResourceDisk'
provisioningScriptEntryPoint O ponto de entrada do script de provisão para esta imagem. cadeia (de caracteres)
provisioningScriptManagedIdentityClientId O ID de cliente de identidade gerida é usado para aceder ao conteúdo do script de provisão desta imagem. cadeia (de caracteres)
provisioningScriptShouldRestart Determina se a máquina deve ser reiniciada após provisionar a execução do script para esta imagem. bool
provisioningScriptStorageAccountResourceId O ID de recurso ARM da conta de armazenamento que hospeda scripts de provisionamento para esta imagem. cadeia (de caracteres)
resourceId O id de recurso da imagem. cadeia (de caracteres)
wellKnownImageName A imagem a utilizar a partir de um conhecido conjunto de imagens disponibilizadas aos clientes. cadeia (de caracteres)

PoolProperties

Name Descrição Value
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId O ID de recurso do DevCenter Project a que pertence o pool. cadeia (de caracteres)
fabricProfile Define o tipo de malha em que o agente será executado. FabricProfile (obrigatório)
maximumConcurrency Define quantos recursos podem ser criados a qualquer momento. int

Restrições:
Valor mínimo = 1
Valor máximo = 10000 (obrigatório)
organizationProfile Define a organização na qual o pool será usado. OrganizationProfile (obrigatório)
provisioningState O status da operação atual. 'Aceito'
'Canceled'
'Eliminação'
'Falhou'
'Provisionamento'
'Conseguiu'
'Updating'
runtimeConfiguration A configuração de tempo de execução do pool. RuntimeConfiguration

ResourcePredictionsProfile

Name Descrição Value
kind Defina como 'Automatic' para o tipo AutomaticResourcePredictionsProfile. Defina como 'Manual' para digitar ManualResourcePredictionsProfile. 'Automático'
'Manual' (obrigatório)

RuntimeConfiguration

Name Descrição Value
workFolder A pasta de trabalho de destino do agente de tarefas na máquina. cadeia (de caracteres)

SecretsManagementSettings

Name Descrição Value
certificateStoreLocation Onde armazenar certificados na máquina. cadeia (de caracteres)
certificateStoreName Nome do armazenamento de certificados a ser usado na máquina, atualmente 'Meu' e 'Raiz' são suportados. 'My'
'Root'
keyExportable Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificates A lista de certificados a serem instalados em todas as máquinas do pool. string[] (obrigatório)

Stateful

Name Descrição Value
gracePeriodTimeSpan Por quanto tempo a máquina deve ser mantida por perto depois de executar uma carga de trabalho quando não há agentes em stand-by. O máximo é de uma semana. cadeia (de caracteres)
kind Propriedade Discriminator para AgentProfile. «Com estado» (obrigatório)
maxAgentLifetime Por quanto tempo as máquinas stateful devem ser mantidas por perto. O máximo é de uma semana. cadeia (de caracteres)

StatelessAgentProfile

Name Descrição Value
kind Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

Perfil de armazenamento

Name Descrição Value
dataDisks Uma lista de discos de dados vazios para anexar. DataDisk[]
osDiskStorageAccountType O nome Azure SKU das máquinas no pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Descrição Value

UserAssignedIdentity

Name Descrição Value

VmSize

Name Descrição Value
Nome Especifica o nome do Tamanho da VM. cadeia (de caracteres)

VmssFabricProfile

Name Descrição Value
images As imagens VM das máquinas no pool. PoolImage[] (obrigatório)
kind Propriedade Discriminator para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede das máquinas no pool. NetworkProfile
osProfile O perfil do SO das máquinas no pool. OsProfile
sku O SKU Azure das máquinas do pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de storage das máquinas na piscina. StorageProfile

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de pools pode ser implantado com operações que visam:

  • Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja registo de alterações.

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
DevOps Pools Módulo de recursos AVM para pools de DevOps

Formato do recurso

Para criar uma Microsoft. DevOpsInfrastructure/pools resource, adicione o seguinte Terraform ao seu modelo.

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

Defina a propriedade kind para especificar o tipo de objeto.

Para Automático, utilize:

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

Para o Manual, use:

{
  kind = "Manual"
}

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para Apátrida, use:

{
  kind = "Stateless"
}

Objetos OrganizationProfile

Defina a propriedade kind para especificar o 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 do GitHub, use:

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

Objetos FabricProfile

Defina a propriedade kind para especificar o 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 propriedade

Microsoft.DevOpsInfrastructure/pools

Name Descrição Value
identidade As identidades de serviço gerenciado atribuídas a este recurso. ManagedServiceIdentity
localização A geolocalização onde o recurso vive string (obrigatório)
Nome O nome do recurso string

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obrigatório)
Propriedades As propriedades específicas do recurso para este recurso. PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft. DevOpsInfrastructure/pools@2026-06-02"

AgentProfile

Name Descrição Value
kind Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Apátrida'
«Apátrida» (obrigatório)
resourcePredictions Define agentes de buffer/stand-by de pool. qualquer
resourcePredictionsProfile Define como os agentes de buffer/stand-by do pool são fornecidos. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Descrição Value
kind Determina como o esquema de stand-by deve ser fornecido. 'Automático' (obrigatório)
predictionPreference Determina o equilíbrio entre custo e desempenho. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Name Descrição Value
alias Um alias para referenciar o nome do pool Azure DevOps. cadeia (de caracteres)
description Uma descrição extra para adicionar ao pool Azure DevOps. cadeia (de caracteres)
kind Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizations A lista de organizações Azure DevOps onde o pool deve estar presente. Organização[] (obrigatório)
permissionProfile O tipo de permissão que determina quais as contas que são administradoras no pool DevOps do Azure. AzureDevOpsPermissionProfile
Descrição da atualização Determina se o serviço atualiza a descrição do pool Azure DevOps. bool

AzureDevOpsPermissionProfile

Name Descrição Value
groups Endereços de e-mail do grupo string[]
kind Determina quem tem permissões de administrador para o pool de DevOps do Azure. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obrigatório)
users Endereços de e-mail do usuário string[]

DataDisk

Name Descrição Value
colocação em cache O tipo de cache a ser habilitado para os discos de dados. O valor padrão para cache é readwrite. Para informações sobre as opções de cache, veja: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB O tamanho inicial do disco em gigabytes. int
driveLetter A letra da unidade para o disco de dados vazio. Se não for especificado, será a primeira carta disponível. cadeia (de caracteres)
storageAccountType O tipo de conta de storage a ser usado para o disco de dados. Se omitido, o padrão é "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Name Descrição Value
linuxNvmePath O caminho de montagem para o volume riscado NVMe no Linux (por exemplo, '/mnt/azure_nvme_temp'). Por defeito é '/mnt/azure_nvme_temp' quando não especificado. cadeia (de caracteres)
Nome O nome Azure SKU das máquinas no pool. string (obrigatório)
vmTamanhos Especifica tamanhos de VM para a alocação de instance-mix. VmSize[]
windowsNvmeDrive A letra da unidade para o volume riscado NVMe no Windows (por exemplo, 'N'). Por defeito é 'N' quando não especificado. cadeia (de caracteres)

FabricProfile

Name Descrição Value
kind Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

GitHubOrganization

Name Descrição Value
repositories Lista opcional de repositórios nos quais o pool deve ser criado. string[]
url A URL de organização do GitHub onde o pool deve ser criado. string (obrigatório)

GitHubOrganizationProfile

Name Descrição Value
kind Propriedade Discriminator para OrganizationProfile. 'GitHub' (obrigatório)
organizations A lista de organizações/repositórios do GitHub onde o pool deve estar presente. GitHubOrganization[] (obrigatório)

ManagedServiceIdentity

Name Descrição Value
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Descrição Value

ManualResourcePredictionsProfile

Name Descrição Value
kind Determina como o esquema de stand-by deve ser fornecido. 'Manual' (obrigatório)

NetworkProfile

Name Descrição Value
staticIpAddressCount O número de endereços IP públicos estáticos para conexões de saída atribuídas ao pool. int
subnetId O id da sub-rede no qual colocar todas as máquinas criadas no pool. cadeia (de caracteres)

Organização

Name Descrição Value
alias Um alias para referenciar o nome do pool Azure DevOps. cadeia (de caracteres)
openAccess Determina se o pool deve ter acesso aberto a todos os projetos nesta organização. bool
parallelism Quantas máquinas podem ser criadas no máximo nesta organização fora da simultaneidade máxima do pool. int
projects Lista opcional de projetos nos quais o pool deve ser criado. string[]
url O URL da organização Azure DevOps onde o pool deve ser criado. string (obrigatório)

OrganizationProfile

Name Descrição Value
kind Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. Definir para 'GitHub' para o tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obrigatório)

OsProfile

Name Descrição Value
logonType Determina como o serviço deve ser executado. Por padrão, isso será definido como Serviço. 'Interactive'
'Serviço'
secretsManagementSettings As configurações secretas de gerenciamento das máquinas no pool. SecretsManagementSettings

PoolImage

Name Descrição Value
aliases Lista de aliases para referenciar a imagem por. string[]
colocar em memória intermédia A porcentagem do buffer a ser alocado para esta imagem. cadeia (de caracteres)
ephemeralType O tipo efêmero da imagem. 'Automático'
'CacheDisk'
'ResourceDisk'
provisioningScriptEntryPoint O ponto de entrada do script de provisão para esta imagem. cadeia (de caracteres)
provisioningScriptManagedIdentityClientId O ID de cliente de identidade gerida é usado para aceder ao conteúdo do script de provisão desta imagem. cadeia (de caracteres)
provisioningScriptShouldRestart Determina se a máquina deve ser reiniciada após provisionar a execução do script para esta imagem. bool
provisioningScriptStorageAccountResourceId O ID de recurso ARM da conta de armazenamento que hospeda scripts de provisionamento para esta imagem. cadeia (de caracteres)
resourceId O id de recurso da imagem. cadeia (de caracteres)
wellKnownImageName A imagem a utilizar a partir de um conhecido conjunto de imagens disponibilizadas aos clientes. cadeia (de caracteres)

PoolProperties

Name Descrição Value
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId O ID de recurso do DevCenter Project a que pertence o pool. cadeia (de caracteres)
fabricProfile Define o tipo de malha em que o agente será executado. FabricProfile (obrigatório)
maximumConcurrency Define quantos recursos podem ser criados a qualquer momento. int

Restrições:
Valor mínimo = 1
Valor máximo = 10000 (obrigatório)
organizationProfile Define a organização na qual o pool será usado. OrganizationProfile (obrigatório)
provisioningState O status da operação atual. 'Aceito'
'Canceled'
'Eliminação'
'Falhou'
'Provisionamento'
'Conseguiu'
'Updating'
runtimeConfiguration A configuração de tempo de execução do pool. RuntimeConfiguration

ResourcePredictionsProfile

Name Descrição Value
kind Defina como 'Automatic' para o tipo AutomaticResourcePredictionsProfile. Defina como 'Manual' para digitar ManualResourcePredictionsProfile. 'Automático'
'Manual' (obrigatório)

RuntimeConfiguration

Name Descrição Value
workFolder A pasta de trabalho de destino do agente de tarefas na máquina. cadeia (de caracteres)

SecretsManagementSettings

Name Descrição Value
certificateStoreLocation Onde armazenar certificados na máquina. cadeia (de caracteres)
certificateStoreName Nome do armazenamento de certificados a ser usado na máquina, atualmente 'Meu' e 'Raiz' são suportados. 'My'
'Root'
keyExportable Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificates A lista de certificados a serem instalados em todas as máquinas do pool. string[] (obrigatório)

Stateful

Name Descrição Value
gracePeriodTimeSpan Por quanto tempo a máquina deve ser mantida por perto depois de executar uma carga de trabalho quando não há agentes em stand-by. O máximo é de uma semana. cadeia (de caracteres)
kind Propriedade Discriminator para AgentProfile. «Com estado» (obrigatório)
maxAgentLifetime Por quanto tempo as máquinas stateful devem ser mantidas por perto. O máximo é de uma semana. cadeia (de caracteres)

StatelessAgentProfile

Name Descrição Value
kind Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

Perfil de armazenamento

Name Descrição Value
dataDisks Uma lista de discos de dados vazios para anexar. DataDisk[]
osDiskStorageAccountType O nome Azure SKU das máquinas no pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Name Descrição Value

UserAssignedIdentity

Name Descrição Value

VmSize

Name Descrição Value
Nome Especifica o nome do Tamanho da VM. cadeia (de caracteres)

VmssFabricProfile

Name Descrição Value
images As imagens VM das máquinas no pool. PoolImage[] (obrigatório)
kind Propriedade Discriminator para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede das máquinas no pool. NetworkProfile
osProfile O perfil do SO das máquinas no pool. OsProfile
sku O SKU Azure das máquinas do pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de storage das máquinas na piscina. StorageProfile
  • Last updated on