InfoGrab DocsInfoGrab Docs

Merge requests

요약

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated 별칭 approvedBy와 approvers가 GitLab 18.0에서 도입됨. Nullable 값 지원이 GitLab 18.3에서 도입됨.


Merge requests#

  - 
  Tier: Free, Premium, Ultimate

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

History

허용 범위#

범위 설명
project 특정 프로젝트의 머지 리퀘스트를 조회합니다.
group 하위 그룹을 포함하여 그룹 내 모든 프로젝트의 머지 리퀘스트를 조회합니다.

자세한 내용은 범위를 참조하세요.

쿼리 필드#

필드 이름 (및 별칭) 연산자
사용자별 승인 approver, approvedBy, approvers =, !=
담당자 assignee, assignees =, !=
작성자 author =, !=
종료 시각 closed, closedAt =, >, <, >=, <=
생성 시각 created, createdAt, opened, openedAt =, >, <, >=, <=
드래프트 draft =, !=
환경 environment =
ID id =, in
하위 그룹 포함 includeSubgroups =, !=
라벨 label, labels =, !=
머지 시각 merged, mergedAt =, >, <, >=, <=
머지한 사용자 merger, mergedBy =
마일스톤 milestone =, !=
나의 반응 이모지 myReaction, myReactionEmoji =, !=
리뷰어 reviewer, reviewers, reviewedBy =, !=
소스 브랜치 sourceBranch =, in, !=
상태 state =
구독 여부 subscribed =, !=
타깃 브랜치 targetBranch =, in, !=
배포 시각 deployed, deployedAt =, >, <, >=, <=
업데이트 시각 updated, updatedAt =, >, <, >=, <=

사용자별 승인#

History

  • GitLab 17.8에서 도입됨.

  • 별칭 approvedByapprovers가 GitLab 18.0에서 도입됨.

  • Nullable 값 지원이 GitLab 18.3에서 도입됨.

설명: 머지 리퀘스트를 승인한 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

  • List (String 또는 User 값 포함)

  • Nullable (null, none, any 중 하나)

담당자#

설명: 담당자로 지정된 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

  • Nullable (null, none, any 중 하나)

참고:

  • List 값과 in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

작성자#

설명: 작성자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

참고:

  • in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

종료 시각#

설명: 머지 리퀘스트가 종료된 날짜를 기준으로 조회합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<sign><digit><unit> 형식, 여기서 sign은 +, -, 또는 생략 가능,

digit은 정수이며, unitd(일), w(주), m(월), y(년) 중 하나입니다)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

생성일#

설명: 머지 리퀘스트가 생성된 날짜로 쿼리합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<sign><digit><unit> 형식으로, sign은 +, -, 또는 생략 가능하며, digit은 정수이고, unitd(일), w(주), m(월), y(년) 중 하나입니다)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

드래프트#

History

설명: 머지 리퀘스트를 드래프트 상태로 쿼리합니다.

허용 값 유형:

  • Boolean (true 또는 false)

배포일#

설명: 머지 리퀘스트가 배포된 날짜로 쿼리합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<sign><digit><unit> 형식으로, sign은 +, -, 또는 생략 가능하며, digit은 정수이고, unitd(일), w(주), m(월), y(년) 중 하나입니다)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

환경#

History

설명: 머지 리퀘스트가 배포된 환경으로 쿼리합니다.

허용 값 유형: String

ID#

설명: 머지 리퀘스트를 ID로 쿼리합니다.

허용 값 유형:

  • Number (양의 정수만 허용)

  • List (Number 값을 포함하는 목록)

하위 그룹 포함#

설명: 그룹의 전체 계층 구조에서 머지 리퀘스트를 쿼리합니다.

허용 값 유형:

  • Boolean (true 또는 false)

참고 사항:

  • 이 필드는 group 범위에서만 사용할 수 있습니다.

  • 이 필드의 기본값은 false입니다.

라벨#

설명: 머지 리퀘스트를 연관된 라벨로 쿼리합니다.

허용 값 유형:

  • String

  • Label (예: ~bug, ~"team::planning")

  • Nullable (none 또는 any)

참고 사항:

  • in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

  • 범위 지정 라벨 또는 공백이 포함된 라벨은 따옴표로 묶어야 합니다.

머지일#

History

설명: 머지 리퀘스트가 머지된 날짜로 쿼리합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<부호><숫자><단위> 형식, 부호는 +, - 또는 생략 가능, 숫자는 정수, 단위d(일), w(주), m(월), y(년) 중 하나)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00부터 23:59까지로 간주됩니다.

  • >=<= 연산자는 조회 날짜를 포함하며, ><는 포함하지 않습니다.

머지한 사용자#

History

설명: 머지 리퀘스트를 머지한 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

마일스톤#

설명: 연결된 마일스톤을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • Milestone (예: %Backlog, %"Awaiting Further Demand")

  • Nullable (none 또는 any 중 하나)

참고 사항:

  • in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

  • 공백이 포함된 마일스톤은 큰따옴표(")로 감싸야 합니다.

나의 반응 이모지#

설명: 현재 사용자가 해당 머지 리퀘스트에 남긴 이모지 반응을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String

리뷰어#

History

  • 별칭 reviewersreviewedBy가 GitLab 18.0에서 도입됨.

설명: 한 명 이상의 사용자가 리뷰한 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

  • Nullable (null, none, 또는 any 중 하나)

소스 브랜치#

History

설명: 소스 브랜치를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String, List

참고 사항:

  • List 값은 in!= 연산자에서만 지원됩니다.

상태#

설명: 상태를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • Enum, opened, closed, merged, 또는 all 중 하나

참고 사항:

  • state 필드는 != 연산자를 지원하지 않습니다.

구독됨#

설명: 현재 사용자가 알림을 설정했는지 여부를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: Boolean

타깃 브랜치#

History

설명: 타깃 브랜치를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String, List

참고 사항:

  • List 값은 in!= 연산자에서만 지원됩니다.

업데이트 날짜#

설명: 마지막으로 업데이트된 날짜를 기준으로 머지 리퀘스트를 쿼리합니다.

허용되는 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<부호><숫자><단위> 형식, 부호는 +, -, 또는 생략 가능, 숫자는 정수, 단위d(일), w(주), m(월), y(년) 중 하나)

참고 사항:

  • = 연산자를 사용하는 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

표시 필드#

History

  • GitLab 17.8에서 도입됨.

  • 필드 sourceBranch, targetBranch, sourceProject, targetProject는 GitLab 18.2에서 도입됨.

필드 이름 또는 별칭 설명
Approved approved 머지 리퀘스트의 승인 여부를 Yes 또는 No로 표시
Approved by user approver, approvers, approvedBy 머지 리퀘스트를 승인한 사용자 표시
Assignees assignee, assignees 머지 리퀘스트에 할당된 사용자 표시
Author author 머지 리퀘스트 작성자 표시
Closed at closed, closedAt 머지 리퀘스트가 닫힌 이후 경과 시간 표시
Created at created, createdAt 머지 리퀘스트가 생성된 이후 경과 시간 표시
Description description 머지 리퀘스트의 설명 표시
Draft draft 머지 리퀘스트가 초안 상태인지 여부를 Yes 또는 No로 표시
ID id 머지 리퀘스트의 ID 표시
Labels label, labels 머지 리퀘스트에 연결된 라벨 표시
Last comment lastComment 머지 리퀘스트에 달린 마지막 댓글 표시
Merged at merged, mergedAt 머지 리퀘스트가 머지된 이후 경과 시간 표시
Merged by user merger, mergedBy 머지 리퀘스트를 머지한 사용자 표시
Milestone milestone 머지 리퀘스트에 연결된 마일스톤 표시
Project project 머지 리퀘스트가 속한 프로젝트 표시
Reviewers reviewer, reviewers 머지 리퀘스트 리뷰에 할당된 사용자 표시
Source branch sourceBranch 머지 리퀘스트의 소스 브랜치 표시
Source project sourceProject 머지 리퀘스트의 소스 프로젝트 표시
State state 상태를 나타내는 배지 표시. 값은 Open, Closed, Merged
Subscribed subscribed 현재 사용자의 구독 여부를 Yes 또는 No로 표시
Target branch targetBranch 머지 리퀘스트의 타깃 브랜치 표시
Target project targetProject 머지 리퀘스트의 타깃 프로젝트 표시
Time estimate timeEstimate 머지 리퀘스트의 예상 소요 시간 표시
Title title 머지 리퀘스트의 제목 표시
Total time spent totalTimeSpent 머지 리퀘스트에 소요된 총 시간 표시
Updated at updated, updatedAt 머지 리퀘스트가 마지막으로 업데이트된 이후 경과 시간 표시

정렬 필드#

필드 이름(및 별칭) 설명
Closed at closed, closedAt 닫힌 날짜 기준 정렬
Created created, createdAt 생성 날짜 기준 정렬
Merged at merged, mergedAt 머지 날짜 기준 정렬
Milestone milestone 마일스톤 만료일 기준 정렬
Popularity popularity 엄지 위 이모지 반응 수 기준 정렬
Title title 제목 기준 정렬
Updated at updated, updatedAt 마지막 업데이트 날짜 기준 정렬

예시#

gitlab-org 그룹에서 내가 생성한 모든 머지 리퀘스트를 머지 날짜(최신순) 기준으로 정렬하여 나열합니다:

```glql
display: table
fields: title, reviewer, merged
sort: merged desc
query: group = "gitlab-org" and type = MergeRequest and state = merged and author = currentUser()
limit: 10

Merge requests

GitLab v19.1
원문 보기
요약

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated 별칭 approvedBy와 approvers가 GitLab 18.0에서 도입됨. Nullable 값 지원이 GitLab 18.3에서 도입됨.


Merge requests#

  - 
  Tier: Free, Premium, Ultimate

- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

History

허용 범위#

범위 설명
project 특정 프로젝트의 머지 리퀘스트를 조회합니다.
group 하위 그룹을 포함하여 그룹 내 모든 프로젝트의 머지 리퀘스트를 조회합니다.

자세한 내용은 범위를 참조하세요.

쿼리 필드#

필드 이름 (및 별칭) 연산자
사용자별 승인 approver, approvedBy, approvers =, !=
담당자 assignee, assignees =, !=
작성자 author =, !=
종료 시각 closed, closedAt =, >, <, >=, <=
생성 시각 created, createdAt, opened, openedAt =, >, <, >=, <=
드래프트 draft =, !=
환경 environment =
ID id =, in
하위 그룹 포함 includeSubgroups =, !=
라벨 label, labels =, !=
머지 시각 merged, mergedAt =, >, <, >=, <=
머지한 사용자 merger, mergedBy =
마일스톤 milestone =, !=
나의 반응 이모지 myReaction, myReactionEmoji =, !=
리뷰어 reviewer, reviewers, reviewedBy =, !=
소스 브랜치 sourceBranch =, in, !=
상태 state =
구독 여부 subscribed =, !=
타깃 브랜치 targetBranch =, in, !=
배포 시각 deployed, deployedAt =, >, <, >=, <=
업데이트 시각 updated, updatedAt =, >, <, >=, <=

사용자별 승인#

History

  • GitLab 17.8에서 도입됨.

  • 별칭 approvedByapprovers가 GitLab 18.0에서 도입됨.

  • Nullable 값 지원이 GitLab 18.3에서 도입됨.

설명: 머지 리퀘스트를 승인한 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

  • List (String 또는 User 값 포함)

  • Nullable (null, none, any 중 하나)

담당자#

설명: 담당자로 지정된 한 명 이상의 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

  • Nullable (null, none, any 중 하나)

참고:

  • List 값과 in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

작성자#

설명: 작성자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

참고:

  • in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

종료 시각#

설명: 머지 리퀘스트가 종료된 날짜를 기준으로 조회합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<sign><digit><unit> 형식, 여기서 sign은 +, -, 또는 생략 가능,

digit은 정수이며, unitd(일), w(주), m(월), y(년) 중 하나입니다)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

생성일#

설명: 머지 리퀘스트가 생성된 날짜로 쿼리합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<sign><digit><unit> 형식으로, sign은 +, -, 또는 생략 가능하며, digit은 정수이고, unitd(일), w(주), m(월), y(년) 중 하나입니다)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

드래프트#

History

설명: 머지 리퀘스트를 드래프트 상태로 쿼리합니다.

허용 값 유형:

  • Boolean (true 또는 false)

배포일#

설명: 머지 리퀘스트가 배포된 날짜로 쿼리합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<sign><digit><unit> 형식으로, sign은 +, -, 또는 생략 가능하며, digit은 정수이고, unitd(일), w(주), m(월), y(년) 중 하나입니다)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

환경#

History

설명: 머지 리퀘스트가 배포된 환경으로 쿼리합니다.

허용 값 유형: String

ID#

설명: 머지 리퀘스트를 ID로 쿼리합니다.

허용 값 유형:

  • Number (양의 정수만 허용)

  • List (Number 값을 포함하는 목록)

하위 그룹 포함#

설명: 그룹의 전체 계층 구조에서 머지 리퀘스트를 쿼리합니다.

허용 값 유형:

  • Boolean (true 또는 false)

참고 사항:

  • 이 필드는 group 범위에서만 사용할 수 있습니다.

  • 이 필드의 기본값은 false입니다.

라벨#

설명: 머지 리퀘스트를 연관된 라벨로 쿼리합니다.

허용 값 유형:

  • String

  • Label (예: ~bug, ~"team::planning")

  • Nullable (none 또는 any)

참고 사항:

  • in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

  • 범위 지정 라벨 또는 공백이 포함된 라벨은 따옴표로 묶어야 합니다.

머지일#

History

설명: 머지 리퀘스트가 머지된 날짜로 쿼리합니다.

허용 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<부호><숫자><단위> 형식, 부호는 +, - 또는 생략 가능, 숫자는 정수, 단위d(일), w(주), m(월), y(년) 중 하나)

참고 사항:

  • = 연산자의 경우, 시간 범위는 사용자의 시간대 기준 00:00부터 23:59까지로 간주됩니다.

  • >=<= 연산자는 조회 날짜를 포함하며, ><는 포함하지 않습니다.

머지한 사용자#

History

설명: 머지 리퀘스트를 머지한 사용자를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

마일스톤#

설명: 연결된 마일스톤을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • Milestone (예: %Backlog, %"Awaiting Further Demand")

  • Nullable (none 또는 any 중 하나)

참고 사항:

  • in 연산자는 머지 리퀘스트에서 지원되지 않습니다.

  • 공백이 포함된 마일스톤은 큰따옴표(")로 감싸야 합니다.

나의 반응 이모지#

설명: 현재 사용자가 해당 머지 리퀘스트에 남긴 이모지 반응을 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String

리뷰어#

History

  • 별칭 reviewersreviewedBy가 GitLab 18.0에서 도입됨.

설명: 한 명 이상의 사용자가 리뷰한 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • String

  • User (예: @username)

  • Nullable (null, none, 또는 any 중 하나)

소스 브랜치#

History

설명: 소스 브랜치를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String, List

참고 사항:

  • List 값은 in!= 연산자에서만 지원됩니다.

상태#

설명: 상태를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형:

  • Enum, opened, closed, merged, 또는 all 중 하나

참고 사항:

  • state 필드는 != 연산자를 지원하지 않습니다.

구독됨#

설명: 현재 사용자가 알림을 설정했는지 여부를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: Boolean

타깃 브랜치#

History

설명: 타깃 브랜치를 기준으로 머지 리퀘스트를 조회합니다.

허용 값 유형: String, List

참고 사항:

  • List 값은 in!= 연산자에서만 지원됩니다.

업데이트 날짜#

설명: 마지막으로 업데이트된 날짜를 기준으로 머지 리퀘스트를 쿼리합니다.

허용되는 값 유형:

  • AbsoluteDate (YYYY-MM-DD 형식)

  • RelativeDate (<부호><숫자><단위> 형식, 부호는 +, -, 또는 생략 가능, 숫자는 정수, 단위d(일), w(주), m(월), y(년) 중 하나)

참고 사항:

  • = 연산자를 사용하는 경우, 시간 범위는 사용자의 시간대 기준 00:00~23:59로 간주됩니다.

  • >=<= 연산자는 쿼리 대상 날짜를 포함하지만, ><는 포함하지 않습니다.

표시 필드#

History

  • GitLab 17.8에서 도입됨.

  • 필드 sourceBranch, targetBranch, sourceProject, targetProject는 GitLab 18.2에서 도입됨.

필드 이름 또는 별칭 설명
Approved approved 머지 리퀘스트의 승인 여부를 Yes 또는 No로 표시
Approved by user approver, approvers, approvedBy 머지 리퀘스트를 승인한 사용자 표시
Assignees assignee, assignees 머지 리퀘스트에 할당된 사용자 표시
Author author 머지 리퀘스트 작성자 표시
Closed at closed, closedAt 머지 리퀘스트가 닫힌 이후 경과 시간 표시
Created at created, createdAt 머지 리퀘스트가 생성된 이후 경과 시간 표시
Description description 머지 리퀘스트의 설명 표시
Draft draft 머지 리퀘스트가 초안 상태인지 여부를 Yes 또는 No로 표시
ID id 머지 리퀘스트의 ID 표시
Labels label, labels 머지 리퀘스트에 연결된 라벨 표시
Last comment lastComment 머지 리퀘스트에 달린 마지막 댓글 표시
Merged at merged, mergedAt 머지 리퀘스트가 머지된 이후 경과 시간 표시
Merged by user merger, mergedBy 머지 리퀘스트를 머지한 사용자 표시
Milestone milestone 머지 리퀘스트에 연결된 마일스톤 표시
Project project 머지 리퀘스트가 속한 프로젝트 표시
Reviewers reviewer, reviewers 머지 리퀘스트 리뷰에 할당된 사용자 표시
Source branch sourceBranch 머지 리퀘스트의 소스 브랜치 표시
Source project sourceProject 머지 리퀘스트의 소스 프로젝트 표시
State state 상태를 나타내는 배지 표시. 값은 Open, Closed, Merged
Subscribed subscribed 현재 사용자의 구독 여부를 Yes 또는 No로 표시
Target branch targetBranch 머지 리퀘스트의 타깃 브랜치 표시
Target project targetProject 머지 리퀘스트의 타깃 프로젝트 표시
Time estimate timeEstimate 머지 리퀘스트의 예상 소요 시간 표시
Title title 머지 리퀘스트의 제목 표시
Total time spent totalTimeSpent 머지 리퀘스트에 소요된 총 시간 표시
Updated at updated, updatedAt 머지 리퀘스트가 마지막으로 업데이트된 이후 경과 시간 표시

정렬 필드#

필드 이름(및 별칭) 설명
Closed at closed, closedAt 닫힌 날짜 기준 정렬
Created created, createdAt 생성 날짜 기준 정렬
Merged at merged, mergedAt 머지 날짜 기준 정렬
Milestone milestone 마일스톤 만료일 기준 정렬
Popularity popularity 엄지 위 이모지 반응 수 기준 정렬
Title title 제목 기준 정렬
Updated at updated, updatedAt 마지막 업데이트 날짜 기준 정렬

예시#

gitlab-org 그룹에서 내가 생성한 모든 머지 리퀘스트를 머지 날짜(최신순) 기준으로 정렬하여 나열합니다:

```glql
display: table
fields: title, reviewer, merged
sort: merged desc
query: group = "gitlab-org" and type = MergeRequest and state = merged and author = currentUser()
limit: 10