BatchDeleteRecipeVersion
一次删除配方的一个或多个版本。
在以下情况下,整个请求将被拒绝:
-
配方不存在。
-
在版本列表中存在无效版本标识符。
-
版本列表为空。
-
版本列表大小超过 50。
-
版本列表包含重复条目。
如果出现以下情况,请求将成功完成,但部分失败:
-
某个版本不存在。
-
某个作业正在使用某个版本。
-
您指定
LATEST_WORKING,但它正在被一个项目使用。 -
版本删除失败。
仅当配方没有其他版本时,才会删除 LATEST_WORKING 版本。如果您在其他版本存在时尝试删除 LATEST_WORKING(或者如果无法删除这些版本),则 LATEST_WORKING 将在响应中列为部分失败。
请求语法
POST /recipes/name/batchDeleteRecipeVersion HTTP/1.1
Content-type: application/json
{
"RecipeVersions": [ "string" ]
}
URI 请求参数
请求使用以下 URI 参数。
- name
-
要删除其版本的配方的名称。
长度限制:长度下限为 1。最大长度为 255。
必需:是
请求体
请求接受采用 JSON 格式的以下数据。
- RecipeVersions
-
要删除的配方版本的版本标识符数组。您可以指定数字版本(
X.Y)或LATEST_WORKING。LATEST_PUBLISHED不受支持。类型:字符串数组
数组成员:最少 1 个物品。最多 50 项。
长度限制:长度下限为 1。最大长度为 16。
必需:是
响应语法
HTTP/1.1 200
Content-type: application/json
{
"Errors": [
{
"ErrorCode": "string",
"ErrorMessage": "string",
"RecipeVersion": "string"
}
],
"Name": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- Name
-
已修改的配方的名称。
类型:字符串
长度限制:长度下限为 1。最大长度为 255。
- Errors
-
尝试删除配方版本时出现的错误(如果有)。
类型:RecipeVersionErrorDetail 对象数组
错误
有关所有操作的常见错误的信息,请参阅常见错误。
- ConflictException
-
更新或删除资源可能会导致状态不一致。
HTTP 状态代码:409
- ResourceNotFoundException
-
无法找到一个或多个资源。
HTTP 状态代码:404
- ValidationException
-
此请求的输入参数验证失败。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: