Compartilhar via

Pools Microsoft.DevOpsInfrastructure 2025-09-20

Definição de recurso do Bicep

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

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

Formato de recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(...)
      resourcePredictionsProfile: {
        kind: 'string'
        // For remaining properties, see ResourcePredictionsProfile objects
      }
      kind: 'string'
      // For remaining properties, see AgentProfile objects
    }
    devCenterProjectResourceId: 'string'
    fabricProfile: {
      kind: 'string'
      // For remaining properties, see FabricProfile objects
    }
    maximumConcurrency: int
    organizationProfile: {
      kind: 'string'
      // For remaining properties, see OrganizationProfile objects
    }
    provisioningState: 'string'
    runtimeConfiguration: {
      workFolder: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos AgentProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Stateful, use:

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

Para Stateless, use:

{
  kind: 'Stateless'
}

Objetos ResourcePredictionsProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  kind: 'Manual'
}

Objetos OrganizationProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para AzureDevOps, use:

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

Para do GitHub, use:

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

Objetos FabricProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Vmss, use:

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

Valores de propriedade

Microsoft.DevOpsInfrastructure/pools

Nome Description Value
identidade As identidades de serviço gerenciadas atribuídas a esse recurso. ManagedServiceIdentity
local A localização geográfica onde o recurso reside 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 esse recurso. PoolProperties
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Marcas em modelos

AgentProfile

Nome Description Value
variante Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Stateful'
'Apátrida' (obrigatório)
resourcePredictions Define agentes de buffer/stand-by do pool. qualquer
resourcePredictionsProfile Define como o buffer de pool/agentes autônomos é fornecido. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Description Value
variante Determina como o esquema de espera deve ser fornecido. 'Automático' (obrigatório)
predictionPreference Determina o equilíbrio entre custo e desempenho. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Description Value
alias Um alias para fazer referência ao nome do pool do Azure DevOps. cadeia
variante Propriedade discriminatória para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizações A lista de organizações do Azure DevOps em que o pool deve estar presente. Organização (obrigatório)
permissionProfile O tipo de permissão que determina quais contas são administradores no pool do Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Description Value
groups Endereços de email de grupo cadeia de caracteres[]
variante Determina quem tem permissões de administrador para o pool do Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obrigatório)
users Endereços de email do usuário cadeia de caracteres[]

Disco de dados

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

DevOpsAzureSku

Nome Description Value
nome O nome da SKU do Azure dos computadores no pool. string (obrigatório)

Perfil de Tecido

Nome Description Value
variante Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

GitHubOrganization

Nome Description Value
repositories Lista opcional de repositórios nos quais o pool deve ser criado. cadeia de caracteres[]
url A URL da organização do GitHub na qual o pool deve ser criado. string (obrigatório)

GitHubOrganizationProfile

Nome Description Value
variante Propriedade discriminatória para OrganizationProfile. 'GitHub' (obrigatório)
organizações A lista de organizações/repositórios do GitHub em que o pool deve estar presente. GitHubOrganization[] (obrigatório)

ManagedServiceIdentity

Nome Description Value
tipo Tipo de identidade de serviço gerenciado (em que 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 recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Description Value

ManualResourcePredictionsProfile

Nome Description Value
variante Determina como o esquema de espera deve ser fornecido. 'Manual' (obrigatório)

Perfil de rede

Nome Description 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 A ID da sub-rede na qual colocar todos os computadores criados no pool. cadeia

Organização

Nome Description Value
alias Um alias para fazer referência ao nome do pool do Azure DevOps. cadeia
openAccess Determina se o pool deve ter acesso aberto a todos os projetos nesta organização. bool
parallelism Quantos computadores podem ser criados no máximo nesta organização com a máximaConcurreção do pool. int
projects Lista opcional de projetos nos quais o pool deve ser criado. cadeia de caracteres[]
url A URL da organização do Azure DevOps na qual o pool deve ser criado. string (obrigatório)

OrganizationProfile

Nome Description Value
variante Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. Defina como 'GitHub' para o tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obrigatório)

OsProfile

Nome Description 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 de gerenciamento de segredo dos computadores no pool. SecretsManagementSettings

PoolImage

Nome Description Value
aliases Lista de aliases pelos quais fazer referência à imagem. cadeia de caracteres[]
armazenar em buffer O percentual do buffer a ser alocado para essa imagem. cadeia
ephemeralType O tipo efêmero da imagem. 'Automático'
'CacheDisk'
'ResourceDisk'
resourceId A ID do recurso da imagem. cadeia
wellKnownImageName A imagem a ser usada de um conjunto bem conhecido de imagens disponibilizadas aos clientes. cadeia

Propriedades do Pool

Nome Description Value
agentProfile Define como o computador será tratado depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A ID do recurso do Projeto DevCenter ao qual o pool pertence. string (obrigatório)
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'
'Cancelado'
'Excluindo'
'Falha'
'Provisionamento'
'Bem-sucedido'
'Atualizando'
runtimeConfiguração A configuração de runtime do pool. Configuração de tempo de execução

ResourcePredictionsProfile

Nome Description Value
variante Defina como 'Automático' para o tipo AutomaticResourcePredictionsProfile. Defina como 'Manual' para o tipo ManualResourcePredictionsProfile. 'Automático'
'Manual' (obrigatório)

Configuração de tempo de execução

Nome Description Value
pasta de trabalho A pasta de trabalho de destino do agente de tarefas no computador. cadeia

SecretsManagementSettings

Nome Description Value
certificateStoreLocation Onde armazenar certificados no computador. cadeia
certificateStoreName Nome do repositório de certificados a ser usado no computador, atualmente há suporte para 'My' e 'Root'. 'Meu'
'Raiz'
keyExportable Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificates A lista de certificados a serem instalados em todos os computadores no pool. string[] (obrigatório)

Stateful

Nome Description Value
gracePeriodTimeSpan Por quanto tempo o computador deve ser mantido ao redor depois de executar uma carga de trabalho quando não houver agentes autônomos. O máximo é uma semana. cadeia
variante Propriedade discriminatória para AgentProfile. 'Com estado' (obrigatório)
maxAgentLifetime Por quanto tempo os computadores com estado devem ser mantidos por perto. O máximo é uma semana. cadeia

StatelessAgentProfile

Nome Description Value
variante Propriedade discriminatória para AgentProfile. 'Apátrida' (obrigatório)

StorageProfile

Nome Description Value
Discos de dados Uma lista de discos de dados vazios a serem anexados. Disco de dados
osDiskStorageAccountType O nome da SKU do Azure dos computadores no pool. 'Prêmio'
'Padrão'
'SSD padrão'

TrackedResourceTags

Nome Description Value

UserAssignedIdentity

Nome Description Value

VmssFabricProfile

Nome Description Value
images As imagens de VM dos computadores no pool. PoolImage[] (obrigatório)
variante Propriedade discriminatória para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede dos computadores no pool. NetworkProfile
osProfile O perfil do sistema operacional dos computadores no pool. OsProfile
sku A SKU do Azure dos computadores no pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de armazenamento dos computadores no pool. StorageProfile

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Description
Pool de infraestrutura do DevOps Módulo de recurso AVM para pool de infraestrutura de DevOps

Definição de recurso de modelo do ARM

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

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

Formato de recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o JSON a seguir ao modelo.

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

Objetos AgentProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Stateful, use:

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

Para Stateless, use:

{
  "kind": "Stateless"
}

Objetos ResourcePredictionsProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  "kind": "Manual"
}

Objetos OrganizationProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para AzureDevOps, use:

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

Para do GitHub, use:

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

Objetos FabricProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Vmss, use:

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

Valores de propriedade

Microsoft.DevOpsInfrastructure/pools

Nome Description Value
apiVersion A versão da API '2025-09-20'
identidade As identidades de serviço gerenciadas atribuídas a esse recurso. ManagedServiceIdentity
local A localização geográfica onde o recurso reside 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 esse recurso. PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.DevOpsInfrastructure/pools'

AgentProfile

Nome Description Value
variante Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Stateful'
'Apátrida' (obrigatório)
resourcePredictions Define agentes de buffer/stand-by do pool. qualquer
resourcePredictionsProfile Define como o buffer de pool/agentes autônomos é fornecido. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Description Value
variante Determina como o esquema de espera deve ser fornecido. 'Automático' (obrigatório)
predictionPreference Determina o equilíbrio entre custo e desempenho. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Description Value
alias Um alias para fazer referência ao nome do pool do Azure DevOps. cadeia
variante Propriedade discriminatória para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizações A lista de organizações do Azure DevOps em que o pool deve estar presente. Organização (obrigatório)
permissionProfile O tipo de permissão que determina quais contas são administradores no pool do Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Description Value
groups Endereços de email de grupo cadeia de caracteres[]
variante Determina quem tem permissões de administrador para o pool do Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obrigatório)
users Endereços de email do usuário cadeia de caracteres[]

Disco de dados

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

DevOpsAzureSku

Nome Description Value
nome O nome da SKU do Azure dos computadores no pool. string (obrigatório)

Perfil de Tecido

Nome Description Value
variante Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

GitHubOrganization

Nome Description Value
repositories Lista opcional de repositórios nos quais o pool deve ser criado. cadeia de caracteres[]
url A URL da organização do GitHub na qual o pool deve ser criado. string (obrigatório)

GitHubOrganizationProfile

Nome Description Value
variante Propriedade discriminatória para OrganizationProfile. 'GitHub' (obrigatório)
organizações A lista de organizações/repositórios do GitHub em que o pool deve estar presente. GitHubOrganization[] (obrigatório)

ManagedServiceIdentity

Nome Description Value
tipo Tipo de identidade de serviço gerenciado (em que 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 recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Description Value

ManualResourcePredictionsProfile

Nome Description Value
variante Determina como o esquema de espera deve ser fornecido. 'Manual' (obrigatório)

Perfil de rede

Nome Description 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 A ID da sub-rede na qual colocar todos os computadores criados no pool. cadeia

Organização

Nome Description Value
alias Um alias para fazer referência ao nome do pool do Azure DevOps. cadeia
openAccess Determina se o pool deve ter acesso aberto a todos os projetos nesta organização. bool
parallelism Quantos computadores podem ser criados no máximo nesta organização com a máximaConcurreção do pool. int
projects Lista opcional de projetos nos quais o pool deve ser criado. cadeia de caracteres[]
url A URL da organização do Azure DevOps na qual o pool deve ser criado. string (obrigatório)

OrganizationProfile

Nome Description Value
variante Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. Defina como 'GitHub' para o tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obrigatório)

OsProfile

Nome Description 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 de gerenciamento de segredo dos computadores no pool. SecretsManagementSettings

PoolImage

Nome Description Value
aliases Lista de aliases pelos quais fazer referência à imagem. cadeia de caracteres[]
armazenar em buffer O percentual do buffer a ser alocado para essa imagem. cadeia
ephemeralType O tipo efêmero da imagem. 'Automático'
'CacheDisk'
'ResourceDisk'
resourceId A ID do recurso da imagem. cadeia
wellKnownImageName A imagem a ser usada de um conjunto bem conhecido de imagens disponibilizadas aos clientes. cadeia

Propriedades do Pool

Nome Description Value
agentProfile Define como o computador será tratado depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A ID do recurso do Projeto DevCenter ao qual o pool pertence. string (obrigatório)
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'
'Cancelado'
'Excluindo'
'Falha'
'Provisionamento'
'Bem-sucedido'
'Atualizando'
runtimeConfiguração A configuração de runtime do pool. Configuração de tempo de execução

ResourcePredictionsProfile

Nome Description Value
variante Defina como 'Automático' para o tipo AutomaticResourcePredictionsProfile. Defina como 'Manual' para o tipo ManualResourcePredictionsProfile. 'Automático'
'Manual' (obrigatório)

Configuração de tempo de execução

Nome Description Value
pasta de trabalho A pasta de trabalho de destino do agente de tarefas no computador. cadeia

SecretsManagementSettings

Nome Description Value
certificateStoreLocation Onde armazenar certificados no computador. cadeia
certificateStoreName Nome do repositório de certificados a ser usado no computador, atualmente há suporte para 'My' e 'Root'. 'Meu'
'Raiz'
keyExportable Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificates A lista de certificados a serem instalados em todos os computadores no pool. string[] (obrigatório)

Stateful

Nome Description Value
gracePeriodTimeSpan Por quanto tempo o computador deve ser mantido ao redor depois de executar uma carga de trabalho quando não houver agentes autônomos. O máximo é uma semana. cadeia
variante Propriedade discriminatória para AgentProfile. 'Com estado' (obrigatório)
maxAgentLifetime Por quanto tempo os computadores com estado devem ser mantidos por perto. O máximo é uma semana. cadeia

StatelessAgentProfile

Nome Description Value
variante Propriedade discriminatória para AgentProfile. 'Apátrida' (obrigatório)

StorageProfile

Nome Description Value
Discos de dados Uma lista de discos de dados vazios a serem anexados. Disco de dados
osDiskStorageAccountType O nome da SKU do Azure dos computadores no pool. 'Prêmio'
'Padrão'
'SSD padrão'

TrackedResourceTags

Nome Description Value

UserAssignedIdentity

Nome Description Value

VmssFabricProfile

Nome Description Value
images As imagens de VM dos computadores no pool. PoolImage[] (obrigatório)
variante Propriedade discriminatória para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede dos computadores no pool. NetworkProfile
osProfile O perfil do sistema operacional dos computadores no pool. OsProfile
sku A SKU do Azure dos computadores no pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de armazenamento dos computadores no pool. StorageProfile

Exemplos de uso

Definição de recurso do Terraform (provedor de AzAPI)

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

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

Formato de recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o Terraform a seguir ao seu modelo.

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

Objetos AgentProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Stateful, use:

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

Para Stateless, use:

{
  kind = "Stateless"
}

Objetos ResourcePredictionsProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  kind = "Manual"
}

Objetos OrganizationProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para AzureDevOps, use:

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

Para do GitHub, use:

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

Objetos FabricProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para Vmss, use:

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

Valores de propriedade

Microsoft.DevOpsInfrastructure/pools

Nome Description Value
identidade As identidades de serviço gerenciadas atribuídas a esse recurso. ManagedServiceIdentity
local A localização geográfica onde o recurso reside string (obrigatório)
nome O nome do recurso string

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades As propriedades específicas do recurso para esse recurso. PoolProperties
tags Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DevOpsInfrastructure/pools@2025-09-20"

AgentProfile

Nome Description Value
variante Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Stateful'
'Apátrida' (obrigatório)
resourcePredictions Define agentes de buffer/stand-by do pool. qualquer
resourcePredictionsProfile Define como o buffer de pool/agentes autônomos é fornecido. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Description Value
variante Determina como o esquema de espera deve ser fornecido. 'Automático' (obrigatório)
predictionPreference Determina o equilíbrio entre custo e desempenho. 'Balanced'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Description Value
alias Um alias para fazer referência ao nome do pool do Azure DevOps. cadeia
variante Propriedade discriminatória para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizações A lista de organizações do Azure DevOps em que o pool deve estar presente. Organização (obrigatório)
permissionProfile O tipo de permissão que determina quais contas são administradores no pool do Azure DevOps. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Description Value
groups Endereços de email de grupo cadeia de caracteres[]
variante Determina quem tem permissões de administrador para o pool do Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obrigatório)
users Endereços de email do usuário cadeia de caracteres[]

Disco de dados

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

DevOpsAzureSku

Nome Description Value
nome O nome da SKU do Azure dos computadores no pool. string (obrigatório)

Perfil de Tecido

Nome Description Value
variante Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

GitHubOrganization

Nome Description Value
repositories Lista opcional de repositórios nos quais o pool deve ser criado. cadeia de caracteres[]
url A URL da organização do GitHub na qual o pool deve ser criado. string (obrigatório)

GitHubOrganizationProfile

Nome Description Value
variante Propriedade discriminatória para OrganizationProfile. 'GitHub' (obrigatório)
organizações A lista de organizações/repositórios do GitHub em que o pool deve estar presente. GitHubOrganization[] (obrigatório)

ManagedServiceIdentity

Nome Description Value
tipo Tipo de identidade de serviço gerenciado (em que 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 recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Description Value

ManualResourcePredictionsProfile

Nome Description Value
variante Determina como o esquema de espera deve ser fornecido. 'Manual' (obrigatório)

Perfil de rede

Nome Description 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 A ID da sub-rede na qual colocar todos os computadores criados no pool. cadeia

Organização

Nome Description Value
alias Um alias para fazer referência ao nome do pool do Azure DevOps. cadeia
openAccess Determina se o pool deve ter acesso aberto a todos os projetos nesta organização. bool
parallelism Quantos computadores podem ser criados no máximo nesta organização com a máximaConcurreção do pool. int
projects Lista opcional de projetos nos quais o pool deve ser criado. cadeia de caracteres[]
url A URL da organização do Azure DevOps na qual o pool deve ser criado. string (obrigatório)

OrganizationProfile

Nome Description Value
variante Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. Defina como 'GitHub' para o tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obrigatório)

OsProfile

Nome Description 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 de gerenciamento de segredo dos computadores no pool. SecretsManagementSettings

PoolImage

Nome Description Value
aliases Lista de aliases pelos quais fazer referência à imagem. cadeia de caracteres[]
armazenar em buffer O percentual do buffer a ser alocado para essa imagem. cadeia
ephemeralType O tipo efêmero da imagem. 'Automático'
'CacheDisk'
'ResourceDisk'
resourceId A ID do recurso da imagem. cadeia
wellKnownImageName A imagem a ser usada de um conjunto bem conhecido de imagens disponibilizadas aos clientes. cadeia

Propriedades do Pool

Nome Description Value
agentProfile Define como o computador será tratado depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A ID do recurso do Projeto DevCenter ao qual o pool pertence. string (obrigatório)
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'
'Cancelado'
'Excluindo'
'Falha'
'Provisionamento'
'Bem-sucedido'
'Atualizando'
runtimeConfiguração A configuração de runtime do pool. Configuração de tempo de execução

ResourcePredictionsProfile

Nome Description Value
variante Defina como 'Automático' para o tipo AutomaticResourcePredictionsProfile. Defina como 'Manual' para o tipo ManualResourcePredictionsProfile. 'Automático'
'Manual' (obrigatório)

Configuração de tempo de execução

Nome Description Value
pasta de trabalho A pasta de trabalho de destino do agente de tarefas no computador. cadeia

SecretsManagementSettings

Nome Description Value
certificateStoreLocation Onde armazenar certificados no computador. cadeia
certificateStoreName Nome do repositório de certificados a ser usado no computador, atualmente há suporte para 'My' e 'Root'. 'Meu'
'Raiz'
keyExportable Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificates A lista de certificados a serem instalados em todos os computadores no pool. string[] (obrigatório)

Stateful

Nome Description Value
gracePeriodTimeSpan Por quanto tempo o computador deve ser mantido ao redor depois de executar uma carga de trabalho quando não houver agentes autônomos. O máximo é uma semana. cadeia
variante Propriedade discriminatória para AgentProfile. 'Com estado' (obrigatório)
maxAgentLifetime Por quanto tempo os computadores com estado devem ser mantidos por perto. O máximo é uma semana. cadeia

StatelessAgentProfile

Nome Description Value
variante Propriedade discriminatória para AgentProfile. 'Apátrida' (obrigatório)

StorageProfile

Nome Description Value
Discos de dados Uma lista de discos de dados vazios a serem anexados. Disco de dados
osDiskStorageAccountType O nome da SKU do Azure dos computadores no pool. 'Prêmio'
'Padrão'
'SSD padrão'

TrackedResourceTags

Nome Description Value

UserAssignedIdentity

Nome Description Value

VmssFabricProfile

Nome Description Value
images As imagens de VM dos computadores no pool. PoolImage[] (obrigatório)
variante Propriedade discriminatória para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede dos computadores no pool. NetworkProfile
osProfile O perfil do sistema operacional dos computadores no pool. OsProfile
sku A SKU do Azure dos computadores no pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de armazenamento dos computadores no pool. StorageProfile

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Módulo Description
pools de DevOps Módulo de recurso AVM para pools de DevOps
  • Last updated on