# 新建标签（废弃）
#### 功能介绍
新建标签
![](https://support.huaweicloud.com/api-codeartsrepo/public_sys-resources/note_3.0-zh-cn.png)
当前API已经废弃，请使用[创建标签](https://support.huaweicloud.com/api-codeartsrepo/CreateTag.html)。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CodeHub/doc?api=AddTagV2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/repositories/{repository_id}/tags
表1路径参数 
| 参数            | 是否必选 | 参数类型    | 描述     |
|:---|:---|:---|:---|
| repository_id | 是    | Integer | 仓库主键id |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
表3请求Body参数 
| 参数       | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| tag_name | 是    | String | 标签名称 |
| ref      | 是    | String | 分支名称 |
| message  | 否    | String | 备注   |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数     | 参数类型                                                                                       | 描述                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| error  | [Error] object                     | 响应错误                                                                                                                                                                                                                                                                                              |
| result | [AddTagsResponse] object | 响应结果                                                                                                                                                                                                                                                                                              |
| status | String                                                                                     | **参数解释：** 调用此接口的响应状态。 **取值范围：** - success，表示接口调用成功。  - failed，表示接口调用失败。   |
   
 表5Error 
| 参数      | 参数类型   | 描述   |
|:---|:---|:---|
| code    | String | 错误码  |
| message | String | 错误信息 |
   
 表6AddTagsResponse 
| 参数      | 参数类型                                                                                 | 描述   |
|:---|:---|:---|
| name    | String                                                                               | 标签名称 |
| message | String                                                                               | 备注   |
| commit  | [CommitRepoV2] object | 提交信息 |
   
 表7CommitRepoV2 
| 参数             | 参数类型             | 描述           |
|:---|:---|:---|
| id             | String           | 提交对应的SHA id  |
| short_id       | String           | 提交对应的短SHA id |
| created_at     | String           | 创建时间         |
| title          | String           | 提交标题         |
| parent_ids     | Array of strings | 父提交id        |
| message        | String           | 提交信息         |
| author_name    | String           | 作者           |
| committer_name | String           | 提交作者         |
| committed_date | String           | 提交时间         |
   
#### 请求示例
```
POST https://{endpoint}/v2/repositories/{repository_id}/tags
{
  "tag_name" : "test20220920",
  "ref" : "master",
  "message" : "test20220920"
}
```
#### 响应示例
**状态码： 200**
OK
```
{
  "result" : {
    "name" : "test_tag_name",
    "message" : "test message",
    "commit" : {
      "id" : "3b68902cf0eb7de3d5c8757e4a990bc3fe0af349",
      "short_id" : "3b68902c",
      "created_at" : "2022-03-08T03:14:39.000Z",
      "title" : "新建文件",
      "parent_ids" : [ "08618c900a4048aae7e4cd88913d3d521eae02eb" ],
      "message" : "新建文件",
      "author_name" : "repo",
      "committer_name" : "repo",
      "committed_date" : "2022-03-08T03:14:39.000Z"
    }
  },
  "status" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见错误码。