删除 OCI 制品(镜像、Helm Chart)的版本,支持批量删除。
请求说明 请求方式:POST 请求地址:https://open.volcengineapi.com?Action=DeleteTags&Version=2022-05-12 调试 API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
去调试 请求参数 调用该 API 时,除了以下请求参数外,还需传入公共请求参数。公共请求参数说明,请参见 火山引擎公共参数文档 。
参数 类型 是否必选 示例值 描述 Action String 是 DeleteTags 接口名称。当前 API 的名称为 DeleteTags
。 Version String 是 2022-05-12 接口版本。当前 API 的版本为 2022-05-12
。 Registry String 是 registrya OCI 制品所在的镜像仓库实例名称。在 镜像仓库控制台 的 实例列表 页面,获取实例名称。 Namespace String 是 library OCI 制品所在的命名空间名称。 Repository String 是 repositorya OCI 制品所在的 OCI 制品仓库名称。 Names Array of String 是 ["v1","v2"] OCI 制品版本列表,支持批量传入要删除的版本名称。当前最多支持一次传 20 个版本名称。
请求示例 POST https:
{
"Registry" : "registrya" ,
"Namespace" : "library" ,
"Repository" : "repositorya" ,
"Names" : [ "v1" , "v2" ]
}
返回参数 参数 类型 示例值 描述 Successes Array of Success [{"Name":"tag1"}] 删除成功的版本。 Failures Array of Failure [{"Name":"tag2", "Reason":""xxx"}] 删除失败的版本。
Success 参数 类型 示例值 描述 Name String v1 Tag 的名称。
Failure 参数 类型 示例值 描述 Name String v1 Tag 的名称。 Reason String tag v1 not exist 删除失败原因。
返回示例 {
"ResponseMetadata" : {
"RequestId" : "540CFF28-407A-40B5-B6A5-74B****" ,
"Action" : "DeleteTags" ,
"Version" : "2022-05-12" ,
"Service" : "cr" ,
"Region" : "cn-beijing" ,
} ,
"Result" : {
"Successes" : [
{
"Name" : "v1"
}
] ,
"Failures" : [
{
"Name" : "v2" ,
"Reason" : "****"
}
]
}
}
错误码 本接口错误码如下表所示,公共错误码请参见 公共错误码 。
HTTP 状态码 错误码 错误信息 说明 400 OperationDenied.RegistryStatus The action has been denied due to wrong status %s. 当前实例状态下不允许执行指定操作,请等待状态转换后重试。