Pools Microsoft.DevOpsInfrastructure

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 do 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 OrganizationProfile

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

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

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para Stateless, use:

{
  kind: 'Stateless'
}

Objetos ResourcePredictionsProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  kind: 'Manual'
}

Objetos FabricProfile

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

Name	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)
name	O nome do recurso	string Constraints: Padrão = `^[a-zA-Z0-9][a-zA-Z0-9-.]*$` (obrigatório)
properties	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

Name	Description	Value
kind	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.	any
resourcePredictionsProfile	Define como o buffer de pool/agentes autônomos é fornecido.	ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name	Description	Value
kind	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

Name	Description	Value
alias	Um alias para fazer referência ao nome do pool do Azure DevOps.	cadeia
kind	Propriedade discriminatória para OrganizationProfile.	'AzureDevOps' (obrigatório)
organizations	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

Name	Description	Value
groups	Endereços de email de grupo	string[]
kind	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	string[]

DataDisk

Name	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' 'ReadOnly' '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

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

FabricProfile

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

GitHubOrganization

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

GitHubOrganizationProfile

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

ManagedServiceIdentity

Name	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

Name	Description	Value

ManualResourcePredictionsProfile

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

NetworkProfile

Name	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

Organization

Name	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.	string[]
url	A URL da organização do Azure DevOps na qual o pool deve ser criado.	string (obrigatório)

OrganizationProfile

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

OsProfile

Name	Description	Value
logonType	Determina como o serviço deve ser executado. Por padrão, isso será definido como Serviço.	'Interactive' 'Service'
secretsManagementSettings	As configurações de gerenciamento de segredo dos computadores no pool.	SecretsManagementSettings

PoolImage

Name	Description	Value
aliases	Lista de aliases pelos quais fazer referência à imagem.	string[]
armazenar em buffer	O percentual do buffer a ser alocado para essa imagem.	cadeia
ephemeralType	O tipo efêmero da imagem.	'Automatic' '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

PoolProperties

Name	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 Constraints: 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.	'Accepted' 'Canceled' 'Deleting' 'Failed' 'Provisioning' 'Succeeded' 'Updating'
runtimeConfiguração	A configuração de runtime do pool.	Configuração de tempo de execução

ResourcePredictionsProfile

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

Configuração de tempo de execução

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

SecretsManagementSettings

Name	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'.	'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 todos os computadores no pool.	string[] (obrigatório)

Stateful

Name	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
kind	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

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

StorageProfile

Name	Description	Value
dataDisks	Uma lista de discos de dados vazios a serem anexados.	DataDisk[]
osDiskStorageAccountType	O nome da SKU do Azure dos computadores no pool.	'Premium' 'Standard' 'StandardSSD'

TrackedResourceTags

Name	Description	Value

UserAssignedIdentity

Name	Description	Value

VmssFabricProfile

Name	Description	Value
images	As imagens de VM dos computadores no pool.	PoolImage[] (obrigatório)
kind	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.

Module	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 do 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 OrganizationProfile

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

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

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para Stateless, use:

{
  "kind": "Stateless"
}

Objetos ResourcePredictionsProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  "kind": "Manual"
}

Objetos FabricProfile

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

Name	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)
name	O nome do recurso	string Constraints: Padrão = `^[a-zA-Z0-9][a-zA-Z0-9-.]*$` (obrigatório)
properties	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

Name	Description	Value
kind	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.	any
resourcePredictionsProfile	Define como o buffer de pool/agentes autônomos é fornecido.	ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name	Description	Value
kind	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

Name	Description	Value
alias	Um alias para fazer referência ao nome do pool do Azure DevOps.	cadeia
kind	Propriedade discriminatória para OrganizationProfile.	'AzureDevOps' (obrigatório)
organizations	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

Name	Description	Value
groups	Endereços de email de grupo	string[]
kind	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	string[]

DataDisk

Name	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' 'ReadOnly' '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

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

FabricProfile

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

GitHubOrganization

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

GitHubOrganizationProfile

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

ManagedServiceIdentity

Name	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

Name	Description	Value

ManualResourcePredictionsProfile

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

NetworkProfile

Name	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

Organization

Name	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.	string[]
url	A URL da organização do Azure DevOps na qual o pool deve ser criado.	string (obrigatório)

OrganizationProfile

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

OsProfile

Name	Description	Value
logonType	Determina como o serviço deve ser executado. Por padrão, isso será definido como Serviço.	'Interactive' 'Service'
secretsManagementSettings	As configurações de gerenciamento de segredo dos computadores no pool.	SecretsManagementSettings

PoolImage

Name	Description	Value
aliases	Lista de aliases pelos quais fazer referência à imagem.	string[]
armazenar em buffer	O percentual do buffer a ser alocado para essa imagem.	cadeia
ephemeralType	O tipo efêmero da imagem.	'Automatic' '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

PoolProperties

Name	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 Constraints: 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.	'Accepted' 'Canceled' 'Deleting' 'Failed' 'Provisioning' 'Succeeded' 'Updating'
runtimeConfiguração	A configuração de runtime do pool.	Configuração de tempo de execução

ResourcePredictionsProfile

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

Configuração de tempo de execução

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

SecretsManagementSettings

Name	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'.	'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 todos os computadores no pool.	string[] (obrigatório)

Stateful

Name	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
kind	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

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

StorageProfile

Name	Description	Value
dataDisks	Uma lista de discos de dados vazios a serem anexados.	DataDisk[]
osDiskStorageAccountType	O nome da SKU do Azure dos computadores no pool.	'Premium' 'Standard' 'StandardSSD'

TrackedResourceTags

Name	Description	Value

UserAssignedIdentity

Name	Description	Value

VmssFabricProfile

Name	Description	Value
images	As imagens de VM dos computadores no pool.	PoolImage[] (obrigatório)
kind	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 do 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 OrganizationProfile

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

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

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para Stateless, use:

{
  kind = "Stateless"
}

Objetos ResourcePredictionsProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Automático, use:

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

Para Manual, use:

{
  kind = "Manual"
}

Objetos FabricProfile

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

Name	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)
name	O nome do recurso	string Constraints: 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)
properties	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

Name	Description	Value
kind	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.	any
resourcePredictionsProfile	Define como o buffer de pool/agentes autônomos é fornecido.	ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name	Description	Value
kind	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

Name	Description	Value
alias	Um alias para fazer referência ao nome do pool do Azure DevOps.	cadeia
kind	Propriedade discriminatória para OrganizationProfile.	'AzureDevOps' (obrigatório)
organizations	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

Name	Description	Value
groups	Endereços de email de grupo	string[]
kind	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	string[]

DataDisk

Name	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' 'ReadOnly' '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

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

FabricProfile

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

GitHubOrganization

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

GitHubOrganizationProfile

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

ManagedServiceIdentity

Name	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

Name	Description	Value

ManualResourcePredictionsProfile

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

NetworkProfile

Name	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

Organization

Name	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.	string[]
url	A URL da organização do Azure DevOps na qual o pool deve ser criado.	string (obrigatório)

OrganizationProfile

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

OsProfile

Name	Description	Value
logonType	Determina como o serviço deve ser executado. Por padrão, isso será definido como Serviço.	'Interactive' 'Service'
secretsManagementSettings	As configurações de gerenciamento de segredo dos computadores no pool.	SecretsManagementSettings

PoolImage

Name	Description	Value
aliases	Lista de aliases pelos quais fazer referência à imagem.	string[]
armazenar em buffer	O percentual do buffer a ser alocado para essa imagem.	cadeia
ephemeralType	O tipo efêmero da imagem.	'Automatic' '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

PoolProperties

Name	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 Constraints: 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.	'Accepted' 'Canceled' 'Deleting' 'Failed' 'Provisioning' 'Succeeded' 'Updating'
runtimeConfiguração	A configuração de runtime do pool.	Configuração de tempo de execução

ResourcePredictionsProfile

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

Configuração de tempo de execução

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

SecretsManagementSettings

Name	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'.	'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 todos os computadores no pool.	string[] (obrigatório)

Stateful

Name	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
kind	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

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

StorageProfile

Name	Description	Value
dataDisks	Uma lista de discos de dados vazios a serem anexados.	DataDisk[]
osDiskStorageAccountType	O nome da SKU do Azure dos computadores no pool.	'Premium' 'Standard' 'StandardSSD'

TrackedResourceTags

Name	Description	Value

UserAssignedIdentity

Name	Description	Value

VmssFabricProfile

Name	Description	Value
images	As imagens de VM dos computadores no pool.	PoolImage[] (obrigatório)
kind	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.

Module	Description
pools de DevOps	Módulo de recurso AVM para pools de DevOps

Comentários

Esta página foi útil?

Last updated on 2025-10-09

Compartilhar via

Pools Microsoft.DevOpsInfrastructure

Definição de recurso do Bicep

Formato do recurso

Objetos OrganizationProfile

Objetos AgentProfile

Objetos ResourcePredictionsProfile

Objetos FabricProfile

Valores de propriedade

Microsoft.DevOpsInfrastructure/pools

AgentProfile

AutomaticResourcePredictionsProfile

AzureDevOpsOrganizationProfile

AzureDevOpsPermissionProfile

DataDisk

DevOpsAzureSku

FabricProfile

GitHubOrganization

GitHubOrganizationProfile

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

ManualResourcePredictionsProfile

NetworkProfile

Organization

OrganizationProfile

OsProfile

PoolImage

PoolProperties

ResourcePredictionsProfile

Configuração de tempo de execução

SecretsManagementSettings

Stateful

StatelessAgentProfile

StorageProfile

TrackedResourceTags

UserAssignedIdentity

VmssFabricProfile

Exemplos de uso

Módulos verificados do Azure

Definição de recurso de modelo do ARM

Formato do recurso

Objetos OrganizationProfile

Objetos AgentProfile

Objetos ResourcePredictionsProfile

Objetos FabricProfile

Valores de propriedade

Microsoft.DevOpsInfrastructure/pools

AgentProfile

AutomaticResourcePredictionsProfile

AzureDevOpsOrganizationProfile

AzureDevOpsPermissionProfile

DataDisk

DevOpsAzureSku

FabricProfile

GitHubOrganization

GitHubOrganizationProfile

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

ManualResourcePredictionsProfile

NetworkProfile

Organization

OrganizationProfile

OsProfile

PoolImage

PoolProperties

ResourcePredictionsProfile

Configuração de tempo de execução

SecretsManagementSettings

Stateful

StatelessAgentProfile

StorageProfile

TrackedResourceTags

UserAssignedIdentity

VmssFabricProfile

Exemplos de uso

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

Formato do recurso

Objetos OrganizationProfile

Objetos AgentProfile

Objetos ResourcePredictionsProfile