Compartilhar via


PoolSpecification interface

Uma interface que representa o PoolSpecification.

Propriedades

applicationLicenses

A lista de licenças de aplicativo que o serviço do Lote disponibilizará em cada Nó de Computação no Pool. A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço do Lote disponíveis. Se uma licença for solicitada sem suporte, a criação do pool falhará. As licenças permitidas disponíveis no Pool são 'maya', 'vray', '3dsmax', 'arnold'. Um encargo adicional se aplica a cada licença de aplicativo adicionada ao Pool.

applicationPackageReferences

A lista de pacotes a serem instalados em cada Nó de Computação no Pool. As alterações nas referências de pacote afetam todos os novos nós que ingressam no Pool, mas não afetam nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. 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 rejeitará a solicitação com um erro de valor de propriedade inválido; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).

autoScaleFormula

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

certificateReferences

Uma lista de certificados a serem instalados em cada nó de computação no pool. Para nós do Windows, o serviço Lote instala os Certificados no repositório e local de certificados especificados. Para nós de computação do Linux, os Certificados são armazenados em um diretório dentro do diretório de trabalho da 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 certificados são colocados nesse diretório.

cloudServiceConfiguration

A configuração do serviço de nuvem para o Pool. Essa propriedade deve ser especificada se o Pool precisar ser criado com VMs paaS do Azure. Essa propriedade e virtualMachineConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Se nenhum dos dois for especificado, 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). Essa propriedade não poderá ser especificada se a Conta do Lote foi criada com sua propriedade poolAllocationMode definida como 'UserSubscription'.

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 false, pelo menos um dos targetDedicateNodes e targetLowPriorityNodes deverá ser especificado. Se for true, o elemento autoScaleFormula será necessário. O Pool redimensiona 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.

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

Uma lista de sistemas de arquivos a serem montados em cada nó no pool. Isso dá suporte a Arquivos do Azure, NFS, CIFS/SMB e 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 rejeitará a solicitação com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).

startTask

Uma Tarefa a 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 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 tarefa que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256.

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 se o Pool precisar ser criado com VMs IaaS do Azure. Essa propriedade e cloudServiceConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Se nenhum dos dois for especificado, 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).

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 disponíveis de máquinas virtuais em Pools, consulte Escolher um tamanho de VM para nós de computação em um pool de lote do Azure (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

Detalhes da propriedade

applicationLicenses

A lista de licenças de aplicativo que o serviço do Lote disponibilizará em cada Nó de Computação no Pool. A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço do Lote disponíveis. Se uma licença for solicitada sem suporte, a criação do pool falhará. As licenças permitidas disponíveis no Pool são 'maya', 'vray', '3dsmax', 'arnold'. Um encargo adicional se aplica a cada licença de aplicativo adicionada ao Pool.

applicationLicenses?: string[]

Valor da propriedade

string[]

applicationPackageReferences

A lista de pacotes a serem instalados em cada Nó de Computação no Pool. As alterações nas referências de pacote afetam todos os novos nós que ingressam no Pool, mas não afetam nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. Há um máximo de 10 referências de pacote em um determinado pool.

applicationPackageReferences?: ApplicationPackageReference[]

Valor da propriedade

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 rejeitará a solicitação com um erro de valor de propriedade inválido; 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

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

autoScaleFormula?: string

Valor da propriedade

string

certificateReferences

Uma lista de certificados a serem instalados em cada nó de computação no pool. Para nós do Windows, o serviço Lote instala os Certificados no repositório e local de certificados especificados. Para nós de computação do Linux, os Certificados são armazenados em um diretório dentro do diretório de trabalho da 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 certificados são colocados nesse diretório.

certificateReferences?: CertificateReference[]

Valor da propriedade

cloudServiceConfiguration

A configuração do serviço de nuvem para o Pool. Essa propriedade deve ser especificada se o Pool precisar ser criado com VMs paaS do Azure. Essa propriedade e virtualMachineConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Se nenhum dos dois for especificado, 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). Essa propriedade não poderá ser especificada se a Conta do Lote foi criada com sua propriedade poolAllocationMode definida como 'UserSubscription'.

cloudServiceConfiguration?: CloudServiceConfiguration

Valor da propriedade

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 false, pelo menos um dos targetDedicateNodes e targetLowPriorityNodes deverá ser especificado. Se for true, o elemento autoScaleFormula será necessário. O Pool redimensiona 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

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?: MetadataItem[]

Valor da propriedade

mountConfiguration

Uma lista de sistemas de arquivos a serem montados em cada nó no pool. Isso dá suporte a Arquivos do Azure, NFS, CIFS/SMB e Blobfuse.

mountConfiguration?: MountConfiguration[]

Valor da propriedade

networkConfiguration

A configuração de rede do Pool.

networkConfiguration?: NetworkConfiguration

Valor da propriedade

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 rejeitará a solicitação com 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 a 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?: StartTask

Valor da propriedade

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 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?: TaskSchedulingPolicy

Valor da propriedade

taskSlotsPerNode

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

taskSlotsPerNode?: number

Valor da propriedade

number

userAccounts

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

userAccounts?: UserAccount[]

Valor da propriedade

virtualMachineConfiguration

A configuração da máquina virtual para o Pool. Essa propriedade deve ser especificada se o Pool precisar ser criado com VMs IaaS do Azure. Essa propriedade e cloudServiceConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Se nenhum dos dois for especificado, 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).

virtualMachineConfiguration?: VirtualMachineConfiguration

Valor da propriedade

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 disponíveis de máquinas virtuais em Pools, consulte Escolher um tamanho de VM para nós de computação em um pool de lote do Azure (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

vmSize: string

Valor da propriedade

string