PoolSpecification interface
Uma interface que representa o PoolSpecification.
Propriedades
| application |
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. |
| application |
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. |
| auto |
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). |
| auto |
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. |
| certificate |
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. |
| cloud |
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'. |
| display |
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. |
| enable |
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. |
| enable |
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. |
| mount |
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. |
| network |
A configuração de rede do Pool. |
| resize |
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). |
| start |
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. |
| target |
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. |
| target |
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. |
| task |
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. |
| task |
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. |
| user |
A lista de contas de usuário a serem criadas em cada Nó de Computação no Pool. |
| virtual |
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). |
| vm |
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