Este método permite ao usuário iniciar a execução de um job (processo em lote) que já foi carregado (status loaded), mas que ainda não
está sendo consultado. Esse passo não é necessário, caso você já tenha definido o parâmetro AutomaticallyStartQuerying como true.
Antes de iniciar o job é necessário defini-lo em Salvar Definição, esse passo irá retornar o identificador único que vai ser usado nesse método.
Funcionamento
A partir do JobId fornecido na entrada, que deve ser um identificador válido e associado com algum job desse
usuário, o método irá iniciar a execução das consultas desse job. Só podem ser iniciados os jobs com staus
loaded, ou seja, que já foram carregados.
Parâmetros de Entrada
A tabela a seguir descreve os parâmetros de entrada deste método, indicando se são obrigatórios ou não, e os valores possíveis para os campos com valores pré-definidos.
| Campo | Obrigatório? | Valores Possíveis | Descrição |
|---|---|---|---|
| JobId | Sim | Identificador do job que deve ser suspendido | Um identificador do job retornado pela chamada de SaveJobDefinition |
Retorno
A tabela a seguir descreve os campos do objeto de retorno desse método.
| Campo | Descrição |
|---|---|
| JobId | Identificador do job fornecido na entrada |
| StatusCode | Código de resultado da chamada |
| StatusMessage | Mensagem descritiva de resultado da chamada |
| TotalExecutionTime | Tempo total de execução da requisição no servidor |
| RequestTimestamp | Data e hora do término da execução da requisição no servidor |
Códigos de Status
A tabela a seguir descreve os possíveis códigos e mensagens de retorno.
| Código | Mensagem | Descrição |
|---|---|---|
| 0 | OK | Execução com sucesso |
| -1 | INVALID AUTHENTICATION PARAMETERS | O token de acesso fornecido na entrada é inválido |
| -2 | BAD REQUEST FORMAT | O request enviado não está bem formatado |
| -108 | INVALID JOB ID | O identificador do job passado na entrada é inválido |
| -109 | INVALID JOB STATUS FOR OPERATION | O job selecionado não pode ser suspendido ou cancelado devido ao seu status atual |
| -1200 | UNEXPECTED ERROR. PLEASE CONTACT OUR SUPPORT TEAM | Ocorreu algum erro inesperado. Entre em contato com nossa equipe de atendimento |
BODY raw
{
"JobId": "[IDENTIFICADOR ÚNICO DO JOB]"
}