JobAddParameter Classe
Uma tarefa de Azure Batch a adicionar.
Todos os parâmetros necessários têm de ser preenchidos para enviar para o Azure.
- Herança
-
JobAddParameter
Construtor
JobAddParameter(*, id: str, pool_info, display_name: str = None, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, on_all_tasks_complete=None, on_task_failure=None, metadata=None, uses_task_dependencies: bool = None, network_configuration=None, **kwargs)Parâmetros
- id
- str
Obrigatório. O ID pode conter qualquer combinação de carateres alfanuméricos, incluindo hífenes e carateres de sublinhado, e não pode conter mais de 64 carateres. O ID é de preservação de maiúsculas e minúsculas e não é sensível a maiúsculas e minúsculas (ou seja, pode não ter dois IDs numa Conta que diferem apenas por maiúsculas e minúsculas).
- display_name
- str
O nome a apresentar não tem de ser exclusivo e pode conter carateres Unicode até um comprimento máximo de 1024.
- priority
- int
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. O valor predefinido é 0.
- max_parallel_tasks
- int
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. Valor predefinido: -1 .
- allow_task_preemption
- bool
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.
- job_manager_task
- JobManagerTask
Detalhes de uma Tarefa do Gestor de Tarefas a iniciar quando a Tarefa for iniciada. Se a Tarefa não especificar uma Tarefa do Gestor de Tarefas, o utilizador tem de adicionar explicitamente Tarefas à Tarefa. Se a Tarefa especificar uma Tarefa do Gestor de Tarefas, o serviço Batch cria a Tarefa do Gestor de Tarefas quando a Tarefa é criada e tentará agendar a Tarefa do Gestor de Tarefas antes de agendar outras Tarefas na Tarefa. O objetivo típico da Tarefa do Gestor de Tarefas é controlar e/ou monitorizar a execução da Tarefa, por exemplo, ao decidir que Tarefas adicionais executar, determinar quando o trabalho está concluído, etc. (No entanto, uma Tarefa do Gestor de Tarefas não está restrita a estas atividades- é uma Tarefa completa no sistema e executa todas as ações necessárias para a Tarefa.) Por exemplo, uma Tarefa do Gestor de Tarefas pode transferir um ficheiro especificado como um parâmetro, analisar o conteúdo desse ficheiro e submeter Tarefas adicionais com base nesses conteúdos.
- job_preparation_task
- JobPreparationTask
A tarefa de preparação da tarefa. Se uma Tarefa tiver uma Tarefa de Preparação de Tarefas, o serviço Batch executará a Tarefa de Preparação de Tarefas num Nó antes de iniciar quaisquer Tarefas dessa Tarefa nesse Nó de Computação.
- job_release_task
- JobReleaseTask
A Tarefa de Lançamento da Tarefa. Não é possível especificar uma Tarefa de Libertação de Tarefas sem especificar também uma Tarefa de Preparação de Tarefas para a Tarefa. O serviço Batch executa a Tarefa de Lançamento da Tarefa nos Nós que executaram a Tarefa de Preparação da Tarefa. O principal objetivo da Tarefa de Lançamento da Tarefa é anular as alterações aos Nós de Computação efetuadas pela Tarefa de Preparação da Tarefa. As atividades de exemplo incluem a eliminação de ficheiros locais ou o encerramento de serviços iniciados como parte da preparação da tarefa.
- common_environment_settings
- list[EnvironmentSetting]
As Tarefas Individuais podem substituir uma definição de ambiente especificada aqui ao especificar o mesmo nome de definição com um valor diferente.
- pool_info
- PoolInformation
Obrigatório. O Conjunto no qual o serviço Batch executa as Tarefas da Tarefa.
- on_all_tasks_complete
- str ou OnAllTasksComplete
A ação que o serviço Batch deve efetuar quando todas as Tarefas na Tarefa estiverem no estado concluído. Tenha em atenção que, se uma Tarefa não contiver Tarefas, todas as Tarefas serão consideradas concluídas. Por conseguinte, esta opção é utilizada com mais frequência com uma tarefa do Gestor de Tarefas; Se quiser utilizar a Terminação automática de tarefas sem um Gestor de Tarefas, deve inicialmente definir onAllTasksComplete como noaction e atualizar as propriedades da Tarefa para definir onAllTasksComplete para terminar o trabalho assim que terminar de adicionar Tarefas. A predefinição é noaction. Os valores possíveis incluem: "noAction", "terminateJob"
- on_task_failure
- str ou OnTaskFailure
A ação que o serviço Batch deve efetuar quando qualquer Tarefa na Tarefa falhar. Considera-se que uma Tarefa falhou se tiver uma falhaInfo. Uma failureInfo é definida se a Tarefa for concluída com um código de saída diferente de zero depois de esgotar a contagem de repetições ou se tiver ocorrido um erro ao iniciar a Tarefa, por exemplo, devido a um erro de transferência do ficheiro de recurso. A predefinição é noaction. Os valores possíveis incluem: "noAction", "performExitOptionsJobAction"
- metadata
- list[MetadataItem]
O serviço Batch não atribui qualquer significado aos metadados; destina-se apenas à utilização de código de utilizador.
- uses_task_dependencies
- bool
Se as Tarefas na Tarefa podem definir dependências entre si. A predefinição é false.
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:
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
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
Devoluções
Uma instância deste modelo
Exceções
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
- key_extractors
Devoluções
Uma instância deste modelo
Exceções
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
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
Azure SDK for Python