Compartilhar via


Pools Microsoft.DevOpsInfrastructure 2023-10-30-preview

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@2023-10-30-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
      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'
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos OrganizationProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para do AzureDevOps, use:

{
  kind: 'AzureDevOps'
  organizations: [
    {
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
}

Objetos AgentProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para com estado, use:

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

Para sem estado, use:

{
  kind: 'Stateless'
}

Objetos FabricProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para de VMss, use:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
}

Valores de propriedade

AgentProfile

Nome Descrição Valor
tipo Defina como "Com estado" para o tipo com estado. Defina como 'Sem estado' para o tipo StatelessAgentProfile. 'Com estado'
'Sem estado' (obrigatório)
resourcePredictions Define o buffer do pool. qualquer

AzureDevOpsOrganizationProfile

Nome Descrição Valor
tipo 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. Organization[] (obrigatório)

DevOpsAzureSku

Nome Descrição Valor
nome O nome da SKU do Azure dos computadores no pool. cadeia de caracteres (obrigatório)
camada A camada de SKU do Azure dos computadores no pool. corda

FabricProfile

Nome Descrição Valor
tipo Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

ManagedServiceIdentity

Nome Descrição Valor
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. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nome Descrição Valor
identidade As identidades de serviço gerenciadas atribuídas a esse recurso. ManagedServiceIdentity
localização A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
Propriedades As propriedades específicas do recurso para esse recurso. PoolProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

NetworkProfile

Nome Descrição Valor
subnetId A ID da sub-rede na qual colocar todos os computadores criados no pool. cadeia de caracteres (obrigatório)

Organização

Nome Descrição Valor
paralelismo Quantos computadores podem ser criados no máximo nesta organização com a máximaConcurreção do pool. int
Projetos 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. cadeia de caracteres (obrigatório)

OrganizationProfile

Nome Descrição Valor
tipo Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. 'AzureDevOps' (obrigatório)

OsProfile

Nome Descrição Valor
secretsManagementSettings As configurações de gerenciamento de segredo dos computadores no pool. SecretsManagementSettings (obrigatório)

PoolImage

Nome Descrição Valor
Aliases Lista de aliases pelos quais fazer referência à imagem. string[]
buffer O percentual do buffer a ser alocado para essa imagem. corda
resourceId A ID do recurso da imagem. cadeia de caracteres (obrigatório)

PoolProperties

Nome Descrição Valor
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. cadeia de caracteres (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'

SecretsManagementSettings

Nome Descrição Valor
certificateStoreLocation Onde armazenar certificados no computador. corda
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 Descrição Valor
tipo 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 de caracteres (obrigatório)

StatelessAgentProfile

Nome Descrição Valor
tipo Propriedade discriminatória para AgentProfile. 'Sem estado' (obrigatório)

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

VmssFabricProfile

Nome Descrição Valor
Imagens As imagens de VM dos computadores no pool. poolImage[] (obrigatório)
tipo 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)

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": "2023-10-30-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos OrganizationProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para do AzureDevOps, use:

{
  "kind": "AzureDevOps",
  "organizations": [
    {
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ]
}

Objetos AgentProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para com estado, use:

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

Para sem estado, use:

{
  "kind": "Stateless"
}

Objetos FabricProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para de VMss, use:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string",
    "tier": "string"
  }
}

Valores de propriedade

AgentProfile

Nome Descrição Valor
tipo Defina como "Com estado" para o tipo com estado. Defina como 'Sem estado' para o tipo StatelessAgentProfile. 'Com estado'
'Sem estado' (obrigatório)
resourcePredictions Define o buffer do pool. qualquer

AzureDevOpsOrganizationProfile

Nome Descrição Valor
tipo 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. Organization[] (obrigatório)

DevOpsAzureSku

Nome Descrição Valor
nome O nome da SKU do Azure dos computadores no pool. cadeia de caracteres (obrigatório)
camada A camada de SKU do Azure dos computadores no pool. corda

FabricProfile

Nome Descrição Valor
tipo Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

ManagedServiceIdentity

Nome Descrição Valor
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. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nome Descrição Valor
apiVersion A versão da API '2023-10-30-preview'
identidade As identidades de serviço gerenciadas atribuídas a esse recurso. ManagedServiceIdentity
localização A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso corda

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

NetworkProfile

Nome Descrição Valor
subnetId A ID da sub-rede na qual colocar todos os computadores criados no pool. cadeia de caracteres (obrigatório)

Organização

Nome Descrição Valor
paralelismo Quantos computadores podem ser criados no máximo nesta organização com a máximaConcurreção do pool. int
Projetos 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. cadeia de caracteres (obrigatório)

OrganizationProfile

Nome Descrição Valor
tipo Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. 'AzureDevOps' (obrigatório)

OsProfile

Nome Descrição Valor
secretsManagementSettings As configurações de gerenciamento de segredo dos computadores no pool. SecretsManagementSettings (obrigatório)

PoolImage

Nome Descrição Valor
Aliases Lista de aliases pelos quais fazer referência à imagem. string[]
buffer O percentual do buffer a ser alocado para essa imagem. corda
resourceId A ID do recurso da imagem. cadeia de caracteres (obrigatório)

PoolProperties

Nome Descrição Valor
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. cadeia de caracteres (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'

SecretsManagementSettings

Nome Descrição Valor
certificateStoreLocation Onde armazenar certificados no computador. corda
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 Descrição Valor
tipo 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 de caracteres (obrigatório)

StatelessAgentProfile

Nome Descrição Valor
tipo Propriedade discriminatória para AgentProfile. 'Sem estado' (obrigatório)

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

VmssFabricProfile

Nome Descrição Valor
Imagens As imagens de VM dos computadores no pool. poolImage[] (obrigatório)
tipo 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)

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

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

  • grupos de recursos

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@2023-10-30-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      agentProfile = {
        resourcePredictions = ?
        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"
    }
  })
}

Objetos OrganizationProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para do AzureDevOps, use:

{
  kind = "AzureDevOps"
  organizations = [
    {
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
}

Objetos AgentProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para com estado, use:

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

Para sem estado, use:

{
  kind = "Stateless"
}

Objetos FabricProfile

Defina o tipo propriedade para especificar o tipo de objeto.

Para de VMss, use:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
    tier = "string"
  }
}

Valores de propriedade

AgentProfile

Nome Descrição Valor
tipo Defina como "Com estado" para o tipo com estado. Defina como 'Sem estado' para o tipo StatelessAgentProfile. 'Com estado'
'Sem estado' (obrigatório)
resourcePredictions Define o buffer do pool. qualquer

AzureDevOpsOrganizationProfile

Nome Descrição Valor
tipo 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. Organization[] (obrigatório)

DevOpsAzureSku

Nome Descrição Valor
nome O nome da SKU do Azure dos computadores no pool. cadeia de caracteres (obrigatório)
camada A camada de SKU do Azure dos computadores no pool. corda

FabricProfile

Nome Descrição Valor
tipo Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

ManagedServiceIdentity

Nome Descrição Valor
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. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nome Descrição Valor
identidade As identidades de serviço gerenciadas atribuídas a esse recurso. ManagedServiceIdentity
localização A localização geográfica onde o recurso reside cadeia de caracteres (obrigatório)
nome O nome do recurso corda

Restrições:
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
Propriedades As propriedades específicas do recurso para esse recurso. PoolProperties
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"

NetworkProfile

Nome Descrição Valor
subnetId A ID da sub-rede na qual colocar todos os computadores criados no pool. cadeia de caracteres (obrigatório)

Organização

Nome Descrição Valor
paralelismo Quantos computadores podem ser criados no máximo nesta organização com a máximaConcurreção do pool. int
Projetos 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. cadeia de caracteres (obrigatório)

OrganizationProfile

Nome Descrição Valor
tipo Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. 'AzureDevOps' (obrigatório)

OsProfile

Nome Descrição Valor
secretsManagementSettings As configurações de gerenciamento de segredo dos computadores no pool. SecretsManagementSettings (obrigatório)

PoolImage

Nome Descrição Valor
Aliases Lista de aliases pelos quais fazer referência à imagem. string[]
buffer O percentual do buffer a ser alocado para essa imagem. corda
resourceId A ID do recurso da imagem. cadeia de caracteres (obrigatório)

PoolProperties

Nome Descrição Valor
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. cadeia de caracteres (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'

SecretsManagementSettings

Nome Descrição Valor
certificateStoreLocation Onde armazenar certificados no computador. corda
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 Descrição Valor
tipo 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 de caracteres (obrigatório)

StatelessAgentProfile

Nome Descrição Valor
tipo Propriedade discriminatória para AgentProfile. 'Sem estado' (obrigatório)

TrackedResourceTags

Nome Descrição Valor

UserAssignedIdentities

Nome Descrição Valor

UserAssignedIdentity

Nome Descrição Valor

VmssFabricProfile

Nome Descrição Valor
Imagens As imagens de VM dos computadores no pool. poolImage[] (obrigatório)
tipo 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)