az batch pool

Nota

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

Gerencie pools de lotes.

Comandos

Name Description Tipo Status
az batch pool autoscale

Gerencie o dimensionamento automático de pools de lotes.

Principal GA
az batch pool autoscale disable

Desabilita o dimensionamento automático para um pool.

Principal GA
az batch pool autoscale enable

Permite o dimensionamento automático para um pool.

Principal GA
az batch pool autoscale evaluate

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

Principal GA
az batch pool create

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

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

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

Extensão GA
az batch pool delete

Exclui um Pool da Conta especificada.

Principal GA
az batch pool list

Lista todos os Pools na Conta especificada.

Principal GA
az batch pool node-counts

Obtenha contagens de nós para pools de lotes.

Principal GA
az batch pool node-counts list

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

Principal GA
az batch pool reset

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

Principal GA
az batch pool resize

Redimensione ou pare de redimensionar um pool de lotes.

Principal GA
az batch pool set

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

Principal GA
az batch pool show

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

Principal GA
az batch pool supported-images

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

Principal GA
az batch pool supported-images list

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

Principal GA
az batch pool usage-metrics

Visualize métricas de uso de pools de lotes.

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

Principal GA

az batch pool create

Crie um pool de lotes em uma conta. Ao criar um pool, escolha argumentos em Configuração de Serviços de Nuvem ou Configuração de 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 permitir a rede acelerada. A rede acelerada permite a virtualização de E/S de raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho de rede. Para obter mais detalhes, consulte: https://video2.skills-academy.com/azure/virtual- network/accelerated-networking-overview. Defina true para habilitar.

Valores aceites: false, true
--account-endpoint

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

--account-key

Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-licenses

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

--application-package-references

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

--auto-scale-formula

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

--certificate-references

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

--defer-os-rolling-upgrade

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

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

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

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

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

--enable-auto-os-upgrade

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

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

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

Permita que o VMSS ignore os limites 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. Este campo pode ser definido como true ou false somente ao usar NodePlacementConfiguration como Zonal. True se a bandeira estiver presente.

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

Se o Pool permite a 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. Isto pode fazer com que a Piscina não atinja o tamanho desejado. O valor predefinido é false. True se a bandeira estiver presente.

--enable-secure-boot

Habilite a inicialização segura.

Valores aceites: false, true
--enable-vtpm

Habilite o vTPM.

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

Especifique se writeAccelerator deve ser ativado ou desativado no disco.

Valores aceites: 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áquina virtual. Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. O comportamento padrão é: A criptografia no host será desabilitada, a menos que essa propriedade seja definida como true para o recurso.

Valores aceites: false, true
--id

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

--image

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

--json-file

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

--max-batch-instance-percent

A porcentagem máxima do total de instâncias de máquina virtual que serão atualizadas simultaneamente pela atualização sem interrupção em um lote. Como isso é máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que a porcentagem de instâncias em um lote diminua para garantir maior confiabilidade. O valor deste 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 superior a maxUnhealthyInstancePercent.

--max-unhealthy-instance-percent

A porcentagem máxima do total de instâncias de máquina virtual no conjunto de escala que pode estar simultaneamente não íntegra, seja como resultado de ser atualizada ou por ser encontrada em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização contínua seja abortada. Esta restrição será verificada antes de iniciar qualquer lote. O valor deste 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 superior a maxUnhealthyInstancePercent.

--max-unhealthy-upgraded-instance-percent

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

--metadata

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

--node-agent-sku-id

Obrigatório. O agente Batch Compute Node é um programa que é 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 Batch. Existem diferentes implementações do agente Compute Node, conhecido como SKUs, para diferentes sistemas operacionais. Você deve especificar uma SKU do agente do Nó de Computação que corresponda à referência de Imagem selecionada. Para obter a lista de SKUs de agente de nó de computação suportados, juntamente com sua lista de referências de imagem verificadas, consulte a operação 'Listar SKUs de agente de nó de computação suportados'.

--os-disk-caching

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

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

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

--os-family

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

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

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

--pause-time-between-batches

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

--placement

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

Valores aceites: cachedisk
--policy

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

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

Atualize todas as instâncias não íntegras em um conjunto de escala antes de quaisquer instâncias íntegras. True se a bandeira estiver presente.

Valores aceites: false, true
--resize-timeout

Este tempo limite aplica-se apenas ao dimensionamento manual; ele não tem efeito quando enableAutoScale é definido como true. O valor padrão é 15 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço de 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 tags de recursos para o pool. Qualquer recurso criado para o pool também será marcado pelas mesmas tags de recurso.

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

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

Valores aceites: 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

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

--start-task-resource-files

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

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida do StartTask (ou seja, sair com o código de saída 0) antes de agendar quaisquer tarefas no nó de computação. Se true e o StartTask falhar em um nó, o serviço Batch tentará novamente o StartTask até sua contagem máxima de tentativas (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço Lote marcará o Nó como inutilizável e não agendará Tarefas para ele. Esta condição pode ser detetada através do estado do nó de computação e detalhes de informações de falha. Se false, o serviço Batch 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 está em execução; e mesmo que o StartTask falhe, novas tarefas continuarão a ser agendadas no nó de computação. O padrão é true. True se a bandeira estiver presente.

--storage-account-type

O tipo de conta de armazenamento para disco gerenciado.

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

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

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

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

--target-low-priority-nodes

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

--targets

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

--task-slots-per-node

O número de slots de tarefas que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. O valor predefinido é 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 aceites: automatic, manual, rolling
--use-rolling-upgrade-policy

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

Valores aceites: false, true
--vm-size

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

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

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

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

A chave da conta Batch. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-licenses

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

--application-package-references

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

--auto-scale-formula

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

--certificate-references

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

--disk-encryption-targets

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

--enable-inter-node-communication

Se o Pool permite a comunicação direta entre nós de computação. 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. Isto pode fazer com que a Piscina não atinja o tamanho desejado. O valor predefinido é false.

Default value: False
--id

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

--image

Referência de imagem do SO. Pode ser o formato 'publisher:offer:sku[:version]' ou um ID de imagem ARM totalmente qualificado do formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}'. Se o formato 'publisher:offer:sku[:version]', a versão é opcional e, se omitida, a mais recente será usada. Os valores válidos podem ser recuperados através 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 Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário.

--node-agent-sku-id

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

--os-family

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

--os-version

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

--parameters

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

--policy

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

--resize-timeout

Este tempo limite aplica-se apenas ao dimensionamento manual; ele não tem efeito quando enableAutoScale é definido como true. O valor padrão é 15 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço de 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 Lote.

--start-task-command-line

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

--start-task-resource-files

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

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida da tarefa de início (ou seja, sair com o código de saída 0) antes de agendar quaisquer tarefas no nó de computação. Se true e a tarefa inicial falhar em um nó de computação, o serviço Batch tentará novamente a tarefa inicial até sua contagem máxima de tentativas (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o nó de computação como inutilizável e não agendará tarefas para ele. Esta condição pode ser detetada através do estado do nó e detalhes do erro de agendamento. Se false, o serviço Batch 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 está em execução; E mesmo que a tarefa Iniciar falhe, novas tarefas continuarão a ser agendadas no nó. O padrão é false. True se a bandeira estiver presente.

Default value: False
--target-dedicated-nodes

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

--target-low-priority-nodes

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

--targets

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

--task-slots-per-node

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

--template

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

--vm-size

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 é definido como exclusão; qualquer operação de redimensionamento em curso no Pool é interrompida; o serviço de lote começa a redimensionar o pool para zero nós de computação; todas as tarefas em execução em nós de computação existentes são encerradas e colocadas novamente na fila (como se uma operação de pool de redimensionamento tivesse sido solicitada com a opção de refila padrão); finalmente, o Pool é removido do sistema. Como as Tarefas em execução são enfileiradas novamente, o usuário pode executar novamente essas Tarefas atualizando seu Trabalho para direcionar um Pool diferente. As Tarefas podem ser executadas no novo Pool. Se quiser substituir o comportamento de refila de reenfileiramento, chame o Pool de redimensionamento explicitamente para reduzir o Pool para o tamanho zero antes de excluí-lo. 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 Obrigatórios

--pool-id

A ID do Pool a ser excluído.

Parâmetros Opcionais

--account-endpoint

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

--account-key

Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

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

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o tempo 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 tempo especificado.

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batch pool list

Lista todos os Pools na Conta especificada.

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

Parâmetros Opcionais

--account-endpoint

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

--account-key

Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina 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 OData $select.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batch pool reset

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

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

Parâmetros Obrigatórios

--pool-id

A ID do pool a ser atualizado.

Parâmetros Opcionais

--account-endpoint

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

--account-key

A chave da conta Batch. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-package-references

Obrigatório. A lista substitui todas as referências existentes do Pacote de Aplicativos no Pool. As alterações nas referências do Pacote de Aplicativo afetam todos os novos Nós de Computação que ingressam no Pool, mas não afetam os Nós de Computação que já estão no Pool até que sejam reinicializados ou recriados com imagem. Há um máximo de 10 referências de Pacote de Aplicativos em qualquer Pool. Se omitida 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 podem ser especificadas em um determinado Pool.

--certificate-references

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

--json-file

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

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

--start-task-command-line

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

--start-task-environment-settings

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

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

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

--start-task-wait-for-success

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batch pool resize

Redimensione ou pare de redimensionar um pool de lotes.

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

Parâmetros Obrigatórios

--pool-id

A ID do pool.

Parâmetros Opcionais

--abort

Pare a operação de redimensionamento do pool.

Default value: False
--account-endpoint

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

--account-key

A chave da conta Batch. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

O nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--if-match

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

--if-modified-since

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

--if-none-match

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

--if-unmodified-since

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

--node-deallocation-option

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

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

O valor padrão é 15 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço de 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 de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az batch pool set

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

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

Parâmetros Obrigatórios

--pool-id

A ID do Pool a ser atualizado.

Parâmetros Opcionais

--account-endpoint

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

--account-key

Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.

--application-package-references

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

--certificate-references

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

--if-match

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

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o tempo 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 tempo especificado.

--json-file

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

--metadata

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

--start-task-command-line

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

--start-task-environment-settings

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

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

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

--start-task-resource-files

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

--start-task-wait-for-success

Se o serviço em lote deve aguardar a conclusão bem-sucedida do StartTask (ou seja, sair com o código de saída 0) antes de agendar quaisquer tarefas no nó de computação. Se true e o StartTask falhar em um nó, o serviço Batch tentará novamente o StartTask até sua contagem máxima de tentativas (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço Lote marcará o Nó como inutilizável e não agendará Tarefas para ele. Esta condição pode ser detetada através do estado do nó de computação e detalhes de informações de falha. Se false, o serviço Batch 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 está em execução; e mesmo que o StartTask falhe, novas tarefas continuarão a ser agendadas no nó de computação. O padrão é true. Especifique 'true' ou 'false' para atualizar a propriedade.

--target-communication

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--pool-id

A ID do Pool a ser obtida.

Parâmetros Opcionais

--account-endpoint

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

--account-key

Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.

--account-name

Nome da conta do lote. Alternativamente, defina 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 o ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente.

--if-modified-since

Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o tempo 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 tempo especificado.

--select

Uma cláusula OData $select.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.