本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
StopSearchJob
此操作可结束搜索作业。
只能停止状态为 RUNNING 的搜索作业。
请求语法
PUT /search-jobs/SearchJobIdentifier/actions/cancel HTTP/1.1
URI 请求参数
请求使用以下 URI 参数。
- SearchJobIdentifier
-
指定搜索作业的唯一字符串。
必需:是
请求体
该请求没有请求正文。
响应语法
HTTP/1.1 200
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作的常见错误信息,请参阅 常见错误。
- AccessDeniedException
-
您没有足够的访问权限,无法执行该操作。
- message
-
用户没有足够的访问权限,无法执行该操作。
HTTP 状态代码:403
- ConflictException
-
当检测到与之前成功执行的操作存在冲突时,会触发此异常。当上一项操作没有时间传播到处理当前请求的主机时,通常会发生这种情况。
对于此异常,建议的应对方式是重试(需配合适当的退避逻辑)。
- message
-
更新或删除资源可能会导致状态不一致。
- resourceId
-
受影响资源的标识符。
- resourceType
-
受影响资源的类型。
HTTP 状态代码:409
- InternalServerException
-
发生内部服务器错误。重试您的请求。
- message
-
请求处理过程中发生意外错误。
- retryAfterSeconds
-
等待指定秒数后重试此调用。
HTTP 状态代码:500
- ResourceNotFoundException
-
未找到此请求所需的资源。
确认资源信息(例如 ARN 或类型)正确无误且存在,然后重试请求。
- message
-
请求引用的资源不存在。
- resourceId
-
受影响资源的假设性标识符。
- resourceType
-
受影响资源的假设性类型。
HTTP 状态代码:404
- ThrottlingException
-
由于请求限制而导致请求被拒绝。
- message
-
由于请求节流,请求失败。
- quotaCode
-
这是具有限额的原始服务所独有的代码。
- retryAfterSeconds
-
等待指定秒数后重试此调用。
- serviceCode
-
这是原始服务所独有的代码。
HTTP 状态代码:429
- ValidationException
-
输入未能满足服务指定的约束条件。
- message
-
输入未能满足 Amazon 服务指定的约束条件。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: