Ler em inglês

Compartilhar via


az batch pool

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

CLI do Azure
az batch pool create [--accelerated-networking {false, true}]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--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]
                     [--pause-time-between-batches]
                     [--placement]
                     [--policy]
                     [--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-environment-settings]
                     [--start-task-max-task-retry-count]
                     [--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]
                     [--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-package-references

A lista de pacotes a serem instalados em cada Nó de Computação no Pool. 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}). # pylint: disable=line-too-long Changes to Package references affect all new Nodes joining the Pool, but do not affect Compute Nodes that are already in the Pool until they are rebooted or reimaged. 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. 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/).

--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. :code:<br />:code:<br /> Se isso for definido como true para pools baseados no Windows, WindowsConfiguration.enableAutomaticUpdates <https://learn.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#windowsconfiguration>_ 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

Uma cadeia de caracteres que identifica exclusivamente o pool na Conta. 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). Necessário.

--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/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

Uma lista de pares nome-valor associados ao Pool como metadados. 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

A SKU do agente do Nó de Computação em Lote a ser provisionada em Nós de Computação no Pool. 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". Necessário.

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

--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. "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. Os valores conhecidos são: "regional" e "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

O tempo limite para alocação de nós de computação para o pool. 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

A linha de comando do StartTask. 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). Necessário.

--start-task-environment-settings

Uma lista de configurações de variável de ambiente para o StartTask. 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

Uma lista de arquivos que o serviço do Lote baixará no Nó de Computação antes de executar a linha de comando. Há um tamanho máximo para a lista de arquivos de recurso. Quando o tamanho máximo for excedido, a solicitação falhará e o código de erro de resposta será RequestEntityTooLarge. Se isso ocorrer, a coleção de ResourceFiles deverá ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. 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

A lista de destinos de disco do Serviço de Lote será criptografada no nó de computação. 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.

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

O tamanho das máquinas virtuais no Pool. Todas as máquinas virtuais em um Pool têm o mesmo tamanho. 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 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). Necessário.

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.

CLI do Azure
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 obtido. Necessário.

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

CLI do Azure
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://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

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

CLI do Azure
az batch pool reset --pool-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--application-package-references]
                    [--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 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. Somente necessário 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.

--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 a coleção anempty, todos os metadados existentes serão removidos do ThePool.

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

--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 resize

Redimensione ou pare de redimensionar um pool do Lote.

CLI do Azure
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. Somente necessário 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). Formato de duração ISO-8601.

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

CLI do Azure
az batch pool set --pool-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--application-package-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 obtido. Necessário.

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

Uma lista de pacotes a serem instalados em cada Nó de Computação no Pool. 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]'.

--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 tiver sido modificado desde o horário especificado.

--json-file

Um arquivo que contém a especificação 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

Uma lista de pares nome-valor associados ao Pool como metadados. 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

A linha de comando do StartTask. 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). Necessário.

--start-task-environment-settings

Uma lista de configurações de variável de ambiente para o StartTask. 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

Uma lista de arquivos que o serviço do Lote baixará no Nó de Computação antes de executar a linha de comando. Há um tamanho máximo para a lista de arquivos de recurso. Quando o tamanho máximo for excedido, a solicitação falhará e o código de erro de resposta será RequestEntityTooLarge. Se isso ocorrer, a coleção de ResourceFiles deverá ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. 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.

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

CLI do Azure
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. Necessário.

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