Compartilhar via


az batch pool

Observação

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerenciar pools de lotes.

Comandos

Nome Description Tipo Status
az batch pool autoscale

Gerencie o dimensionamento automático de pools de lotes.

Núcleo GA
az batch pool autoscale disable

Desativa o dimensionamento automático para um Pool.

Núcleo GA
az batch pool autoscale enable

Habilita o dimensionamento automático para um Pool.

Núcleo GA
az batch pool autoscale evaluate

Obtém o resultado da avaliação de uma fórmula de dimensionamento automático no Pool.

Núcleo GA
az batch pool create

Crie um pool de lotes em uma conta. Ao criar um pool, escolha argumentos na Configuração dos Serviços de Nuvem ou na Configuração da Máquina Virtual.

Núcleo GA
az batch pool create (azure-batch-cli-extensions extensão)

Crie um pool de lotes em uma conta. Ao criar um pool, escolha argumentos na Configuração dos Serviços de Nuvem ou na Configuração da Máquina Virtual.

Extensão GA
az batch pool delete

Exclui um Pool da Conta especificada.

Núcleo GA
az batch pool list

Lista todos os Pools na Conta especificada.

Núcleo GA
az batch pool node-counts

Obtenha contagens de nós para pools de lotes.

Núcleo GA
az batch pool node-counts list

Obtém o número de nós de computação em cada estado, agrupados por pool.

Núcleo GA
az batch pool reset

Atualize as propriedades de um pool de lotes. As propriedades não especificadas que podem ser atualizadas são redefinidas para seus padrões.

Núcleo GA
az batch pool resize

Redimensione ou pare o redimensionamento de um pool de lotes.

Núcleo GA
az batch pool set

Atualize as propriedades de um pool de lotes. A atualização de uma propriedade em um subgrupo redefinirá as propriedades não especificadas desse grupo.

Núcleo GA
az batch pool show

Obtém informações sobre o Pool especificado.

Núcleo GA
az batch pool supported-images

Consultar informações sobre imagens de VM suportadas pelo serviço de Lote do Azure.

Núcleo GA
az batch pool supported-images list

Lista todas as Imagens de Máquina Virtual suportadas pelo serviço de Lote do Azure.

Núcleo GA
az batch pool usage-metrics

Exibir métricas de uso de pools de lotes.

Núcleo GA
az batch pool usage-metrics list

Lista as métricas de uso, agregadas por Pool em intervalos de tempo individuais, para a Conta especificada.

Núcleo GA

az batch pool create

Crie um pool de lotes em uma conta. Ao criar um pool, escolha argumentos na Configuração dos Serviços de Nuvem ou na Configuração da Máquina Virtual.

az batch pool create [--accelerated-networking {false, true}]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--defer-os-rolling-upgrade {false, true}]
                     [--disable-auto-rollback {false, true}]
                     [--disk-encryption-targets]
                     [--enable-auto-os-upgrade {false, true}]
                     [--enable-cross-zone-upgrade {false, true}]
                     [--enable-inter-node-communication]
                     [--enable-secure-boot {false, true}]
                     [--enable-vtpm {false, true}]
                     [--enable-write-accel {false, true}]
                     [--encryption-at-host {false, true}]
                     [--id]
                     [--image]
                     [--json-file]
                     [--max-batch-instance-percent]
                     [--max-unhealthy-instance-percent]
                     [--max-unhealthy-upgraded-instance-percent]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-disk-caching {none, readonly, readwrite}]
                     [--os-disk-size]
                     [--os-family {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--pause-time-between-batches]
                     [--placement {cachedisk}]
                     [--policy {regional, zonal}]
                     [--prioritize-unhealthy-instances {false, true}]
                     [--resize-timeout]
                     [--resource-tags]
                     [--rollback-failed-instances-on-policy-breach {false, true}]
                     [--security-type]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
                     [--target-communication {classic, default, simplified}]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--upgrade-policy-mode {automatic, manual, rolling}]
                     [--use-rolling-upgrade-policy {false, true}]
                     [--vm-size]

Parâmetros Opcionais

--accelerated-networking

Se esse pool deve habilitar a rede acelerada. A rede acelerada permite a virtualização de E/S de raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho da rede. Para obter mais detalhes, consulte: https://learn.microsoft.com/azure/virtual- network/accelerated-networking-overview. Defina true para habilitar.

Valores aceitos: false, true
--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta de lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-licenses

A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço em lote disponíveis. Se for solicitada uma licença que não é suportada, a criação do pool falhará. Valores separados por espaço.

--application-package-references

Ao criar um pool, a ID do aplicativo do pacote deve ser totalmente qualificada (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). As alterações nas referências de Pacote afetam todos os novos Nós que ingressam no Pool, mas não afetam os Nós de Computação que já estão no Pool até que sejam reinicializados ou recriados a imagem. Há um máximo de 10 referências de pacote em qualquer Pool. IDs de aplicativo separados por espaço com versão opcional no formato 'id[#version]'.

--auto-scale-formula

Uma fórmula para o número desejado de nós de computação no pool. A fórmula é verificada quanto à validade antes que o pool seja criado. Se a fórmula não for válida, o serviço em lote rejeitará a solicitação com informações detalhadas de erro. Para obter mais informações sobre como especificar essa fórmula, consulte https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

Para nós do Windows, o serviço em lote instala os certificados no armazenamento e no local de certificados especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para Certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório base do usuário (por exemplo, /home/{user-name}/certs) e os Certificados são colocados nesse diretório. Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use a extensão do Azure KeyVault. Impressões digitais de certificado separadas por espaço.

--defer-os-rolling-upgrade

Adie as atualizações do sistema operacional nos TVMs se eles estiverem executando tarefas. True se o sinalizador estiver presente.

Valores aceitos: false, true
--disable-auto-rollback

Se o recurso de reversão de imagem do sistema operacional deve ser desativado. True se o sinalizador estiver presente.

Valores aceitos: false, true
--disk-encryption-targets

Uma lista separada por espaço de DiskEncryptionTargets. os valores possíveis atuais incluem OsDisk e TemporaryDisk.

--enable-auto-os-upgrade

Indica se as atualizações do sistema operacional devem ser aplicadas automaticamente para dimensionar instâncias do conjunto de forma contínua quando uma versão mais recente da imagem do sistema operacional estiver disponível.

Se isso for definido como true para pools baseados no Windows, WindowsConfiguration.enableAutomaticUpdates não poderá ser definido como true. True se o sinalizador estiver presente.

Valores aceitos: false, true
--enable-cross-zone-upgrade

Permitir que o VMSS ignore os limites AZ ao construir lotes de atualização. Leve em consideração o Update Domain e maxBatchInstancePercent para determinar o tamanho do lote. Esse campo pode ser definido como true ou false somente ao usar NodePlacementConfiguration como Zonal. True se o sinalizador estiver presente.

Valores aceitos: false, true
--enable-inter-node-communication

Se o Pool permite a comunicação direta entre nós de computação. A habilitação da comunicação entre nós limita o tamanho máximo do Pool devido a restrições de implantação nos Nós de Computação do Pool. Isso pode fazer com que o Pool não atinja o tamanho desejado. O valor padrão é falso. True se o sinalizador estiver presente.

--enable-secure-boot

Habilite a inicialização segura.

Valores aceitos: false, true
--enable-vtpm

Habilite o vTPM.

Valores aceitos: false, true
--enable-write-accel

Especifique se writeAccelerator deve ser habilitado ou desabilitado no disco.

Valores aceitos: false, true
--encryption-at-host

Essa propriedade pode ser usada pelo usuário na solicitação para habilitar ou desabilitar a Criptografia de Host para o conjunto de dimensionamento de máquina virtual ou máquina virtual. Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. O comportamento padrão é: A criptografia no host será desabilitada, a menos que essa propriedade seja definida como true para o recurso.

Valores aceitos: false, true
--id

Obrigatória. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífens e sublinhados, e não pode conter mais de 64 caracteres. O ID preserva maiúsculas de minúsculas e não diferencia maiúsculas de minúsculas (ou seja, você pode não ter dois IDs de Pool em uma Conta que diferem apenas por maiúsculas e minúsculas).

--image

Referência de imagem do sistema operacional. Isso pode ser o formato 'publisher:offer:sku[:version]' ou um ID de imagem ARM totalmente qualificado do formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se o formato 'publisher:offer:sku[:version]', a versão é opcional e, se omitida, a última será usada. Os valores válidos podem ser recuperados através da 'az batch pool supported-images list'. Por exemplo: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

O arquivo que contém a especificação do parâmetro de propriedades de criação do pool em JSON (formatado para corresponder ao corpo da solicitação da API REST). Se esse parâmetro for especificado, todos os 'Argumentos de parâmetro de criação de propriedades do pool' serão ignorados. Consulte https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.

--max-batch-instance-percent

A porcentagem máxima do total de instâncias de máquina virtual que serão atualizadas simultaneamente pela atualização sem interrupção em um lote. Como esse é um máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que a porcentagem de instâncias em um lote diminua para garantir maior confiabilidade. O valor desse campo deve estar entre 5 e 100, inclusive. Se maxBatchInstancePercent e maxUnhealthyInstancePercent forem atribuídos com valor, o valor de maxBatchInstancePercent não deverá ser maior que maxUnhealthyInstancePercent.

--max-unhealthy-instance-percent

A porcentagem máxima do total de instâncias de máquina virtual no conjunto de escala que pode ser simultaneamente não íntegra, como resultado de ser atualizada ou por ser encontrada em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização sem interrupção seja interrompida. Essa restrição será verificada antes de iniciar qualquer lote. O valor desse campo deve estar entre 5 e 100, inclusive. Se maxBatchInstancePercent e maxUnhealthyInstancePercent forem atribuídos com valor, o valor de maxBatchInstancePercent não deverá ser maior que maxUnhealthyInstancePercent.

--max-unhealthy-upgraded-instance-percent

A porcentagem máxima de instâncias de máquina virtual atualizadas que podem ser encontradas em um estado não íntegro. Essa verificação acontecerá depois que cada lote for atualizado. Se essa porcentagem for excedida, a atualização contínua será cancelada. O valor desse campo deve estar entre 0 e 100, inclusive.

--metadata

O serviço Batch não atribui nenhum significado aos metadados; é exclusivamente para o uso de código de usuário. Valores separados por espaço no formato 'key=value'.

--node-agent-sku-id

Obrigatória. O agente Nó de Computação em Lote é um programa executado em cada Nó de Computação no Pool e fornece a interface de comando e controle entre o Nó de Computação e o serviço de Lote. Há diferentes implementações do agente Compute Node, conhecido como SKUs, para diferentes sistemas operacionais. Você deve especificar um SKU do agente do nó de computação que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente de nó de computação suportados junto com sua lista de referências de imagem verificadas, consulte a operação 'Listar SKUs de agente de nó de computação suportados'.

--os-disk-caching

Especifique os requisitos de cache. Os valores possíveis são: None, ReadOnly, ReadWrite. Os valores padrão são: Nenhum para armazenamento padrão. ReadOnly para armazenamento Premium.

Valores aceitos: none, readonly, readwrite
--os-disk-size

O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional.

--os-family

Obrigatória. Os valores possíveis são: 2 - Família OS 2, equivalente ao Windows Server 2008 R2 SP1. 3 - Família OS 3, equivalente ao Windows Server 2012. 4 - Família OS 4, equivalente ao Windows Server 2012 R2. 5 - Família OS 5, equivalente ao Windows Server 2016. 6 - Família OS 6, equivalente ao Windows Server 2019. Para obter mais informações, consulte Versões do sistema operacional convidado do Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

Valores aceitos: 2, 3, 4, 5, 6
--os-version

O valor padrão é * que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada.

--pause-time-between-batches

O tempo de espera entre a conclusão da atualização para todas as máquinas virtuais em um lote e o início do próximo lote. A duração do tempo deve ser especificada no formato ISO 8601. O formato esperado é uma duração ISO-8601.

--placement

Especifica o posicionamento de disco efêmero para o disco do sistema operacional para todas as VMs no pool. Essa propriedade pode ser usada pelo usuário na solicitação para escolher o local, por exemplo, espaço em cache em disco para provisionamento de disco do sistema operacional efêmero. Para obter mais informações sobre os requisitos de tamanho de disco do sistema operacional efêmero, consulte Requisitos de tamanho de disco do sistema operacional efêmero para VMs do Windows em https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e VMs Linux em https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

Valores aceitos: cachedisk
--policy

Tipo de política de posicionamento de nó em pools de lotes. Política de alocação usada pelo Serviço em Lote para provisionar os nós. Se não for especificado, o Batch usará a política regional.

Valores aceitos: regional, zonal
--prioritize-unhealthy-instances

Atualize todas as instâncias não íntegras em um conjunto de escala antes de qualquer instância íntegra. True se o sinalizador estiver presente.

Valores aceitos: false, true
--resize-timeout

Esse tempo limite se aplica apenas ao dimensionamento manual; ele não tem efeito quando enableAutoScale é definido como true. O valor padrão é 15 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). O formato esperado é uma duração ISO-8601.

--resource-tags

O usuário pode especificar marcas de recurso para o pool. Qualquer recurso criado para o pool também será marcado pelas mesmas marcas de recurso.

--rollback-failed-instances-on-policy-breach

Reverter instâncias com falha para o modelo anterior se a política de Atualização Contínua for violada. True se o sinalizador estiver presente.

Valores aceitos: false, true
--security-type

Especifique o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. O comportamento padrão é: UefiSettings não será habilitado a menos que essa propriedade seja definida.

--start-task-command-line

Obrigatória. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho da tarefa) ou usar a variável de ambiente fornecida em lote (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Os arquivos listados nesse elemento estão localizados no diretório de trabalho da tarefa. Referências de recursos separados por espaço no formato filename=httpurl.

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida da StartTask (ou seja, sair com o código de saída 0) antes de agendar qualquer tarefa no nó de computação. Se true e StartTask falhar em um nó, o serviço em lote repetirá o StartTask até sua contagem máxima de tentativas (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o Nó inutilizável e não agendará Tarefas para ele. Essa condição pode ser detectada por meio do estado do nó de computação e dos detalhes das informações de falha. Se false, o serviço em lote não aguardará a conclusão do StartTask. Nesse caso, outras Tarefas podem começar a ser executadas no Nó de Computação enquanto a StartTask ainda está em execução; e mesmo se o StartTask falhar, novas Tarefas continuarão a ser agendadas no Nó de Computação. O padrão é true. True se o sinalizador estiver presente.

--storage-account-type

O tipo de conta de armazenamento para disco gerenciado.

Valores aceitos: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

O modo de comunicação de nó desejado para o pool. Se esse elemento estiver presente, ele substituirá o targetNodeCommunicationMode existente configurado no Pool. Se omitidos, todos os metadados existentes serão mantidos inalterados.

Valores aceitos: classic, default, simplified
--target-dedicated-nodes

O número desejado de nós de computação dedicados no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale estiver definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

--target-low-priority-nodes

O número desejado de nós de computação de prioridade pontual/baixa no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale estiver definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

--targets

Se omitido, nenhum disco nos nós de computação no pool será criptografado. No pool Linux, apenas "TemporaryDisk" é suportado; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Espaço separado discos de destino a serem criptografados. Os valores podem ser OsDisk ou TemporaryDisk.

--task-slots-per-node

O número de slots de tarefas que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256.

--upgrade-policy-mode

O modo de atualização do sistema operacional do pool.

Valores aceitos: automatic, manual, rolling
--use-rolling-upgrade-policy

Indica se a política de atualização contínua deve ser usada durante a Atualização Automática do SO. A Atualização Automática do SO fará fallback para a política padrão se nenhuma política for definida no VMSS. True se o sinalizador estiver presente.

Valores aceitos: false, true
--vm-size

Obrigatória. Para obter informações sobre tamanhos disponíveis de máquinas virtuais para Pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Tamanhos para Serviços de Nuvem (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Batch oferece suporte a todos os tamanhos de VM dos Serviços de Nuvem, exceto ExtraSmall, A1V2 e A2V2. Para obter informações sobre tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais (Linux)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ () ou Tamanhos para máquinas virtuais (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). O lote dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (séries STANDARD_GS, STANDARD_DS e STANDARD_DSV2).

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool create (azure-batch-cli-extensions extensão)

Crie um pool de lotes em uma conta. Ao criar um pool, escolha argumentos na Configuração dos Serviços de Nuvem ou na Configuração da Máquina Virtual.

az batch pool create [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--disk-encryption-targets]
                     [--enable-inter-node-communication]
                     [--id]
                     [--image]
                     [--json-file]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-family]
                     [--os-version]
                     [--parameters]
                     [--policy]
                     [--resize-timeout]
                     [--resource-group]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--template]
                     [--vm-size]

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave de conta Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-licenses

A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço em lote disponíveis. Se for solicitada uma licença que não é suportada, a criação do pool falhará.

--application-package-references

Ao criar um pool, a ID do aplicativo do pacote deve ser totalmente qualificada (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). As alterações nas referências de Pacote afetam todos os novos Nós que ingressam no Pool, mas não afetam os Nós de Computação que já estão no Pool até que sejam reinicializados ou recriados a imagem. Há um máximo de 10 referências de pacote em qualquer Pool.

--auto-scale-formula

Essa propriedade não deve ser especificada se enableAutoScale estiver definido como false. Ele será necessário se enableAutoScale estiver definido como true. A validade da fórmula é verificada antes da criação do Pool. Se a fórmula não for válida, o serviço em lote rejeitará a solicitação com informações detalhadas de erro. Para obter mais informações sobre como especificar essa fórmula, consulte 'Dimensionar automaticamente nós de computação em um pool de lotes do Azure' (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

--certificate-references

Para nós do Windows, o serviço em lote instala os certificados no armazenamento e no local de certificados especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para Certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório base do usuário (por exemplo, /home/{user-name}/certs) e os Certificados são colocados nesse diretório. Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use a extensão do Azure KeyVault.

--disk-encryption-targets

Uma lista separada por espaço de DiskEncryptionTargets. os valores possíveis atuais incluem OsDisk e TemporaryDisk.

--enable-inter-node-communication

Se o Pool permite a comunicação direta entre nós de computação. A habilitação da comunicação entre nós limita o tamanho máximo do Pool devido a restrições de implantação nos Nós de Computação do Pool. Isso pode fazer com que o Pool não atinja o tamanho desejado. O valor padrão é falso.

Valor padrão: False
--id

Obrigatória. O ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hífens e sublinhados, e não pode conter mais de 64 caracteres. O ID preserva maiúsculas de minúsculas e não diferencia maiúsculas de minúsculas (ou seja, você pode não ter dois IDs de Pool em uma Conta que diferem apenas por maiúsculas e minúsculas).

--image

Referência de imagem do sistema operacional. Isso pode ser o formato 'publisher:offer:sku[:version]' ou um ID de imagem ARM totalmente qualificado do formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se o formato 'publisher:offer:sku[:version]', a versão é opcional e, se omitida, a última será usada. Os valores válidos podem ser recuperados via 'az batch pool node-agent-skus list'. Por exemplo: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

O arquivo que contém o pool a ser criado no formato JSON, se esse parâmetro for especificado, todos os outros parâmetros serão ignorados.

--metadata

O serviço Batch não atribui nenhum significado aos metadados; é exclusivamente para o uso de código de usuário.

--node-agent-sku-id

A SKU do agente de nó em lote a ser provisionada em nós de computação no pool. O agente de nó em lote é um programa executado em cada nó do pool e fornece a interface de comando e controle entre o nó e o serviço em lote. Há diferentes implementações do agente do nó, conhecido como SKUs, para diferentes sistemas operacionais. Você deve especificar um SKU do agente de nó que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente de nó suportados juntamente com sua lista de referências de imagem verificadas, consulte a operação 'Listar SKUs de agente de nó com suporte'.

--os-family

A família do SO convidado do Azure a ser instalada nas máquinas virtuais no pool. Os valores possíveis são: 2 - Família OS 2, equivalente ao Windows Server 2008 R2 SP1. 3 - Família OS 3, equivalente ao Windows Server 2012. 4 - Família OS 4, equivalente ao Windows Server 2012 R2. 5 - Família OS 5, equivalente ao Windows Server 2016. Para obter mais informações, consulte Versões do sistema operacional convidado do Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Valores permitidos: 2, 3, 4, 5.

--os-version

O valor padrão é * que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada.

--parameters

Valores de parâmetro para um arquivo de modelo JSON do pool de lotes. Só pode ser usado com --template.

--policy

Tipo de política de posicionamento de nó em pools de lotes. Política de alocação usada pelo Serviço em Lote para provisionar os nós. Se não for especificado, o Batch usará a política regional. Valores permitidos: regional, zonal.

--resize-timeout

Esse tempo limite se aplica apenas ao dimensionamento manual; ele não tem efeito quando enableAutoScale é definido como true. O valor padrão é 15 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta).

--resource-group

O grupo de recursos da conta em lote.

--start-task-command-line

A linha de comando da tarefa iniciar. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux.

--start-task-resource-files

Uma lista de arquivos que o serviço em lote baixará para o nó de computação antes de executar a linha de comando. Referências de recursos separados por espaço no formato filename=httpurl.

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida da tarefa de início (ou seja, sair com o código de saída 0) antes de agendar qualquer tarefa no nó de computação. Se true e a tarefa de início falhar em um nó de computação, o serviço em lote repetirá a tarefa de inicialização até sua contagem máxima de tentativas (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o nó de computação inutilizável e não agendará tarefas para ele. Essa condição pode ser detectada por meio do estado do nó e do detalhe do erro de agendamento. Se false, o serviço em lote não aguardará a conclusão da tarefa de início. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda está em execução; E mesmo se a tarefa Iniciar falhar, novas tarefas continuarão a ser agendadas no nó. O padrão é false. True se o sinalizador estiver presente.

Valor padrão: False
--target-dedicated-nodes

O número desejado de nós de computação dedicados no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale estiver definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

--target-low-priority-nodes

O número desejado de nós de computação de prioridade pontual/baixa no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale estiver definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

--targets

Se omitido, nenhum disco nos nós de computação no pool será criptografado. No pool Linux, apenas "TemporaryDisk" é suportado; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Espaço separado discos de destino a serem criptografados. Os valores podem ser OsDisk ou TemporaryDisk.

--task-slots-per-node

O número de slots de tarefas que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256.

--template

Um arquivo de modelo JSON do pool de lotes. Se esse parâmetro for especificado, todos os outros parâmetros serão ignorados.

--vm-size

Obrigatória. Para obter informações sobre tamanhos disponíveis de máquinas virtuais para Pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Tamanhos para Serviços de Nuvem (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Batch oferece suporte a todos os tamanhos de VM dos Serviços de Nuvem, exceto ExtraSmall, A1V2 e A2V2. Para obter informações sobre tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais (Linux)https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/ () ou Tamanhos para máquinas virtuais (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). O lote dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (séries STANDARD_GS, STANDARD_DS e STANDARD_DSV2).

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool delete

Exclui um Pool da Conta especificada.

Quando você solicita que um Pool seja excluído, ocorrem as seguintes ações: o estado do Pool é definido como exclusão; qualquer operação de redimensionamento em andamento no Pool é interrompida; o serviço Batch começa a redimensionar o Pool para zero Nós de Computação; quaisquer Tarefas em execução em Nós de Computação existentes são encerradas e reenfileiradas (como se uma operação de redimensionamento de Pool tivesse sido solicitada com a opção de refila padrão); finalmente, o Pool é removido do sistema. Como as Tarefas em execução são enfileiradas novamente, o usuário pode executar novamente essas Tarefas atualizando seu Trabalho para direcionar um Pool diferente. As Tarefas podem ser executadas no novo Pool. Se você quiser substituir o comportamento de refila, chame o Pool de redimensionamento explicitamente para reduzir o Pool para o tamanho zero antes de excluir o Pool. Se você chamar uma API Update, Patch ou Delete em um Pool no estado de exclusão, ela falhará com o código de status HTTP 409 com o código de erro PoolBeingDeleted.

az batch pool delete --pool-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--yes]

Parâmetros Exigidos

--pool-id

A ID do Pool a ser excluída.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta de lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se o ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se o ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o horário especificado.

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool list

Lista todos os Pools na Conta especificada.

az batch pool list [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta de lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--expand

Uma cláusula de $expand OData.

--filter

Uma cláusula de $filter OData. Para obter mais informações sobre como construir esse filtro, consulte https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.

--select

Uma cláusula de $select OData.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool reset

Atualize as propriedades de um pool de lotes. As propriedades não especificadas que podem ser atualizadas são redefinidas para seus padrões.

az batch pool reset --pool-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--application-package-references]
                    [--certificate-references]
                    [--json-file]
                    [--metadata]
                    [--start-task-command-line]
                    [--start-task-environment-settings]
                    [--start-task-max-task-retry-count]
                    [--start-task-wait-for-success]

Parâmetros Exigidos

--pool-id

A ID do pool a ser atualizado.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave de conta Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-package-references

Obrigatória. A lista substitui quaisquer referências de pacote de aplicativos existentes no pool. As alterações nas referências do Pacote de Aplicativo afetam todos os novos Nós de Computação que ingressam no Pool, mas não afetam os Nós de Computação que já estão no Pool até que sejam reinicializados ou recriados com imagens. Há um máximo de 10 referências de pacote de aplicativos em qualquer pool específico. Se for omitida ou se você especificar uma coleção vazia, todas as referências de Pacotes de Aplicativo existentes serão removidas do Pool. Um máximo de 10 referências pode ser especificado em um determinado Pool.

--certificate-references

Obrigatória. Esta lista substitui quaisquer referências de Certificado existentes configuradas no Pool. Se você especificar uma coleção vazia, todas as referências de Certificado existentes serão removidas do Pool. Para nós do Windows, o serviço em lote instala os certificados no armazenamento e no local de certificados especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para Certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório base do usuário (por exemplo, /home/{user-name}/certs) e os Certificados são colocados nesse diretório. Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use a extensão do Azure KeyVault.

--json-file

O arquivo que contém a especificação de parâmetro de propriedades de atualização do pool em JSON (formatado para corresponder ao corpo da solicitação da API REST). Se esse parâmetro for especificado, todos os 'Argumentos de parâmetro de propriedades de atualização de pool' serão ignorados.

--metadata

Obrigatória. Essa lista substitui todos os metadados existentes configurados no Pool. Se for omitido, ou se você especificar uma coleção vazia, todos os metadados existentes serão removidos do Pool.

--start-task-command-line

A linha de comando da tarefa iniciar. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux.

--start-task-environment-settings

Uma lista de configurações de variáveis de ambiente para a tarefa de início. Valores separados por espaço no formato 'key=value'.

--start-task-max-task-retry-count

O número máximo de vezes que a tarefa pode ser repetida.

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida da tarefa de início (ou seja, sair com o código de saída 0) antes de agendar qualquer tarefa no nó de computação. True se o sinalizador estiver presente, caso contrário, o padrão será False.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool resize

Redimensione ou pare o redimensionamento de um pool de lotes.

az batch pool resize --pool-id
                     [--abort]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
                     [--resize-timeout]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]

Parâmetros Exigidos

--pool-id

A ID do pool.

Parâmetros Opcionais

--abort

Pare a operação de redimensionamento do pool.

Valor padrão: False
--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave de conta Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Batch. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

A operação será executada somente se o ETag atual do recurso corresponder exatamente ao valor especificado.

--if-modified-since

A operação será executada somente se o recurso tiver sido modificado desde o carimbo de data/hora especificado.

--if-none-match

A operação não será executada somente se o ETag atual do recurso corresponder exatamente ao valor especificado.

--if-unmodified-since

A operação não será executada somente se o recurso tiver sido modificado desde o carimbo de data/hora especificado.

--node-deallocation-option

Quando os nós podem ser removidos do pool, se o tamanho do pool estiver diminuindo.

Valores aceitos: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

O valor padrão é 15 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta).

--target-dedicated-nodes

O número desejado de nós de computação dedicados no pool.

--target-low-priority-nodes

O número desejado de nós de computação de prioridade pontual/baixa no pool.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool set

Atualize as propriedades de um pool de lotes. A atualização de uma propriedade em um subgrupo redefinirá as propriedades não especificadas desse grupo.

az batch pool set --pool-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--application-package-references]
                  [--certificate-references]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--json-file]
                  [--metadata]
                  [--start-task-command-line]
                  [--start-task-environment-settings]
                  [--start-task-max-task-retry-count]
                  [--start-task-resource-files]
                  [--start-task-wait-for-success]
                  [--target-communication {classic, default, simplified}]

Parâmetros Exigidos

--pool-id

A ID do Pool a ser atualizada.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta de lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-package-references

As alterações nas referências de Pacote afetam todos os novos Nós que ingressam no Pool, mas não afetam os Nós de Computação que já estão no Pool até que sejam reinicializados ou recriados a imagem. Se esse elemento estiver presente, ele substituirá todas as referências de pacote existentes. Se você especificar uma coleção vazia, todas as referências de pacote serão removidas do pool. Se omitidas, todas as referências de pacote existentes serão mantidas inalteradas. IDs de aplicativo separados por espaço com versão opcional no formato 'id[#version]'.

--certificate-references

Se esse elemento estiver presente, ele substituirá todas as referências de Certificado existentes configuradas no Pool. Se omitidas, todas as referências de Certificado existentes serão mantidas inalteradas. Para nós do Windows, o serviço em lote instala os certificados no armazenamento e no local de certificados especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para Certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório base do usuário (por exemplo, /home/{user-name}/certs) e os Certificados são colocados nesse diretório. Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use a extensão do Azure KeyVault. Impressões digitais de certificado separadas por espaço.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se o ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se o ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o horário especificado.

--json-file

Um arquivo que contém a especificação do parâmetro de patch do pool em JSON (formatado para corresponder ao respectivo corpo da API REST). Se esse parâmetro for especificado, todos os 'Argumentos do Pool' serão ignorados.

--metadata

Se esse elemento estiver presente, ele substituirá todos os metadados existentes configurados no Pool. Se você especificar uma coleção vazia, todos os metadados serão removidos do Pool. Se omitidos, todos os metadados existentes serão mantidos inalterados. Valores separados por espaço no formato 'key=value'.

--start-task-command-line

Obrigatória. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser tirar proveito de tais recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho da tarefa) ou usar a variável de ambiente fornecida em lote (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-environment-settings

Valores separados por espaço no formato 'key=value'.

--start-task-max-task-retry-count

O número máximo de vezes que a Tarefa pode ser repetida. O serviço em lote tentará novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço em lote tentará a tarefa uma vez e, em seguida, poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Lote tentará a Tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço de lote não repetirá a tarefa. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá a tarefa sem limite, no entanto, isso não é recomendado para uma tarefa inicial ou qualquer tarefa. O valor padrão é 0 (sem novas tentativas).

--start-task-resource-files

Os arquivos listados nesse elemento estão localizados no diretório de trabalho da tarefa. Referências de recursos separados por espaço no formato filename=httpurl.

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida da StartTask (ou seja, sair com o código de saída 0) antes de agendar qualquer tarefa no nó de computação. Se true e StartTask falhar em um nó, o serviço em lote repetirá o StartTask até sua contagem máxima de tentativas (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o Nó inutilizável e não agendará Tarefas para ele. Essa condição pode ser detectada por meio do estado do nó de computação e dos detalhes das informações de falha. Se false, o serviço em lote não aguardará a conclusão do StartTask. Nesse caso, outras Tarefas podem começar a ser executadas no Nó de Computação enquanto a StartTask ainda está em execução; e mesmo se o StartTask falhar, novas Tarefas continuarão a ser agendadas no Nó de Computação. O padrão é true. Especifique 'true' ou 'false' para atualizar a propriedade.

--target-communication

O modo de comunicação de nó desejado para o pool. Se esse elemento estiver presente, ele substituirá o targetNodeCommunicationMode existente configurado no Pool. Se omitidos, todos os metadados existentes serão mantidos inalterados.

Valores aceitos: classic, default, simplified
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az batch pool show

Obtém informações sobre o Pool especificado.

az batch pool show --pool-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--select]

Parâmetros Exigidos

--pool-id

A ID do Pool a ser obtida.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave de conta em lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta de lote. Como alternativa, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--expand

Uma cláusula de $expand OData.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se o ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado.

--if-none-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se o ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente.

--if-unmodified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o horário especificado.

--select

Uma cláusula de $select OData.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.