Compartilhar via


az batch pool

Nota

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 do Lote.

Comandos

Nome Description Tipo Status
az batch pool autoscale

Gerenciar o dimensionamento automático de pools do Lote.

Núcleo GA
az batch pool autoscale disable

Desabilita 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 do Lote 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 do Lote 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

Obter contagens de nós para pools do Lote.

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 do Lote. 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 de redimensionar um pool do Lote.

Núcleo GA
az batch pool set

Atualize as propriedades de um pool do Lote. Atualizar 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 compatíveis com o serviço lote do Azure.

Núcleo GA
az batch pool supported-images list

Lista todas as imagens de máquina virtual compatíveis com o serviço lote do Azure.

Núcleo GA
az batch pool usage-metrics

Exibir métricas de uso de pools do Lote.

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 do Lote 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 raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho de 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 do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido 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 do Lote disponíveis. Se uma licença for solicitada sem suporte, 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 nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. Há um máximo de 10 referências de pacote em um determinado pool. IDs de aplicativo separadas 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 da criação do pool. Se a fórmula não for válida, o serviço do 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 Lote instala os Certificados no repositório e 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 certificados são colocados nesse diretório. Aviso: essa propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o de 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 elas 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 desabilitado. True se o sinalizador estiver presente.

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

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

--enable-auto-os-upgrade

Indica se as atualizações do sistema operacional devem ser aplicadas automaticamente às instâncias do conjunto de dimensionamento de forma sem interrupção 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 do AZ ao construir lotes de atualização. Leve em consideração o Domínio de Atualização 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 comunicação direta entre nós de computação. Habilitar a 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 é false. True se o sinalizador estiver presente.

--enable-secure-boot

Habilite a inicialização segura.

Valores aceitos: false, true
--enable-vtpm

Habilitar 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 a máquina virtual ou o conjunto de dimensionamento de máquinas virtuais. 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 verdadeira para o recurso.

Valores aceitos: false, true
--id

Necessário. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens e sublinhados, e não pode conter mais de 64 caracteres. A ID não diferencia maiúsculas de minúsculas e maiúsculas de minúsculas (ou seja, você pode não ter duas IDs de pool em uma conta que diferem apenas por caso).

--image

Referência de imagem do sistema operacional. Pode ser o formato 'publisher:offer:sku[:version]' ou uma ID de imagem arm totalmente qualificada do formulário '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se o formato 'publisher:offer:sku[:version]' for opcional e se omitido mais recente será usado. Os valores válidos podem ser recuperados por meio de 'az batch pool supported-images list'. Por exemplo: 'MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest'.

--json-file

O arquivo que contém a especificação de parâmetro de criação de propriedades 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 criar propriedades do pool" serão ignorados. Consulte https://learn.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 isso é um máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que o percentual 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

O percentual máximo do total de instâncias de máquina virtual no conjunto de dimensionamento que pode ser simultaneamente não íntegro, seja como resultado da atualização ou por ser encontrado em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização sem interrupção seja anulada. 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

O percentual máximo de instâncias de máquina virtual atualizadas que podem ser encontradas em um estado não íntegro. Essa verificação ocorrerá depois que cada lote for atualizado. Se esse percentual for excedido, a atualização sem interrupção será anulada. O valor desse campo deve estar entre 0 e 100, inclusive.

--metadata

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

--node-agent-sku-id

Necessário. O agente do 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 do Lote. Há diferentes implementações do agente do Nó de Computação, conhecido como SKUs, para sistemas operacionais diferentes. 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 do Nó de Computação com suporte, juntamente com sua lista de referências de imagem verificadas, consulte a operação "Listar SKUs de agente de nó de computação com suporte".

--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 Standard. 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

Necessário. Os valores possíveis são: 2 – Família do sistema operacional 2, equivalente ao Windows Server 2008 R2 SP1. 3 – Família do sistema operacional 3, equivalente ao Windows Server 2012. 4 – Família do sistema operacional 4, equivalente ao Windows Server 2012 R2. 5 – Família do sistema operacional 5, equivalente ao Windows Server 2016. 6 – Família do sistema operacional 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 so especificada.

--pause-time-between-batches

O tempo de espera entre concluir a atualização de todas as máquinas virtuais em um lote e iniciar o 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, armazenar espaço em disco em cache para provisionamento de disco do sistema operacional efêmero. Para obter mais informações sobre os requisitos de tamanho do disco do sistema operacional efêmero, consulte os requisitos de tamanho de disco do sistema operacional efêmero para VMs windows em VMs https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e 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 lote. Política de alocação usada pelo Serviço de Lote para provisionar os nós. Se não for especificado, o Lote usará a política regional.

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

Atualize todas as instâncias não íntegras em um conjunto de dimensionamento 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 é 5 minutos. Se você especificar um valor menor que 5 minutos, o serviço do 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 Sem Interrupção 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 esteja definida.

--start-task-command-line

Necessário. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque 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 pelo Lote (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Os arquivos listados sob esse elemento estão localizados no diretório de trabalho da Tarefa. Referências de recurso separadas por espaço no formato filename=httpurl.

--start-task-wait-for-success

Se o serviço do Lote deve aguardar a conclusão do StartTask com êxito (ou seja, sair com o código de saída 0) antes de agendar tarefas no Nó de Computação. Se true e o StartTask falharem em um nó, o serviço do Lote tentará novamente o StartTask até sua contagem máxima de repetição (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as novas tentativas, o serviço do Lote marcará o nó inutilizável e não agendará Tarefas para ela. Essa condição pode ser detectada por meio do estado do Nó de Computação e dos detalhes das informações de falha. Se for falso, o serviço do 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 o StartTask ainda estiver em execução; e mesmo que o StartTask falhe, novas tarefas continuarão a ser agendadas no Nó de Computação. O padrão é verdadeiro. True se o sinalizador estiver presente.

--storage-account-type

O tipo de conta de armazenamento do 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 omitido, todos os metadados existentes ficarão 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 for definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

--target-low-priority-nodes

O número desejado de nós de computação spot/de baixa prioridade no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale for 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 do Linux, há suporte apenas para "TemporaryDisk"; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Discos de destino semperados de espaço a serem criptografados. Os valores podem ser OsDisk ou TemporaryDisk.

--task-slots-per-node

O número de slots de tarefa 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 sem interrupção deve ser usada durante a Atualização automática do sistema operacional. A atualização automática do sistema operacional 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

Necessário. Para obter informações sobre tamanhos disponíveis de máquinas virtuais para Pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Sizes for Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Lote dá suporte a todos os tamanhos de VM dos Serviços de Nuvem, exceto ExtraSmall, A1V2 e A2V2. Para obter informações sobre os tamanhos de VM disponíveis para pools usando imagens do Marketplace de Máquinas Virtuais (pools criados com virtualMachineConfiguration) consulte Sizes for Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Sizes for Virtual Machines (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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

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

Crie um pool do Lote 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 do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave da conta do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do Lote. Como alternativa, definido 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 do Lote disponíveis. Se uma licença for solicitada sem suporte, 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 nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. Há um máximo de 10 referências de pacote em um determinado pool.

--auto-scale-formula

Essa propriedade não deverá ser especificada se enableAutoScale for definido como false. Ele será necessário se enableAutoScale estiver definido como true. A fórmula é verificada quanto à validade antes da criação do Pool. Se a fórmula não for válida, o serviço do 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 lote do Azure" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

--certificate-references

Para nós do Windows, o serviço Lote instala os Certificados no repositório e 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 certificados são colocados nesse diretório. Aviso: essa propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o de Extensão do Azure KeyVault .

--disk-encryption-targets

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

--enable-inter-node-communication

Se o Pool permite comunicação direta entre nós de computação. Habilitar a 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 é false.

Valor padrão: False
--id

Necessário. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens e sublinhados, e não pode conter mais de 64 caracteres. A ID não diferencia maiúsculas de minúsculas e maiúsculas de minúsculas (ou seja, você pode não ter duas IDs de pool em uma conta que diferem apenas por caso).

--image

Referência de imagem do sistema operacional. Pode ser o formato 'publisher:offer:sku[:version]' ou uma ID de imagem arm totalmente qualificada do formulário '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se o formato 'publisher:offer:sku[:version]' for opcional e se omitido mais recente será usado. Os valores válidos podem ser recuperados por meio de '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 do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.

--node-agent-sku-id

A SKU do agente de nó do Lote a ser provisionada em nós de computação no pool. O agente de nó do Lote é um programa que é executado em cada nó no pool e fornece a interface de comando e controle entre o nó e o serviço do Lote. Há diferentes implementações do agente do nó, conhecido como SKUs, para sistemas operacionais diferentes. Você deve especificar um SKU do agente do nó que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente de nó com suporte junto 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 sistema operacional convidado do Azure a ser instalada nas máquinas virtuais no pool. Os valores possíveis são: 2 – Família do sistema operacional 2, equivalente ao Windows Server 2008 R2 SP1. 3 – Família do sistema operacional 3, equivalente ao Windows Server 2012. 4 – Família do sistema operacional 4, equivalente ao Windows Server 2012 R2. 5 – Família do sistema operacional 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 so especificada.

--parameters

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

--policy

Tipo de política de posicionamento de nó em pools de lote. Política de alocação usada pelo Serviço de Lote para provisionar os nós. Se não for especificado, o Lote 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 é 5 minutos. Se você especificar um valor menor que 5 minutos, o serviço do 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 do Lote.

--start-task-command-line

A linha de comando da tarefa inicial. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque 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 do Lote baixará no nó de computação antes de executar a linha de comando. Referências de recurso separadas por espaço no formato filename=httpurl.

--start-task-wait-for-success

Se o serviço do Lote deve aguardar a conclusão da tarefa inicial com êxito (ou seja, sair com o código de saída 0) antes de agendar as tarefas no nó de computação. Se true e a tarefa inicial falharem em um nó de computação, o serviço do Lote repetirá a tarefa inicial até sua contagem máxima de repetição (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as novas tentativas, o serviço do Lote marcará o nó de computação inutilizável e não agendará tarefas para ela. Essa condição pode ser detectada por meio do estado do nó e dos detalhes do erro de agendamento. Se for falso, o serviço do Lote não aguardará a conclusão da tarefa inicial. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda estiver em execução; e mesmo que a tarefa inicial falhe, 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 for definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

--target-low-priority-nodes

O número desejado de nós de computação spot/de baixa prioridade no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale for 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 do Linux, há suporte apenas para "TemporaryDisk"; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Discos de destino semperados de espaço a serem criptografados. Os valores podem ser OsDisk ou TemporaryDisk.

--task-slots-per-node

O número de slots de tarefa 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 do Lote. Se esse parâmetro for especificado, todos os outros parâmetros serão ignorados.

--vm-size

Necessário. Para obter informações sobre tamanhos disponíveis de máquinas virtuais para Pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Sizes for Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Lote dá suporte a todos os tamanhos de VM dos Serviços de Nuvem, exceto ExtraSmall, A1V2 e A2V2. Para obter informações sobre os tamanhos de VM disponíveis para pools usando imagens do Marketplace de Máquinas Virtuais (pools criados com virtualMachineConfiguration) consulte Sizes for Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Sizes for Virtual Machines (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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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, as seguintes ações ocorrem: o estado do pool está definido como exclusão; qualquer operação de redimensionamento em andamento no Pool é interrompida; o serviço do Lote começa a redimensionar o pool para zero Nós de Computação; as tarefas em execução em nós de computação existentes são encerradas e requeadas (como se uma operação de pool de redimensionamento tivesse sido solicitada com a opção de requeue padrão); por fim, o Pool é removido do sistema. Como as tarefas em execução são requeuídas, o usuário pode executar novamente essas Tarefas atualizando seu trabalho para direcionar um pool diferente. Em seguida, as Tarefas podem ser executadas no novo Pool. Se você quiser substituir o comportamento de substituição, chame o pool de redimensionamento explicitamente para reduzir o pool para tamanho zero antes de excluir o Pool. Se você chamar uma API de Atualização, Patch ou Exclusão 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ído.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido 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 a 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 a 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 a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--expand

Uma cláusula $expand OData.

--filter

Uma cláusula $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 $select OData.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az batch pool reset

Atualize as propriedades de um pool do Lote. 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 do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave da conta do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--application-package-references

Necessário. A lista substitui todas as referências existentes do Pacote de Aplicativos no Pool. As alterações nas referências do Pacote de Aplicativos 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 reinicializados. Há um máximo de 10 referências do Pacote de Aplicativos em qualquer pool específico. Se for omitido ou se você especificar uma coleção vazia, todas as referências de Pacotes de Aplicativos existentes serão removidas do Pool. Um máximo de 10 referências pode ser especificado em um determinado pool.

--certificate-references

Necessário. Essa lista substitui todas as 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 Lote instala os Certificados no repositório e 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 certificados são colocados nesse diretório. Aviso: essa propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o de Extensão do Azure KeyVault .

--json-file

O arquivo que contém a especificação do 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 do pool" serão ignorados.

--metadata

Necessário. 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 inicial. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque 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ável de ambiente para a tarefa inicial. 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 do Lote deve aguardar a conclusão da tarefa inicial com êxito (ou seja, sair com o código de saída 0) antes de agendar as tarefas no nó de computação. True se o sinalizador estiver presente, caso contrário, o padrão será False.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az batch pool resize

Redimensione ou pare de redimensionar um pool do Lote.

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

Interrompa a operação de redimensionamento do pool.

Valor padrão: False
--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

A chave da conta do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--if-match

A operação será executada somente se a 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 a 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 é 5 minutos. Se você especificar um valor menor que 5 minutos, o serviço do 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 spot/de baixa prioridade no pool.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

az batch pool set

Atualize as propriedades de um pool do Lote. Atualizar 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 do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Como alternativa, definido 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 nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. 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 omitida, todas as referências existentes do Pacote serão deixadas inalteradas. IDs de aplicativo separadas 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 deixadas inalteradas. Para nós do Windows, o serviço Lote instala os Certificados no repositório e 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 certificados são colocados nesse diretório. Aviso: essa propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o de 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 a 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 a 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 omitido, todos os metadados existentes ficarão inalterados. Valores separados por espaço no formato 'key=value'.

--start-task-command-line

Necessário. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque 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 pelo 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 do Lote tentará novamente uma Tarefa se o código de saída não for zero. Observe que esse valor controla especificamente o número de repetições. O serviço lote tentará a Tarefa uma vez e poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetição for 3, o Lote tentará a Tarefa até 4 vezes (uma tentativa inicial e três tentativas). Se a contagem máxima de repetição for 0, o serviço do Lote não tentará novamente a Tarefa. Se a contagem máxima de repetição for -1, o serviço do 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 sob esse elemento estão localizados no diretório de trabalho da Tarefa. Referências de recurso separadas por espaço no formato filename=httpurl.

--start-task-wait-for-success

Se o serviço do Lote deve aguardar a conclusão do StartTask com êxito (ou seja, sair com o código de saída 0) antes de agendar tarefas no Nó de Computação. Se true e o StartTask falharem em um nó, o serviço do Lote tentará novamente o StartTask até sua contagem máxima de repetição (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as novas tentativas, o serviço do Lote marcará o nó inutilizável e não agendará Tarefas para ela. Essa condição pode ser detectada por meio do estado do Nó de Computação e dos detalhes das informações de falha. Se for falso, o serviço do 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 o StartTask ainda estiver em execução; e mesmo que o StartTask falhe, novas tarefas continuarão a ser agendadas no Nó de Computação. O padrão é verdadeiro. 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 omitido, todos os metadados existentes ficarão inalterados.

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

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em 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 obtido.

Parâmetros Opcionais

--account-endpoint

Ponto de extremidade de serviço do Lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ENDPOINT.

--account-key

Chave da conta do lote. Como alternativa, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

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

--expand

Uma cláusula $expand OData.

--if-match

Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a 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 a 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 $select OData.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar 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 a verbosidade do registro em log. Use --debug para logs de depuração completos.