删除 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://open.volcengineapi.com?Action=DeleteTags&Version=2022-05-12
{
"Registry": "registrya",
"Namespace": "library",
"Repository": "repositorya",
"Names": ["v1","v2"]
}
返回参数
| 参数 | 类型 | 示例值 | 描述 |
|---|
| Successes | Array of Success | | 删除成功的版本。 |
| Failures | Array of Failure | | 删除失败的版本。 |
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. | 当前实例状态下不允许执行指定操作，请等待状态转换后重试。 |