CreateJob - Elastic High Performance Computing: Central de Documentação do Alibaba Cloud

Cria um job para um cluster.

Descrição da operação

Antes de chamar esta operação, certifique-se de compreender a cobrança e os preços do E-HPC.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ehpc:CreateJob

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster. Você pode chamar a operação ListClusters para consultar o ID do cluster.	ehpc-hz-FYUr32****
JobName	string	Não	O nome do job.	TestJob
JobSpec	object	Não	As configurações do job.
CommandLine	string	Sim	O comando ou script usado para executar o job. Se você quiser usar um comando, deverá especificar o caminho completo do comando, por exemplo, /bin/ping. Se você quiser usar um script, deverá certificar-se de ter as permissões de execução nele. Por padrão, o diretório raiz do usuário ~/ é usado como o caminho padrão do script no lado do cluster. Se o seu script não estiver nesse diretório, você deverá especificar o caminho completo neste parâmetro, como /home/xxx/job.sh. Observe que, neste modo, se os requisitos de recursos, como CPU e memória, forem especificados no script, o job será executado com base nos requisitos de recursos especificados no script. Nesse caso, não especifique requisitos de recursos no parâmetro Resource. Caso contrário, o job poderá falhar ao ser executado. Se você quiser executar o job diretamente usando a CLI, deverá especificar o caminho absoluto do comando e adicionar dois hifens e um espaço (-- ) antes do caminho, como -- /bin/ping -c 10 localhost.	/home/xxx/test.job
RunasUser	string	Não	O usuário do cluster com o qual você deseja submeter o job.	testuser
RunasUserPassword	string	Não	A senha do usuário especificado pelo parâmetro RunasUser.	xxx
Priority	string	Não	A prioridade do job.	1
StdoutPath	string	Não	O caminho do arquivo de saída padrão do job. Você precisa especificar o caminho completo.	/home/xxx/job.out
StderrPath	string	Não	O caminho do arquivo de saída de erro padrão do job. Você precisa especificar o caminho completo.	/home/xxx/job.err
JobQueue	string	Não	A fila à qual o job pertence.	comp
ArrayRequest	string	Não	Os jobs na fila. Formato: X-Y:Z. X é o valor mínimo do índice. Y é o valor máximo do índice. Z é o tamanho do passo. Por exemplo, 2-7:2 indica que três jobs precisam ser executados e seus valores de índice são 2, 4 e 6.	1-5:2
Variables	string	Não	As variáveis de ambiente do job. O valor é uma string no formato de array JSON. Cada membro do array é um objeto JSON que contém dois membros: Name e Value. Name indica o nome da variável de ambiente e Value indica o valor da variável de ambiente.	[{"Name":"x", "Value":"y"}]
PostCmdLine	string	Não	O comando de pós-processamento do job.	/bin/sleep 10
WallTime	string	Não	A duração máxima durante a qual o job pode ser executado. Formato: hora:minuto:segundo. Por exemplo, 01:00:00 indica 1 hora.	360:48:50
Resources	object	Não	As configurações de recursos do job.
Nodes	integer	Não	O número de nós de computação a serem alocados para o job.	2
Cores	integer	Não	O número de vCPUs a serem alocadas para cada nó de computação.	2
Memory	string	Não	O tamanho da memória a ser alocado para cada nó de computação. O tamanho da memória está no formato de string. Unidade: MB ou GB.	4gb
Gpus	integer	Não	O número de GPUs a serem alocadas para cada nó de computação.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	A0A38A38-1565-555E-B597-E48A2E******
JobId	string	O ID do job.	Submitted batch job 10\n
Success	string	Indica se a solicitação foi bem-sucedida.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "A0A38A38-1565-555E-B597-E48A2E******",
  "JobId": "Submitted batch job 10\\n",
  "Success": "true"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	The specified parameter %s is invalid.	The specified parameter %s is invalid.
403	InvalidClusterStatus	The operation failed due to invalid cluster status.	The cluster status does not support the operation.
404	ClusterNotFound	The specified cluster does not exist.	The specified instance does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server	The request has failed due to a temporary failure of the server.
406	EcsError	An error occurred while calling the ECS API operation.	ECS API call error. %s
406	AgentError	The agent service request failed: %s	Operation unsuccessful: %s
406	AgentError.Job.SubmitFailure	Failed to submit jobs: %s	Failed to submit the jobs.
406	AgentError.Job.DeleteFailure	Failed to delete job: %s	Failed to delete the job: {}
406	AgentError.Job.InvalidContainerType	Unsupported container type: %s.	The container type is not supported: %s.
406	AgentError.Job.ListFailure	Failed to list jobs: %s.	Failed to obtain the job list: %s
406	AgentError.Job.RerunFailure	Failed to run the job again: %s.	Failed to run the job again: %s
406	AgentError.Job.StopFailure	Failed to stop jobs: %s.	Failed to stop the job: %s

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.