피처 플래그 user lists API

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

GitLab feature flag 사용자 디렉터리에 액세스할 수 있는 API입니다. 최소한 Developer 역할을 가진 사용자는 feature flag 사용자 디렉터리 API에 액세스할 수 있습니다.

note
GET 요청은 API 결과가 페이지별로 20개씩 반환되므로 이 값을 변경할 수 있습니다.

프로젝트의 모든 feature flag 사용자 디렉터리 나열

요청된 프로젝트에 대한 feature flag 사용자 디렉터리을 모두 가져옵니다. 

GET /projects/:id/feature_flags_user_lists
속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
search 문자열 아니오 검색 기준과 일치하는 사용자 디렉터리 반환. 
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"
   }
]

feature flag 사용자 디렉터리 생성

feature flag 사용자 디렉터리을 생성합니다. 

POST /projects/:id/feature_flags_user_lists
속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
name 문자열 예 디렉터리 이름.
user_xids 문자열 예 외부 사용자 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"
}

feature flag 사용자 디렉터리 가져오기

feature flag 사용자 디렉터리을 가져옵니다. 

GET /projects/:id/feature_flags_user_lists/:iid
속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
iid 정수/문자열 예 프로젝트의 feature flag 사용자 디렉터리의 내부 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"
}

feature flag 사용자 디렉터리 업데이트

feature flag 사용자 디렉터리을 업데이트합니다. 

PUT /projects/:id/feature_flags_user_lists/:iid
속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
iid 정수/문자열 예 프로젝트의 feature flag 사용자 디렉터리의 내부 ID.
name 문자열 아니오 디렉터리 이름.
user_xids 문자열 아니오 외부 사용자 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 /projects/:id/feature_flags_user_lists/:iid
속성 유형 필수여부 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL-encoded path.
iid 정수/문자열 예 프로젝트의 특징 플래그 사용자 디렉터리의 내부 ID 
curl --header "PRIVATE-TOKEN: <your_access_token>" --request DELETE "https://gitlab.example.com/api/v4/projects/1/feature_flags_user_lists/1"