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 | Estado |
|---|---|---|---|
| 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]
[--disk-encryption-targets]
[--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]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--os-family {2, 3, 4, 5, 6}]
[--os-version]
[--placement {cachedisk}]
[--policy {regional, zonal}]
[--resize-timeout]
[--resource-tags]
[--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]
[--vm-size]Parâmetros Opcionais
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://learn.microsoft.com/azure/virtual- network/accelerated-networking-overview. Defina true para habilitar.
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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]'.
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/.
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.
Uma lista separada por espaço de DiskEncryptionTargets. os valores possíveis atuais incluem OsDisk e TemporaryDisk.
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.
Habilite a inicialização segura.
Habilite o vTPM.
Especifique se writeAccelerator deve ser ativado ou desativado no disco.
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.
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).
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'.
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.
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'.
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'.
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.
O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional.
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).
O valor padrão é *, que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada.
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.
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.
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.
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.
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.
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).
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.
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.
O tipo de conta de armazenamento para disco gerenciado.
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.
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.
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.
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.
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.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
A chave da conta Batch. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
O nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
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á.
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.
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/).
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.
Uma lista separada por espaço de DiskEncryptionTargets. os valores possíveis atuais incluem OsDisk e TemporaryDisk.
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.
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).
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'.
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.
O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário.
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'.
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.
O valor padrão é *, que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada.
Valores de parâmetro para um arquivo de modelo JSON do pool de lotes. Só pode ser usado com --template.
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.
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 grupo de recursos da conta Lote.
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.
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.
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.
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.
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.
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.
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.
Um arquivo de modelo JSON do pool de lotes. Se esse parâmetro for especificado, todos os outros parâmetros serão ignorados.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
A ID do Pool a ser excluído.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Não solicite confirmação.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
Uma cláusula $expand OData.
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.
Uma cláusula OData $select.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
A ID do pool a ser atualizado.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
A chave da conta Batch. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
O nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
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.
Uma lista de configurações de variáveis de ambiente para a tarefa iniciar. Valores separados por espaço no formato 'key=value'.
O número máximo de vezes que a tarefa pode ser repetida.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
A ID do pool.
Parâmetros Opcionais
Pare a operação de redimensionamento do pool.
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
A chave da conta Batch. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
O nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
A operação será executada somente se o ETag atual do recurso corresponder exatamente ao valor especificado.
A operação será executada somente se o recurso tiver sido modificado desde o carimbo de data/hora especificado.
A operação não será executada somente se o ETag atual do recurso corresponder exatamente ao valor especificado.
A operação não será executada somente se o recurso tiver sido modificado desde o carimbo de data/hora especificado.
Quando os nós podem ser removidos do pool, se o tamanho do pool estiver diminuindo.
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 número desejado de nós de computação dedicados no pool.
O número desejado de nós de computação spot/de baixa prioridade no pool.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
A ID do Pool a ser atualizado.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
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]'.
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.
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.
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.
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.
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.
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.
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'.
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).
Valores separados por espaço no formato 'key=value'.
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).
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.
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.
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.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
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
A ID do Pool a ser obtida.
Parâmetros Opcionais
Ponto de extremidade de serviço em lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ENDPOINT.
Chave de conta em lote. Alternativamente, definido por variável de ambiente: AZURE_BATCH_ACCESS_KEY.
Nome da conta do lote. Alternativamente, defina por variável de ambiente: AZURE_BATCH_ACCOUNT.
Uma cláusula $expand OData.
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.
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.
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.
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.
Uma cláusula OData $select.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários