创建项目tags - CreateProjectTag
功能介绍
创建项目tags。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
POST /v1/{project_id}/git/repos/{namespace}/{project}/tags
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释： 租户项目ID。获取方法，请参考获取项目ID。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
namespace |
是 |
String |
参数解释： 命名空间ID或者URL编码名称。获取方法，请参考获取仓库namespaces - ObtainRepositoryNamespaces。 取值范围： 不涉及 默认取值： 不涉及 |
|
project |
是 |
String |
参数解释： 仓库项目ID或者URL编码名称，如果含有“/”，需要将“/”替换为“:”。获取方法，请参考获取命名空间下所有项目 - ObtainAllProjectsInNamespace。 取值范围： 不涉及 默认取值： 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ref |
是 |
String |
参数解释： 分支名称或者tag名称或者commit sha。 取值范围： 不涉及 默认取值： 不涉及 |
请求消息
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释： 消息体的类型（格式）。 约束限制： 不涉及 取值范围： application/json;charset=utf8 默认取值： 不涉及 |
|
X-Auth-Token |
是 |
String |
参数解释： 调用接口的认证方式分为Token和AK/SK两种，如果您使用的Token方式，此参数为必填，请填写Token的值。Token获取方式，请参考认证鉴权。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
|
X-Repo-Auth |
是 |
String |
参数解释： 授权名称。通过获取仓库授权列表 - ObtainGitRepositoryAuthorizationList获取对应的授权名称。 取值范围： 不涉及 默认取值： 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
参数解释： tags名称。 取值范围： 不涉及 默认取值： 不涉及 |
|
description |
是 |
String |
参数解释： 描述。 取值范围： 不涉及 默认取值： 不涉及 |
响应消息
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数解释： 项目tags名称。 取值范围： 不涉及 |
请求示例
创建名称为test1的项目tags，tags描述信息设置为test version 1。
{
"name": "test1",
"description": "test version 1"
}
响应示例
{
"name": "test1"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
操作成功。 |
|
400 |
错误的请求。 |
错误码
请参考ServiceStage错误码。
