BatchPoolCreateOptions interface

Pacote:

@azure-rest/batch

Parâmetros para criar um Pool de Lotes do Azure.

Propriedades

applicationPackageReferences	A lista de pacotes a serem instalados em cada Nó de Computação no Pool. Ao criar um pool, a ID do aplicativo do pacote deve ser totalmente qualificada (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). As alterações nas referências de pacote afetam todos os novos nós que ingressam no Pool, mas não afetam nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. Há um máximo de 10 referências de pacote em um determinado pool.
autoScaleEvaluationInterval	O intervalo de tempo no qual ajustar automaticamente o tamanho do Pool de acordo com a fórmula de dimensionamento automático. O valor padrão é 15 minutos. O valor mínimo e máximo é de 5 minutos e 168 horas, respectivamente. Se você especificar um valor menor que 5 minutos ou maior que 168 horas, o serviço do Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).
autoScaleFormula	Uma fórmula para o número desejado de Nós de Computação no Pool. Essa propriedade não deverá ser especificada se enableAutoScale for definido como false. Ele será necessário se enableAutoScale estiver definido como true. A fórmula é verificada quanto à validade antes da criação do Pool. Se a fórmula não for válida, o serviço do Lote rejeitará a solicitação com informações detalhadas de erro. Para obter mais informações sobre como especificar essa fórmula, consulte "Dimensionar automaticamente nós de computação em um pool de lote do Azure" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).
displayName	O nome de exibição do Pool. O nome de exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.
enableAutoScale	Se o tamanho do Pool deve ser ajustado automaticamente ao longo do tempo. Se for falso, pelo menos um dos targetDedicatedNodes e targetLowPriorityNodes deverá ser especificado. Se for true, a propriedade autoScaleFormula será necessária e o Pool será redimensionado automaticamente de acordo com a fórmula. O valor padrão é false.
enableInterNodeCommunication	Se o Pool permite comunicação direta entre nós de computação. Habilitar a comunicação entre nós limita o tamanho máximo do pool devido a restrições de implantação nos nós de computação do pool. Isso pode fazer com que o Pool não atinja o tamanho desejado. O valor padrão é false.
id	Uma cadeia de caracteres que identifica exclusivamente o pool na Conta. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens e sublinhados, e não pode conter mais de 64 caracteres. A ID não diferencia maiúsculas de minúsculas e maiúsculas de minúsculas (ou seja, você pode não ter duas IDs de pool em uma conta que diferem apenas por caso).
metadata	Uma lista de pares nome-valor associados ao Pool como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.
mountConfiguration	Monte o armazenamento usando o sistema de arquivos especificado durante todo o tempo de vida do pool. Monte o armazenamento usando o compartilhamento de arquivos do Azure, NFS, CIFS ou sistema de arquivos baseado em Blobfuse.
networkConfiguration	A configuração de rede do Pool.
resizeTimeout	O tempo limite para alocação de nós de computação para o pool. Esse tempo limite se aplica apenas ao dimensionamento manual; ele não tem efeito quando enableAutoScale é definido como true. O valor padrão é 15 minutos. O valor mínimo é 5 minutos. Se você especificar um valor menor que 5 minutos, o serviço do Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).
startTask	Uma tarefa especificada para ser executada em cada Nó de Computação à medida que ele ingressa no pool. A Tarefa é executada quando o Nó de Computação é adicionado ao Pool ou quando o Nó de Computação é reiniciado.
targetDedicatedNodes	O número desejado de nós de computação dedicados no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale for definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.
targetLowPriorityNodes	O número desejado de nós de computação spot/de baixa prioridade no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale for definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.
taskSchedulingPolicy	Como as tarefas são distribuídas entre nós de computação em um pool. Se não for especificado, o padrão será distribuído.
taskSlotsPerNode	O número de slots de tarefas que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256.
upgradePolicy	A política de atualização do Pool. Descreve uma política de atualização – automática, manual ou sem interrupção.
userAccounts	A lista de contas de usuário a serem criadas em cada Nó de Computação no Pool.
virtualMachineConfiguration	A configuração da máquina virtual para o Pool. Essa propriedade deve ser especificada.
vmSize	O tamanho das máquinas virtuais no Pool. Todas as máquinas virtuais em um Pool têm o mesmo tamanho. Para obter informações sobre os tamanhos de VM disponíveis para pools usando imagens do Marketplace de Máquinas Virtuais (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais no Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). O Lote dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (séries STANDARD_GS, STANDARD_DS e STANDARD_DSV2).

Detalhes da propriedade

applicationPackageReferences

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

applicationPackageReferences?: BatchApplicationPackageReference[]

Valor da propriedade

BatchApplicationPackageReference[]

autoScaleEvaluationInterval

O intervalo de tempo no qual ajustar automaticamente o tamanho do Pool de acordo com a fórmula de dimensionamento automático. O valor padrão é 15 minutos. O valor mínimo e máximo é de 5 minutos e 168 horas, respectivamente. Se você especificar um valor menor que 5 minutos ou maior que 168 horas, o serviço do Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).

autoScaleEvaluationInterval?: string

Valor da propriedade

string

autoScaleFormula

Uma fórmula para o número desejado de Nós de Computação no Pool. Essa propriedade não deverá ser especificada se enableAutoScale for definido como false. Ele será necessário se enableAutoScale estiver definido como true. A fórmula é verificada quanto à validade antes da criação do Pool. Se a fórmula não for válida, o serviço do Lote rejeitará a solicitação com informações detalhadas de erro. Para obter mais informações sobre como especificar essa fórmula, consulte "Dimensionar automaticamente nós de computação em um pool de lote do Azure" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

autoScaleFormula?: string

Valor da propriedade

string

displayName

O nome de exibição do Pool. O nome de exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.

displayName?: string

Valor da propriedade

string

enableAutoScale

Se o tamanho do Pool deve ser ajustado automaticamente ao longo do tempo. Se for falso, pelo menos um dos targetDedicatedNodes e targetLowPriorityNodes deverá ser especificado. Se for true, a propriedade autoScaleFormula será necessária e o Pool será redimensionado automaticamente de acordo com a fórmula. O valor padrão é false.

enableAutoScale?: boolean

Valor da propriedade

boolean

enableInterNodeCommunication

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

enableInterNodeCommunication?: boolean

Valor da propriedade

boolean

id

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

id: string

Valor da propriedade

string

metadata

Uma lista de pares nome-valor associados ao Pool como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.

metadata?: BatchMetadataItem[]

Valor da propriedade

BatchMetadataItem[]

mountConfiguration

Monte o armazenamento usando o sistema de arquivos especificado durante todo o tempo de vida do pool. Monte o armazenamento usando o compartilhamento de arquivos do Azure, NFS, CIFS ou sistema de arquivos baseado em Blobfuse.

mountConfiguration?: MountConfiguration[]

Valor da propriedade

MountConfiguration[]

networkConfiguration

A configuração de rede do Pool.

networkConfiguration?: NetworkConfiguration

Valor da propriedade

NetworkConfiguration

resizeTimeout

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

resizeTimeout?: string

Valor da propriedade

string

startTask

Uma tarefa especificada para ser executada em cada Nó de Computação à medida que ele ingressa no pool. A Tarefa é executada quando o Nó de Computação é adicionado ao Pool ou quando o Nó de Computação é reiniciado.

startTask?: BatchStartTask

Valor da propriedade

BatchStartTask

targetDedicatedNodes

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

targetDedicatedNodes?: number

Valor da propriedade

number

targetLowPriorityNodes

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

targetLowPriorityNodes?: number

Valor da propriedade

number

taskSchedulingPolicy

Como as tarefas são distribuídas entre nós de computação em um pool. Se não for especificado, o padrão será distribuído.

taskSchedulingPolicy?: BatchTaskSchedulingPolicy

Valor da propriedade

BatchTaskSchedulingPolicy

taskSlotsPerNode

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

taskSlotsPerNode?: number

Valor da propriedade

number

upgradePolicy

A política de atualização do Pool. Descreve uma política de atualização – automática, manual ou sem interrupção.

upgradePolicy?: UpgradePolicy

Valor da propriedade

UpgradePolicy

userAccounts

A lista de contas de usuário a serem criadas em cada Nó de Computação no Pool.

userAccounts?: UserAccount[]

Valor da propriedade

UserAccount[]

virtualMachineConfiguration

A configuração da máquina virtual para o Pool. Essa propriedade deve ser especificada.

virtualMachineConfiguration?: VirtualMachineConfiguration

Valor da propriedade

VirtualMachineConfiguration

vmSize

O tamanho das máquinas virtuais no Pool. Todas as máquinas virtuais em um Pool têm o mesmo tamanho. Para obter informações sobre os tamanhos de VM disponíveis para pools usando imagens do Marketplace de Máquinas Virtuais (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais no Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). O Lote dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (séries STANDARD_GS, STANDARD_DS e STANDARD_DSV2).

vmSize: string

Valor da propriedade

string