Compartilhar via


PoolUpdatePropertiesParameter Classe

O conjunto de alterações a serem feitas em um pool.

Todos os parâmetros necessários devem ser preenchidos para enviar ao Azure.

Herança
PoolUpdatePropertiesParameter

Construtor

PoolUpdatePropertiesParameter(*, certificate_references, application_package_references, metadata, start_task=None, target_node_communication_mode=None, **kwargs)

Parâmetros

start_task
StartTask
Obrigatório

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. Se esse elemento estiver presente, ele substituirá qualquer StartTask existente. Se omitido, qualquer StartTask existente será removido do pool.

certificate_references
list[CertificateReference]
Obrigatório

Obrigatórios. Essa lista substitui todas as referências de certificado existentes configuradas no pool. Se você especificar uma coleção vazia, todas as referências de Certificado existentes serão removidas do Pool. Para nós do Windows, o serviço lote instala os Certificados no repositório de certificados e no local especificados. 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 os 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

Obrigatórios. A lista substitui todas as referências existentes do Pacote de Aplicativos no Pool. As alterações nas referências do Pacote de Aplicativos afetam todos os novos nós de computação 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 refeitarem a imagem. Há no máximo 10 referências de Pacote de Aplicativos em qualquer pool específico. Se for omitido ou se você especificar uma coleção vazia, todas as referências de Pacotes de Aplicativos existentes serão removidas do pool. Um máximo de 10 referências pode ser especificado em um determinado pool.

metadata
list[MetadataItem]
Obrigatório

Obrigatórios. Essa lista substitui todos os metadados existentes configurados no Pool. Se for omitido ou se você especificar uma coleção vazia, todos os metadados existentes serão removidos do Pool.

target_node_communication_mode
str ou NodeCommunicationMode
Obrigatório

O modo de comunicação de nó desejado para o pool. Essa configuração substitui qualquer configuração targetNodeCommunication existente no Pool. Se omitida, a configuração existente será padrão. Os valores possíveis incluem: 'default', 'classic', 'simplified'

Métodos

as_dict

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

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

Key é o nome do atributo usado no Python. Attr_desc é um dict 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.

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

Key é o nome do atributo usado no Python. Attr_desc é um dict 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 dict

Tipo de retorno

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 dict

Tipo de retorno

validate

Valide esse modelo recursivamente e retorne uma lista de ValidationError.

validate()

Retornos

Uma lista de erros de validação

Tipo de retorno