文档首页/ 代码托管 CodeArts Repo/ API参考（联盟区域）/ API/ Repository/ 新建保护tag
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

新建保护tag

功能介绍

新建保护分tag

URI

POST /v2/repositories/{repository_id}/protected-tags

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

是

Integer

仓库主键id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

name

否

String

保护tag名称

create_access_level

否

Integer

保护tag创建权限

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

error

Error object

响应错误

result

AddProtectTagResponse object

响应结果

status

String

响应状态
表5 Error

参数

参数类型

描述

code

String

错误码

message

String

错误信息
表6 AddProtectTagResponse

参数

参数类型

描述

name

String

保护tag名称

create_access_levels

CreateAccessLevels object

保护tag创建权限
表7 CreateAccessLevels

参数

参数类型

描述

access_level

Integer

权限

access_level_description

String

权限描述

请求示例

POST https://{endpoint}/v2/repositories/{repository_id}/protected_tags

{
  "name" : "test",
  "create_access_level" : 40
}

响应示例

状态码： 200

OK

{
  "result" : {
    "name" : "test",
    "create_access_levels" : {
      "access_level" : 40,
      "access_level_description" : "Maintainers"
    }
  },
  "status" : "success"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： Repository