# 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" 
```