As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CancelTask
Envia uma solicitação de cancelamento para uma tarefa específica. Você pode cancelar uma tarefa somente se ela ainda estiver em um estado QUEUED. Tarefas que já estão em execução não podem ser canceladas.
nota
Uma tarefa ainda pode ser executada se for processada na fila antes que a operação CancelTask altere o estado da tarefa.
Sintaxe da Solicitação
POST /task/taskId/cancel HTTP/1.1
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- taskId
-
o ID da tarefa que você está tentando cancelar. Você pode recuperar um ID de tarefa usando a operação
ListTasks.Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Obrigatório: Sim
Corpo da Solicitação
Essa solicitação não tem corpo.
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"taskId": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- taskId
-
O ID da tarefa que você está tentando cancelar.
Tipo: sequência
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- AccessDeniedException
-
Você não tem acesso suficiente para executar essa ação.
Código de Status HTTP: 403
- InternalServerException
-
Ocorreu um erro inesperado ao processar a solicitação.
Código de Status HTTP: 500
- ResourceNotFoundException
-
A solicitação faz referência a um recurso que não existe.
Código de Status HTTP: 404
- ThrottlingException
-
A solicitação foi negada devido ao controle de limitação.
Código de Status HTTP: 429
- ValidationException
-
A entrada não satisfaz as restrições especificadas por um AWS serviço.
Código de Status HTTP: 400
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte:
