Partilhar via

Pools Microsoft.DevOpsInfrastructure

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.

Formato do recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o seguinte Bicep 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 Apátrida, use:

{
  kind: 'Stateless'
}

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 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 gerenciado atribuídas a este recurso. ManagedServiceIdentity
localização A geolocalização onde o recurso vive 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 este recurso. PoolProperties
âmbito 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 Tags 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 de pool. any
resourcePredictionsProfile Define como os agentes de buffer/stand-by do pool são fornecidos. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description 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 Description Value
alias Um alias para fazer referência ao nome do pool de DevOps do Azure. cadeia (de caracteres)
kind Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizations A lista de organizações de DevOps do Azure nas quais o pool deve estar presente. Organização[] (obrigatório)
permissionProfile O tipo de permissão que determina quais contas são administradores no pool de DevOps do Azure. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description 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 Description 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 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 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 armazenamento 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 Description Value
name O nome da SKU do Azure das máquinas 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 Discriminator 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 (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 recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Determina como o esquema de stand-by 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 O id da sub-rede no qual colocar todas as máquinas criadas no pool. cadeia (de caracteres)

Organization

Name Description Value
alias Um alias para fazer referência ao nome do pool de DevOps do Azure. 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 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 secretas de gerenciamento das máquinas no pool. SecretsManagementSettings

PoolImage

Name Description 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. 'Automatic'
'CacheDisk'
'ResourceDisk'
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 Description Value
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A id de 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'
runtimeConfiguration A configuração de tempo de execução do pool. RuntimeConfiguration

ResourcePredictionsProfile

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

RuntimeConfiguration

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

SecretsManagementSettings

Name Description 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 Description 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 Description Value
kind Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

StorageProfile

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

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description 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 A SKU do Azure das máquinas no pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de armazenamento das máquinas no pool. StorageProfile

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.

Module Description
Pool de infraestrutura de DevOps Módulo de recursos AVM para pool de infraestrutura de DevOps

Definição de recurso de modelo ARM

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.

Formato do recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o seguinte JSON ao seu 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 Apátrida, use:

{
  "kind": "Stateless"
}

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 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 api '2025-09-20'
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)
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 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 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 de pool. any
resourcePredictionsProfile Define como os agentes de buffer/stand-by do pool são fornecidos. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description 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 Description Value
alias Um alias para fazer referência ao nome do pool de DevOps do Azure. cadeia (de caracteres)
kind Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizations A lista de organizações de DevOps do Azure nas quais o pool deve estar presente. Organização[] (obrigatório)
permissionProfile O tipo de permissão que determina quais contas são administradores no pool de DevOps do Azure. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description 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 Description 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 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 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 armazenamento 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 Description Value
name O nome da SKU do Azure das máquinas 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 Discriminator 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 (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 recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Determina como o esquema de stand-by 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 O id da sub-rede no qual colocar todas as máquinas criadas no pool. cadeia (de caracteres)

Organization

Name Description Value
alias Um alias para fazer referência ao nome do pool de DevOps do Azure. 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 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 secretas de gerenciamento das máquinas no pool. SecretsManagementSettings

PoolImage

Name Description 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. 'Automatic'
'CacheDisk'
'ResourceDisk'
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 Description Value
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A id de 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'
runtimeConfiguration A configuração de tempo de execução do pool. RuntimeConfiguration

ResourcePredictionsProfile

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

RuntimeConfiguration

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

SecretsManagementSettings

Name Description 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 Description 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 Description Value
kind Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

StorageProfile

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

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description 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 A SKU do Azure das máquinas no pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de armazenamento das máquinas no pool. StorageProfile

Exemplos de uso

Definição de recursos Terraform (provedor AzAPI)

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.

Formato do recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o seguinte Terraform 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 Apátrida, use:

{
  kind = "Stateless"
}

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 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 gerenciado atribuídas a este recurso. ManagedServiceIdentity
localização A geolocalização onde o recurso vive 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 este 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 de pool. any
resourcePredictionsProfile Define como os agentes de buffer/stand-by do pool são fornecidos. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Name Description 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 Description Value
alias Um alias para fazer referência ao nome do pool de DevOps do Azure. cadeia (de caracteres)
kind Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
organizations A lista de organizações de DevOps do Azure nas quais o pool deve estar presente. Organização[] (obrigatório)
permissionProfile O tipo de permissão que determina quais contas são administradores no pool de DevOps do Azure. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Name Description 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 Description 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 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 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 armazenamento 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 Description Value
name O nome da SKU do Azure das máquinas 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 Discriminator 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 (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 recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Name Description Value

ManualResourcePredictionsProfile

Name Description Value
kind Determina como o esquema de stand-by 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 O id da sub-rede no qual colocar todas as máquinas criadas no pool. cadeia (de caracteres)

Organization

Name Description Value
alias Um alias para fazer referência ao nome do pool de DevOps do Azure. 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 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 secretas de gerenciamento das máquinas no pool. SecretsManagementSettings

PoolImage

Name Description 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. 'Automatic'
'CacheDisk'
'ResourceDisk'
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 Description Value
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A id de 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'
runtimeConfiguration A configuração de tempo de execução do pool. RuntimeConfiguration

ResourcePredictionsProfile

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

RuntimeConfiguration

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

SecretsManagementSettings

Name Description 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 Description 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 Description Value
kind Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

StorageProfile

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

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description 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 A SKU do Azure das máquinas no pool. DevOpsAzureSku (obrigatório)
storageProfile O perfil de armazenamento das máquinas no pool. StorageProfile

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.

Module Description
DevOps Pools Módulo de recursos AVM para pools de DevOps
  • Last updated on