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 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.
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 são de 5 minutos e 168 horas, respectivamente. Se você especificar um valor inferior a 5 minutos ou superior a 168 horas, o serviço em 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 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://learn.microsoft.com/azure/batch/batch-automatic-scaling).
displayName	O nome para exibição do Pool. O nome para 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 false, pelo menos um dos targetDedicatedNodes e targetLowPriorityNodes deve ser especificado. Se true, a propriedade autoScaleFormula é necessária e o Pool é redimensionado automaticamente de acordo com a fórmula. O valor predefinido é false.
enableInterNodeCommunication	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.
id	Uma cadeia de caracteres que identifica exclusivamente o Pool dentro da Conta. 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).
metadata	Uma lista de pares nome-valor associados ao Pool como metadados. O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário.
mountConfiguration	Monte o armazenamento usando o sistema de arquivos especificado durante toda a vida útil do pool. Monte o armazenamento usando o sistema de arquivos baseado em compartilhamento de arquivos, NFS, CIFS ou Blobfuse do Azure.
networkConfiguration	A configuração de rede para o Pool.
resizeTimeout	O tempo limite para alocação de nós de computação para o pool. 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).
startTask	Uma Tarefa especificada para ser executada em cada Nó de Computação à medida que se junta ao 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 estiver 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 estiver 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á spread.
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 para o Pool. Descreve uma política de atualização - automática, manual ou rolante.
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. Esta 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 tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais no Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). 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).

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

applicationPackageReferences?: BatchApplicationPackageReference[]

Valor de 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 são de 5 minutos e 168 horas, respectivamente. Se você especificar um valor inferior a 5 minutos ou superior a 168 horas, o serviço em 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 de Propriedade

string

autoScaleFormula

Uma fórmula para o número desejado de nós de computação no 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://learn.microsoft.com/azure/batch/batch-automatic-scaling).

autoScaleFormula?: string

Valor de Propriedade

string

displayName

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

displayName?: string

Valor de Propriedade

string

enableAutoScale

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

enableAutoScale?: boolean

Valor de Propriedade

boolean

enableInterNodeCommunication

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.

enableInterNodeCommunication?: boolean

Valor de Propriedade

boolean

id

Uma cadeia de caracteres que identifica exclusivamente o Pool dentro da Conta. 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).

id: string

Valor de Propriedade

string

metadata

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

metadata?: BatchMetadataItem[]

Valor de Propriedade

BatchMetadataItem[]

mountConfiguration

Monte o armazenamento usando o sistema de arquivos especificado durante toda a vida útil do pool. Monte o armazenamento usando o sistema de arquivos baseado em compartilhamento de arquivos, NFS, CIFS ou Blobfuse do Azure.

mountConfiguration?: MountConfiguration[]

Valor de Propriedade

MountConfiguration[]

networkConfiguration

A configuração de rede para o Pool.

networkConfiguration?: NetworkConfiguration

Valor de Propriedade

NetworkConfiguration

resizeTimeout

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

resizeTimeout?: string

Valor de Propriedade

string

startTask

Uma Tarefa especificada para ser executada em cada Nó de Computação à medida que se junta ao Pool. A Tarefa é executada quando o Nó de Computação é adicionado ao Pool ou quando o Nó de Computação é reiniciado.

startTask?: BatchStartTask

Valor de 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 estiver definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes, ou ambos.

targetDedicatedNodes?: number

Valor de 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 estiver definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes, ou ambos.

targetLowPriorityNodes?: number

Valor de 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á spread.

taskSchedulingPolicy?: BatchTaskSchedulingPolicy

Valor de 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 de Propriedade

number

upgradePolicy

A política de atualização para o Pool. Descreve uma política de atualização - automática, manual ou rolante.

upgradePolicy?: UpgradePolicy

Valor de Propriedade

UpgradePolicy

userAccounts

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

userAccounts?: UserAccount[]

Valor de Propriedade

UserAccount[]

virtualMachineConfiguration

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

virtualMachineConfiguration?: VirtualMachineConfiguration

Valor de 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 tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais no Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). 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).

vmSize: string

Valor de Propriedade

string