Protected tags API

原文：https://docs.gitlab.com/ee/api/protected_tags.html

• List protected tags
• Get a single protected tag or wildcard protected tag
• Protect repository tags
• Unprotect repository tags

Protected tags API

注意：此功能是在 GitLab 11.3 中引入的

有效的访问级别

当前，这些级别被认可：

0  => No access
30 => Developer access
40 => Maintainer access

List protected tags

从项目中获取受保护标签的列表. 此函数使用分页参数page和per_page来限制受保护标签的列表.

GET /projects/:id/protected_tags

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/protected_tags"

响应示例：

[  {  "name":  "release-1-0",  "create_access_levels":  [  {  "access_level":  40,  "access_level_description":  "Maintainers"  }  ]  },  ...  ]

Get a single protected tag or wildcard protected tag

获取单个受保护标签或通配符受保护标签. 分页参数page和per_page可用于限制受保护标签的列表.

GET /projects/:id/protected_tags/:name

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/protected_tags/release-1-0"

响应示例：

{  "name":  "release-1-0",  "create_access_levels":  [  {  "access_level":  40,  "access_level_description":  "Maintainers"  }  ]  }

Protect repository tags

使用通配符保护的标签保护单个存储库标签或几个项目存储库标签.

POST /projects/:id/protected_tags

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/protected_tags?name=*-stable&create_access_level=30"

响应示例：

{  "name":  "*-stable",  "create_access_levels":  [  {  "access_level":  30,  "access_level_description":  "Developers + Maintainers"  }  ]  }

Unprotect repository tags

取消保护给定的受保护标签或通配符受保护标签.

DELETE /projects/:id/protected_tags/:name

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/protected_tags/*-stable"