CancelTask - Amazon Snowball
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CancelTask

为指定任务发送取消请求。只有任务仍处于QUEUED状态时，您才能取消该任务。已在运行的任务无法取消。

注意

如果在CancelTask操作更改任务状态之前从队列中处理任务，则该任务可能仍在运行。

请求语法

POST /task/taskId/cancel HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

taskId

您正在尝试取消的任务的 ID。您可以使用ListTasks操作检索任务 ID。

长度限制：最小长度为 1。最大长度为 64。

必需：是

请求正文

该请求没有请求体。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "taskId": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

taskId

您正在尝试取消的任务的 ID。

类型：字符串

错误

有关所有操作常见错误的信息，请参阅常见错误。

AccessDeniedException

您没有足够的访问权限来执行此操作。

HTTP 状态代码：403

InternalServerException

处理请求时出现意外错误。

HTTP 状态代码：500

ResourceNotFoundException

该请求引用了不存在的资源。

HTTP 状态代码：404

ThrottlingException

由于请求限制而导致请求被拒绝。

HTTP 状态代码：429

ValidationException

输入未能满足 Amazon 服务指定的约束。

HTTP 状态代码：400

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：