Partilhar via


JobPatchParameter Classe

O conjunto de alterações a efetuar a uma Tarefa.

Herança
JobPatchParameter

Construtor

JobPatchParameter(*, priority: int = None, max_parallel_tasks: int = None, allow_task_preemption: bool = None, on_all_tasks_complete=None, constraints=None, pool_info=None, metadata=None, **kwargs)

Parâmetros

priority
int
Necessário

A prioridade da Tarefa. Os valores de prioridade podem variar entre -1000 e 1000, sendo -1000 a prioridade mais baixa e 1000 a prioridade mais alta. Se for omitido, a prioridade da Tarefa permanece inalterada.

max_parallel_tasks
int
Necessário

O número máximo de tarefas que podem ser executadas em paralelo para a tarefa. Se especificado, o valor de maxParallelTasks tem de ser -1 ou superior a 0. Se não for especificado, o valor predefinido é -1, o que significa que não há limite para o número de tarefas que podem ser executadas ao mesmo tempo. Pode atualizar maxParallelTasks de uma tarefa depois de ter sido criada com a API de tarefa de atualização.

allow_task_preemption
bool
Necessário

Se as Tarefas nesta tarefa podem ser impedidas por outros trabalhos de alta prioridade. Se o valor estiver definido como Verdadeiro, outras tarefas de alta prioridade submetidas ao sistema terão precedência e poderão voltar a colocar tarefas em fila a partir desta tarefa. Pode atualizar a allowTaskPreemption de uma tarefa depois de ter sido criada com a API de tarefa de atualização.

on_all_tasks_complete
str ou OnAllTasksComplete
Necessário

A ação que o serviço Batch deve efetuar quando todas as Tarefas na Tarefa estiverem no estado concluído. Se for omitido, o comportamento de conclusão é deixado inalterado. Não pode alterar o valor de terminatejob para noaction, ou seja, depois de iniciar a terminação automática da Tarefa, não poderá desativá-lo novamente. Se tentar fazê-lo, o pedido falha com uma resposta de erro "valor de propriedade inválido"; se estiver a chamar a API REST diretamente, o código de estado HTTP é 400 (Pedido Incorreto). Os valores possíveis incluem: "noAction", "terminateJob"

constraints
JobConstraints
Necessário

As restrições de execução da Tarefa. Se for omitido, as restrições de execução existentes permanecem inalteradas.

pool_info
PoolInformation
Necessário

O Conjunto no qual o serviço Batch executa as Tarefas da Tarefa. Pode alterar o Conjunto para uma Tarefa apenas quando a Tarefa estiver desativada. A chamada Tarefa de Patch falhará se incluir o elemento poolInfo e a Tarefa não estiver desativada. Se especificar uma autoPoolSpecification no poolInfo, apenas a propriedade keepAlive da autoPoolSpecification pode ser atualizada e, em seguida, apenas se a autoPoolSpecification tiver um poolLifetimeOption of Job (outras propriedades da tarefa podem ser atualizadas normalmente). Se for omitido, a Tarefa continua a ser executada no conjunto atual.

metadata
list[MetadataItem]
Necessário

Se omitido, os metadados da Tarefa existentes permanecem inalterados.

Métodos

as_dict

Devolver um ditado que pode ser JSONify com json.dump.

Opcionalmente, a utilização avançada pode utilizar uma chamada de retorno como parâmetro:

A chave é o nome do atributo utilizado no Python. Attr_desc é um ditado dos metadados. Atualmente, contém "type" com o tipo msrest e "key" com a chave codificada RestAPI. O valor é o valor atual neste objeto.

A cadeia devolvida será utilizada para serializar a chave. Se o tipo de retorno for uma lista, isto é considerado dict de resultado hierárquico.

Veja os três exemplos neste ficheiro:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

deserialize

Analise um str com a sintaxe RestAPI e devolva um modelo.

enable_additional_properties_sending
from_dict

Analisar um ditado com um determinado extrator de chaves devolve um modelo.

Por predefinição, considere extratores chave (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

Devolver o JSON que seria enviado para o Azure a partir deste modelo.

Este é um alias para as_dict(full_restapi_key_transformer, keep_readonly=Falso).

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

validate

Valide este modelo de forma recursiva e devolva uma lista de ValidationError.

as_dict

Devolver um ditado que pode ser JSONify com json.dump.

Opcionalmente, a utilização avançada pode utilizar uma chamada de retorno como parâmetro:

A chave é o nome do atributo utilizado no Python. Attr_desc é um ditado dos metadados. Atualmente, contém "type" com o tipo msrest e "key" com a chave codificada RestAPI. O valor é o valor atual neste objeto.

A cadeia devolvida será utilizada para serializar a chave. Se o tipo de retorno for uma lista, isto é considerado dict de resultado hierárquico.

Veja os três exemplos neste ficheiro:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Se quiser serialização XML, pode transmitir 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 chaves.

keep_readonly
valor predefinido: True

Devoluções

Um objeto compatível com JSON de ditado

Tipo de retorno

deserialize

Analise um str com a sintaxe RestAPI e devolva um modelo.

deserialize(data, content_type=None)

Parâmetros

data
str
Necessário

Um str com a estrutura RestAPI. JSON por predefinição.

content_type
str
valor predefinido: None

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

Devoluções

Uma instância deste modelo

Exceções

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analisar um ditado com um determinado extrator de chaves devolve um modelo.

Por predefinição, considere extratores 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
Necessário

Um ditado com a estrutura restAPI

content_type
str
valor predefinido: None

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

key_extractors
valor predefinido: None

Devoluções

Uma instância deste modelo

Exceções

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Devolver o JSON que seria enviado para o Azure a partir deste modelo.

Este é um alias para as_dict(full_restapi_key_transformer, keep_readonly=Falso).

Se quiser serialização XML, pode transmitir os kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parâmetros

keep_readonly
bool
valor predefinido: False

Se quiser serializar os atributos só de leitura

Devoluções

Um objeto compatível com JSON de ditado

Tipo de retorno

validate

Valide este modelo de forma recursiva e devolva uma lista de ValidationError.

validate()

Devoluções

Uma lista de erros de validação

Tipo de retorno