文档中心

镜像仓库

OCI 制品版本管理

CreateTag

为已有镜像添加新的 Tag。新旧 Tag 指向同一镜像摘要（Digest），无需重新上传镜像内容。

请求说明

为获得低延迟，建议您根据资源所在的地域选择对应的服务地址，详情参见服务地址。

请求地址：https://cr.cn-beijing.volcengineapi.com?Action=CreateTag&Version=2022-05-12

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

调用该 API 时，除了以下请求参数外，还需传入公共请求参数。公共请求参数说明，请参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	CreateTag	接口名称。当前 API 的名称为 CreateTag。
Version	String	是	2022-05-12	接口版本。当前 API 的版本为 2022-05-12。
Registry	String	是	registrya	OCI 制品仓库的实例名称，用于指定目标镜像所在的仓库实例。
Namespace	String	是	my-namespace-****	指定目标镜像所在的命名空间，用于定位目标镜像所属的命名空间资源。
Repository	String	是	my-****-repo	指定目标镜像所在的 OCI 制品库，用于定位源 Tag 所属的制品库资源。
SourceTag	String	是	v1.0.0	指定目标制品库下已存在的标签，作为新增标签的来源，新增的标签将与该标签指向同一个制品摘要。
DestinationTag	String	是	v1.0.1-release	为镜像新增的目标标签，配置后该标签将与指定的源标签指向完全相同的制品摘要，无需重新上传镜像内容。
Override	Boolean	否	false	当目标标签已存在且指向其他制品摘要（Digest）时是否覆盖。 true：覆盖目标标签指向的不同制品摘要，将目标标签关联至源标签对应的制品摘要。 false：默认值，不执行覆盖，若目标标签已存在且指向不同摘要将返回 AlreadyExists.DestinationTag 报错信息。

请求示例

返回参数

参数	类型	示例值	描述
Digest	String	sha256:8ca468****	本次新增的镜像版本标签所指向的 Digest，与源版本指向的标识保持一致。

返回示例

错误码

本接口无特有错误码，公共错误码请参见公共错误码。

最近更新时间：2026.11.03 15:45:21

这个页面对您有帮助吗？

有用

无用