保護されたタグ API
注:この機能は GitLab 11.3 で導入されました。
有効なアクセスレベル
現在、これらのレベルが認められています:
0 => No access
30 => Developer access
40 => Maintainer access
保護されたタグの一覧
プロジェクトから保護されたタグのリストを取得します。 この関数は、page
とper_page
のページネーションパラメータを受け取り、保護されたタグのリストを制限します。
GET /projects/:id/protected_tags
属性 | タイプ | 必須 | 説明 |
---|---|---|---|
id
| 整数/文字列 | はい | 認証されたユーザーが所有するプロジェクトのIDまたはURLエンコードされたパス |
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"
}
]
},
...
]
単一のプロテクトタグまたはワイルドカードのプロテクトタグを取得します。
1つのプロテクトタグまたはワイルドカードのプロテクトタグを取得します。page
およびper_page
のページネーションパラメータを使用して、プロテクトタグのリストを制限することができます。
GET /projects/:id/protected_tags/:name
属性 | タイプ | 必須 | 説明 |
---|---|---|---|
id
| 整数/文字列 | はい | 認証されたユーザーが所有するプロジェクトのIDまたはURLエンコードされたパス |
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"
}
]
}
リポジトリタグの保護
ワイルドカード保護タグを使用して、単一のリポジトリタグまたは複数のプロジェクトリポジトリタグを保護します。
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"
属性 | タイプ | 必須 | 説明 |
---|---|---|---|
id
| 整数/文字列 | はい | 認証されたユーザーが所有するプロジェクトのIDまたはURLエンコードされたパス |
name
| 列 | はい | タグまたはワイルドカードの名前 |
create_access_level
| 列 | いいえ | 作成可能なアクセスレベル (デフォルト:40 , メンテナーのアクセスレベル)
|
回答例
{
"name": "*-stable",
"create_access_levels": [
{
"access_level": 30,
"access_level_description": "Developers + Maintainers"
}
]
}
リポジトリタグの保護解除
指定された protected タグまたはワイルドカード protected タグの保護を解除します。
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"
属性 | タイプ | 必須 | 説明 |
---|---|---|---|
id
| 整数/文字列 | はい | 認証されたユーザーが所有するプロジェクトのIDまたはURLエンコードされたパス |
name
| 列 | はい | タグの名前 |