创建项目tags
功能介绍
创建项目tags。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/git/repos/{namespace}/{project}/tags
参数说明见表1。
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户项目ID。获取方法,请参考获取项目ID。 |
namespace |
是 |
String |
命名空间ID或者URL编码名称。获取方法,请参考获取仓库namespaces。 |
project |
是 |
String |
仓库项目ID或者URL编码名称,如果含有“/”,需要将“/”替换为“:”。获取方法,请参考获取命名空间下所有项目。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
ref |
是 |
String |
分支名称或者tag名称或者commit sha。 |
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
消息体的类型(格式),默认取值为“application/json;charset=utf8”。 |
X-Auth-Token |
是 |
String |
调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考获取用户Token。 |
X-Repo-Auth |
是 |
String |
授权名称,通过获取仓库授权列表获取对应的授权名称。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
tags名称。 |
description |
是 |
String |
描述。 |
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
项目tags名称。 |
请求示例
创建名称为test1的项目tags,tags描述信息设置为test version 1。
{ "name": "test1", "description": "test version 1" }
响应示例
{ "name": "test1" }
状态码
状态码 |
描述 |
---|---|
200 |
操作成功。 |
400 |
错误的请求。 |
错误码
错误码格式为:SVCSTG.REPO.[Error_ID],例如:SVCSTG.REPO.0401。错误码说明请参考ServiceStage错误码。