# Protected tags API > 原文：[https://docs.gitlab.com/ee/api/protected_tags.html](https://docs.gitlab.com/ee/api/protected_tags.html) * [List protected tags](#list-protected-tags) * [Get a single protected tag or wildcard protected tag](#get-a-single-protected-tag-or-wildcard-protected-tag) * [Protect repository tags](#protect-repository-tags) * [Unprotect repository tags](#unprotect-repository-tags) # Protected tags API[](#protected-tags-api "Permalink") **注意：**此功能是在 GitLab 11.3 中引入的 **有效的訪問級別** 當前，這些級別被認可： ``` 0 => No access 30 => Developer access 40 => Maintainer access ``` ## List protected tags[](#list-protected-tags "Permalink") 從項目中獲取受保護標簽的列表. 此函數使用分頁參數`page`和`per_page`來限制受保護標簽的列表. ``` GET /projects/:id/protected_tags ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | ``` 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[](#get-a-single-protected-tag-or-wildcard-protected-tag "Permalink") 獲取單個受保護標簽或通配符受保護標簽. 分頁參數`page`和`per_page`可用于限制受保護標簽的列表. ``` GET /projects/:id/protected_tags/:name ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `name` | string | yes | 標簽或通配符的名稱 | ``` 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[](#protect-repository-tags "Permalink") 使用通配符保護的標簽保護單個存儲庫標簽或幾個項目存儲庫標簽. ``` 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" ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `name` | string | yes | 標簽或通配符的名稱 | | `create_access_level` | string | no | 允許創建的訪問級別（默認值： `40` ，維護者訪問級別） | 響應示例： ``` { "name": "*-stable", "create_access_levels": [ { "access_level": 30, "access_level_description": "Developers + Maintainers" } ] } ``` ## Unprotect repository tags[](#unprotect-repository-tags "Permalink") 取消保護給定的受保護標簽或通配符受保護標簽. ``` 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" ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `name` | string | yes | 標簽名稱 |