CloudPool Classe

Um pool no serviço Lote do Azure.

As variáveis são preenchidas apenas pelo servidor e serão ignoradas ao enviar uma solicitação.

Herança

Model

CloudPool

Construtor

CloudPool(*, id: str = None, display_name: str = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, allocation_state=None, allocation_state_transition_time=None, vm_size: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, resize_errors=None, current_dedicated_nodes: int = None, current_low_priority_nodes: int = None, target_dedicated_nodes: int = None, target_low_priority_nodes: int = None, enable_auto_scale: bool = None, auto_scale_formula: str = None, auto_scale_evaluation_interval=None, auto_scale_run=None, enable_inter_node_communication: bool = None, network_configuration=None, start_task=None, certificate_references=None, application_package_references=None, application_licenses=None, task_slots_per_node: int = None, task_scheduling_policy=None, user_accounts=None, metadata=None, stats=None, mount_configuration=None, identity=None, target_node_communication_mode=None, **kwargs)

Parâmetros

id

str

Obrigatório

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 diferencia maiúsculas de minúsculas (ou seja, você pode não ter duas IDs em uma Conta que diferem apenas por caso).

display_name

str

Obrigatório

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

url

str

Obrigatório

e_tag

str

Obrigatório

Essa é uma cadeia de caracteres opaca. Você pode usá-lo para detectar se o Pool foi alterado entre solicitações. Em particular, você pode passar a ETag ao atualizar um Pool para especificar que suas alterações devem entrar em vigor somente se ninguém mais tiver modificado o Pool enquanto isso.

last_modified

datetime

Obrigatório

Esta é a última vez em que os dados no nível do Pool, como targetDedicatedNodes ou enableAutoscale settings, foram alterados. Ele não leva em conta alterações no nível do nó, como um estado de alteração de nó de computação.

creation_time

datetime

Obrigatório

state

str ou PoolState

Obrigatório

Os valores possíveis incluem: 'active', 'deleting'

state_transition_time

datetime

Obrigatório

allocation_state

str ou AllocationState

Obrigatório

Os valores possíveis incluem: 'estável', 'redimensionamento', 'stop'

allocation_state_transition_time

datetime

Obrigatório

vm_size

str

Obrigatório

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

cloud_service_configuration

CloudServiceConfiguration

Obrigatório

A configuração do serviço de nuvem para o Pool. Essa propriedade e virtualMachineConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Essa propriedade não poderá ser especificada se a Conta do Lote foi criada com sua propriedade poolAllocationMode definida como 'UserSubscription'.

virtual_machine_configuration

VirtualMachineConfiguration

Obrigatório

A configuração da máquina virtual para o Pool. Essa propriedade e cloudServiceConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada.

resize_timeout

<xref:timedelta>

Obrigatório

Esse é o tempo limite para a operação de redimensionamento mais recente. (O dimensionamento inicial quando o pool é criado conta como um redimensionamento.) O valor padrão é 15 minutos.

resize_errors

list[ResizeError]

Obrigatório

Essa propriedade será definida somente se um ou mais erros ocorreram durante o último redimensionamento do pool e somente quando a alocação do PoolState for Estável.

current_dedicated_nodes

int

Obrigatório

O número de nós de computação dedicados atualmente no pool.

current_low_priority_nodes

int

Obrigatório

O número de nós de computação spot/de baixa prioridade atualmente no pool. Os nós de computação spot/de baixa prioridade que foram preemptos estão incluídos nessa contagem.

target_dedicated_nodes

int

Obrigatório

O número desejado de nós de computação dedicados no pool.

target_low_priority_nodes

int

Obrigatório

O número desejado de nós de computação spot/de baixa prioridade no pool.

enable_auto_scale

bool

Obrigatório

Se o tamanho do Pool deve ser ajustado automaticamente ao longo do tempo. Se false, pelo menos um dos targetDedicatedNodes e targetLowPriorityNodes devem ser especificados. 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.

auto_scale_formula

str

Obrigatório

Essa propriedade será definida somente se o Pool for dimensionado automaticamente, ou seja, enableAutoScale for true.

auto_scale_evaluation_interval

<xref:timedelta>

Obrigatório

Essa propriedade será definida somente se o Pool for dimensionado automaticamente, ou seja, enableAutoScale for true.

auto_scale_run

AutoScaleRun

Obrigatório

Os resultados e erros da última execução da fórmula de dimensionamento automático. Essa propriedade será definida somente se o Pool for dimensionado automaticamente, ou seja, enableAutoScale for true.

enable_inter_node_communication

bool

Obrigatório

Se o Pool permite comunicação direta entre nós de computação. Isso impõe restrições sobre as quais os Nós de Computação podem ser atribuídos ao Pool. Especificar esse valor pode reduzir a chance do número solicitado de Nós de Computação ser alocado no Pool.

network_configuration

NetworkConfiguration

Obrigatório

A configuração de rede para o Pool.

start_task

StartTask

Obrigatório

Uma Tarefa especificada para ser executada em cada Nó de Computação à medida que ele ingressa no Pool.

certificate_references

list[CertificateReference]

Obrigatório

Para nós do Windows, o serviço lote instala os Certificados no repositório e local especificados do Certificado. Para nós de computação do 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 Certificados são colocados nesse diretório. Aviso: essa propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use a Extensão do Azure KeyVault .

application_package_references

list[ApplicationPackageReference]

Obrigatório

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 reimagem. Há no máximo 10 referências de pacote em qualquer pool especificado.

application_licenses

list[str]

Obrigatório

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

task_slots_per_node

int

Obrigatório

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.

task_scheduling_policy

TaskSchedulingPolicy

Obrigatório

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.

user_accounts

list[UserAccount]

Obrigatório

metadata

list[MetadataItem]

Obrigatório

stats

PoolStatistics

Obrigatório

Estatísticas de utilização e uso de recursos durante todo o tempo de vida do Pool. Essa propriedade será preenchida somente se o CloudPool tiver sido recuperado com uma cláusula de expansão, incluindo o atributo 'stats'; caso contrário, ele é nulo. As estatísticas podem não estar disponíveis imediatamente. O serviço lote executa um roll-up periódico de estatísticas. O atraso típico é de cerca de 30 minutos.

mount_configuration

list[MountConfiguration]

Obrigatório

Isso dá suporte a Arquivos do Azure, NFS, CIFS/SMB e Blobfuse.

identity

BatchPoolIdentity

Obrigatório

A identidade do pool do Lote, se configurada. A lista de identidades de usuário associadas ao pool do Lote. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

target_node_communication_mode

str ou NodeCommunicationMode

Obrigatório

O modo de comunicação de nó desejado para o pool. Se omitido, o valor padrão será Default. Os valores possíveis incluem: 'default', 'classic', 'simplificado'

Variáveis

current_node_communication_mode

str ou NodeCommunicationMode

O estado atual do modo de comunicação do pool. Os valores possíveis incluem: 'default', 'classic', 'simplified'

Métodos

as_dict	Retornar um ditado que pode ser JSONify usando json.dump. O uso avançado pode, opcionalmente, usar um retorno de chamada como parâmetro: Key é o nome do atributo usado no Python. Attr_desc é um ditado de metadados. Atualmente, contém 'type' com o tipo msrest e 'key' com a chave codificada restAPI. Value é o valor atual neste objeto. A cadeia de caracteres retornada será usada para serializar a chave. Se o tipo de retorno for uma lista, isso será considerado um dict de resultado hierárquico. Confira os três exemplos neste arquivo: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Se você quiser serialização XML, poderá passar os kwargs is_xml=True.
deserialize	Analise um str usando a sintaxe RestAPI e retorne um modelo.
enable_additional_properties_sending
from_dict	Analisar um ditado usando determinado extrator de chave retorna um modelo. Por padrão, considere extratores de chave (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Retorne o JSON que seria enviado para o azure desse modelo. Esse é um alias para as_dict(full_restapi_key_transformer, keep_readonly=False). Se você quiser serialização XML, poderá passar os kwargs is_xml=True.
validate	Valide esse modelo recursivamente e retorne uma lista de ValidationError.

as_dict

Retornar um ditado que pode ser JSONify usando json.dump.

O uso avançado pode, opcionalmente, usar um retorno de chamada como parâmetro:

Key é o nome do atributo usado no Python. Attr_desc é um ditado de metadados. Atualmente, contém 'type' com o tipo msrest e 'key' com a chave codificada restAPI. Value é o valor atual neste objeto.

A cadeia de caracteres retornada será usada para serializar a chave. Se o tipo de retorno for uma lista, isso será considerado um dict de resultado hierárquico.

Confira os três exemplos neste arquivo:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Se você quiser serialização XML, poderá passar os kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Parâmetros

key_transformer

<xref:function>

Uma função de transformador de chave.

keep_readonly

valor padrão: True

Retornos

Um objeto compatível com JSON de ditado

Tipo de retorno

dict

deserialize

Analise um str usando a sintaxe RestAPI e retorne um modelo.

deserialize(data, content_type=None)

Parâmetros

data

str

Obrigatório

Um str usando a estrutura RestAPI. JSON por padrão.

content_type

str

valor padrão: None

JSON por padrão, defina application/xml se XML.

Retornos

Uma instância desse modelo

Exceções

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analisar um ditado usando determinado extrator de chave retorna um modelo.

Por padrão, considere extratores de chave (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

Parâmetros

data

dict

Obrigatório

Um ditado usando a estrutura RestAPI

content_type

str

valor padrão: None

JSON por padrão, defina application/xml se XML.

key_extractors

valor padrão: None

Retornos

Uma instância desse modelo

Exceções

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Retorne o JSON que seria enviado para o azure desse modelo.

Esse é um alias para as_dict(full_restapi_key_transformer, keep_readonly=False).

Se você quiser serialização XML, poderá passar os kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parâmetros

keep_readonly

bool

valor padrão: False

Se você quiser serializar os atributos somente leitura

Retornos

Um objeto compatível com JSON de ditado

Tipo de retorno

dict

validate

Valide esse modelo recursivamente e retorne uma lista de ValidationError.

validate()

Retornos

Uma lista de erros de validação

Tipo de retorno

list