Search API

GitLab REST API를 사용하여 인스턴스, 그룹, 프로젝트 범위에서 다양한 스코프로 검색하는 방법을 설명합니다.

이 API를 사용하여 GitLab 전체에서 검색 할 수 있습니다. 이 API에 대한 모든 호출에는 인증이 필요합니다. 일부 스코프는 기본 검색(basic search) 에서 사용할 수 있습니다. 고급 검색(advanced search) 또는 정확한 코드 검색(exact code search) 이 활성화된 경우, 전역 검색 , 그룹 검색 , 프로젝트 검색 작업에서 추가 스코프를 사용할 수 있습니다. 기본 검색을 대신 사용하려면 검색 유형 지정 을 참고하세요. Search API는 오프셋 기반 페이지네이션 을 지원합니다. 인스턴스 검색 # GitLab 인스턴스 전체에서 용어 를 검색합니다. 응답은 요청된 스코프에 따라 달라집니다. GET /search Attribute Type Required Description scope string Yes 검색할 스코프. 값에는 projects, issues, work_items, merge_requests, milestones, snippet_titles, users가 포함됩니다. 추가 스코프로는 wiki_blobs, commits, blobs, notes가 있습니다. search string Yes 검색어. search_type string No 사용할 검색 유형. 값에는 basic, advanced, zoekt가 포함됩니다. confidential boolean No 기밀성으로 필터링합니다. issues 및 work_items 스코프를 지원하며, 다른 스코프는 무시됩니다. exclude_forks boolean No 검색에서 포크된 프로젝트를 제외합니다. 정확한 코드 검색에서 사용 가능합니다. 설정하지 않으면 포크가 제외됩니다. GitLab 18.7에서 도입됨. regex boolean No 코드 검색 시 정규 표현식을 사용합니다. 정확한 코드 검색에서 사용 가능합니다. 설정하지 않으면 정규 표현식이 사용됩니다. GitLab 18.9에서 도입됨. fields array of strings No 검색할 필드의 배열로, 허용되는 값은 title만 해당합니다. issues 및 merge_requests 스코프만 지원됩니다. Premium 및 Ultimate 전용. include_archived boolean No 검색에 아카이브된 프로젝트를 포함합니다. 기본값은 false입니다. GitLab 18.7에서 도입됨. num_context_lines integer No 결과에서 각 일치 항목 주변에 포함할 컨텍스트 라인 수. 고급 검색 및 정확한 코드 검색에서만 사용 가능합니다. GitLab 18.11에서 도입됨. state string No 상태로 필터링합니다. issues, work_items, merge_requests 스코프를 지원하며, 다른 스코프는 무시됩니다. type array of strings No 유형별로 워크 아이템을 필터링합니다. work_items 스코프에만 적용됩니다. 사용 가능한 유형: issue, task, epic, incident, test_case, requirement,