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
URIParâmetros de solicitação
A solicitação usa os seguintes URI parâmetros.
- 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 comprimento: tamanho mínimo de 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 de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- taskId
-
O ID da tarefa que você está tentando cancelar.
Tipo: string
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não tem acesso suficiente para executar essa ação.
HTTPCódigo de status: 403
- InternalServerException
-
Ocorreu um erro inesperado ao processar a solicitação.
HTTPCódigo de status: 500
- ResourceNotFoundException
-
A solicitação faz referência a um recurso que não existe.
HTTPCódigo de status: 404
- ThrottlingException
-
A solicitação foi negada devido à limitação da solicitação.
HTTPCódigo de status: 429
- ValidationException
-
A entrada não satisfaz as restrições especificadas por um AWS serviço.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: