# Feature flag user lists API > 原文：[https://docs.gitlab.com/ee/api/feature_flag_user_lists.html](https://docs.gitlab.com/ee/api/feature_flag_user_lists.html) * [List all feature flag user lists for a project](#list-all-feature-flag-user-lists-for-a-project) * [Create a feature flag user list](#create-a-feature-flag-user-list) * [Get a feature flag user list](#get-a-feature-flag-user-list) * [Update a feature flag user list](#update-a-feature-flag-user-list) * [Delete feature flag user list](#delete-feature-flag-user-list) # Feature flag user lists API[](#feature-flag-user-lists-api-premium "Permalink") [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/205409) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.10. 用于訪問 GitLab 功能標志用戶列表的 API. 具有開發者或更高[權限的用戶](../user/permissions.html)可以訪問功能標志用戶列表 API. **注意：** `GET`請求一次返回 20 個結果，因為 API 結果是[分頁的](README.html#pagination) . 您可以更改此值. ## List all feature flag user lists for a project[](#list-all-feature-flag-user-lists-for-a-project "Permalink") 獲取所請求項目的所有功能標志用戶列表. ``` GET /projects/:id/feature_flags_user_lists ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼的路徑](README.html#namespaced-path-encoding) . | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists" ``` 響應示例： ``` [ { "name": "user_list", "user_xids": "user1,user2", "id": 1, "iid": 1, "project_id": 1, "created_at": "2020-02-04T08:13:51.423Z", "updated_at": "2020-02-04T08:13:51.423Z" }, { "name": "test_users", "user_xids": "user3,user4,user5", "id": 2, "iid": 2, "project_id": 1, "created_at": "2020-02-04T08:13:10.507Z", "updated_at": "2020-02-04T08:13:10.507Z" } ] ``` ## Create a feature flag user list[](#create-a-feature-flag-user-list "Permalink") 創建功能標記用戶列表. ``` POST /projects/:id/feature_flags_user_lists ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼的路徑](README.html#namespaced-path-encoding) . | | `name` | string | yes | 功能標志的名稱. | | `user_xids` | string | yes | 以逗號分隔的用戶 ID 列表. | ``` curl "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists" \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-type: application/json" \ --data @- << EOF { "name": "my_user_list", "user_xids": "user1,user2,user3" } EOF ``` 響應示例： ``` { "name": "my_user_list", "user_xids": "user1,user2,user3", "id": 1, "iid": 1, "project_id": 1, "created_at": "2020-02-04T08:32:27.288Z", "updated_at": "2020-02-04T08:32:27.288Z" } ``` ## Get a feature flag user list[](#get-a-feature-flag-user-list "Permalink") 獲取功能標志用戶列表. ``` GET /projects/:id/feature_flags_user_lists/:iid ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼的路徑](README.html#namespaced-path-encoding) . | | `iid` | integer/string | yes | 項目的功能標志用戶列表的內部 ID. | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1" ``` 響應示例： ``` { "name": "my_user_list", "user_xids": "123,456", "id": 1, "iid": 1, "project_id": 1, "created_at": "2020-02-04T08:13:10.507Z", "updated_at": "2020-02-04T08:13:10.507Z", } ``` ## Update a feature flag user list[](#update-a-feature-flag-user-list "Permalink") 更新功能標志用戶列表. ``` PUT /projects/:id/feature_flags_user_lists/:iid ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼的路徑](README.html#namespaced-path-encoding) . | | `iid` | integer/string | yes | 項目的功能標志用戶列表的內部 ID. | | `name` | string | no | 功能標志的名稱. | | `user_xids` | string | no | 以逗號分隔的用戶 ID 列表. | ``` curl "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1" \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-type: application/json" \ --request PUT \ --data @- << EOF { "user_xids": "user2,user3,user4" } EOF ``` 響應示例： ``` { "name": "my_user_list", "user_xids": "user2,user3,user4", "id": 1, "iid": 1, "project_id": 1, "created_at": "2020-02-04T08:32:27.288Z", "updated_at": "2020-02-05T09:33:17.179Z" } ``` ## Delete feature flag user list[](#delete-feature-flag-user-list "Permalink") 刪除功能標志用戶列表. ``` DELETE /projects/:id/feature_flags_user_lists/:iid ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼的路徑](README.html#namespaced-path-encoding) . | | `iid` | integer/string | yes | 項目的功能標志用戶列表的內部 ID | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" --request DELETE "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1" ```