Feature flag user lists API

요약

이 API를 사용하여 사용자 목록에 대한 GitLab 기능 플래그와 상호작용합니다. 모든 사용자에 대한 기능 플래그와 상호작용하려면 기능 플래그 API를 참조하세요. 요청된 프로젝트의 모든 기능 플래그 사용자 목록을 조회합니다.

히스토리

GitLab Premium 12.10에서 도입되었습니다.
GitLab Free 13.5에서 이동되었습니다.

이 API를 사용하여 사용자 목록에 대한 GitLab 기능 플래그와 상호작용합니다.

전제 조건:

Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

Note

모든 사용자에 대한 기능 플래그와 상호작용하려면 기능 플래그 API를 참조하세요.

프로젝트의 모든 기능 플래그 사용자 목록 나열#

요청된 프로젝트의 모든 기능 플래그 사용자 목록을 조회합니다.

GET /projects/:id/feature_flags_user_lists

page 및 per_page 페이지네이션 파라미터를 사용하여 결과 페이지네이션을 제어합니다.

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`search`	문자열	아니요	검색 기준에 일치하는 사용자 목록을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "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"
   }
]

기능 플래그 사용자 목록 생성#

기능 플래그 사용자 목록을 생성합니다.

POST /projects/:id/feature_flags_user_lists

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`name`	문자열	예	목록의 이름.
`user_xids`	문자열	예	쉼표로 구분된 외부 사용자 ID 목록.

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-type: application/json" \
  --url "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists" \
  --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 /projects/:id/feature_flags_user_lists/:iid

page 및 per_page 페이지네이션 파라미터를 사용하여 결과 페이지네이션을 제어합니다.

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`iid`	정수 또는 문자열	예	프로젝트의 기능 플래그 사용자 목록의 내부 ID.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "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"
}

기능 플래그 사용자 목록 업데이트#

기능 플래그 사용자 목록을 업데이트합니다.

PUT /projects/:id/feature_flags_user_lists/:iid

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`iid`	정수 또는 문자열	예	프로젝트의 기능 플래그 사용자 목록의 내부 ID.
`name`	문자열	아니요	목록의 이름.
`user_xids`	문자열	아니요	쉼표로 구분된 외부 사용자 ID 목록.

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-type: application/json" \
  --url "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1" \
  --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 /projects/:id/feature_flags_user_lists/:iid

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`iid`	정수 또는 문자열	예	프로젝트의 기능 플래그 사용자 목록의 내부 ID.

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1"

Feature flag user lists API

Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-05-22

요약

히스토리

GitLab Premium 12.10에서 도입되었습니다.
GitLab Free 13.5에서 이동되었습니다.

이 API를 사용하여 사용자 목록에 대한 GitLab 기능 플래그와 상호작용합니다.

전제 조건:

Developer, Maintainer 또는 Owner 역할이 있어야 합니다.

Note

모든 사용자에 대한 기능 플래그와 상호작용하려면 기능 플래그 API를 참조하세요.

프로젝트의 모든 기능 플래그 사용자 목록 나열#

요청된 프로젝트의 모든 기능 플래그 사용자 목록을 조회합니다.

GET /projects/:id/feature_flags_user_lists

page 및 per_page 페이지네이션 파라미터를 사용하여 결과 페이지네이션을 제어합니다.

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`search`	문자열	아니요	검색 기준에 일치하는 사용자 목록을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "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"
   }
]

기능 플래그 사용자 목록 생성#

기능 플래그 사용자 목록을 생성합니다.

POST /projects/:id/feature_flags_user_lists

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`name`	문자열	예	목록의 이름.
`user_xids`	문자열	예	쉼표로 구분된 외부 사용자 ID 목록.

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-type: application/json" \
  --url "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists" \
  --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 /projects/:id/feature_flags_user_lists/:iid

page 및 per_page 페이지네이션 파라미터를 사용하여 결과 페이지네이션을 제어합니다.

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`iid`	정수 또는 문자열	예	프로젝트의 기능 플래그 사용자 목록의 내부 ID.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "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"
}

기능 플래그 사용자 목록 업데이트#

기능 플래그 사용자 목록을 업데이트합니다.

PUT /projects/:id/feature_flags_user_lists/:iid

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`iid`	정수 또는 문자열	예	프로젝트의 기능 플래그 사용자 목록의 내부 ID.
`name`	문자열	아니요	목록의 이름.
`user_xids`	문자열	아니요	쉼표로 구분된 외부 사용자 ID 목록.

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-type: application/json" \
  --url "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1" \
  --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 /projects/:id/feature_flags_user_lists/:iid

속성	유형	필수 여부	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL-인코딩된 경로.
`iid`	정수 또는 문자열	예	프로젝트의 기능 플래그 사용자 목록의 내부 ID.

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1"