Search API

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

이 API를 사용하여 GitLab 전체에서 검색 할 수 있습니다. 이 API에 대한 모든 호출에는 인증이 필요합니다. 일부 스코프는 기본 검색 에서 사용할 수 있습니다. 고급 검색 또는 정확한 코드 검색 이 활성화된 경우, 전역 검색 , 그룹 검색 , 프로젝트 검색 작업에서 추가 스코프를 사용할 수 있습니다. 기본 검색을 대신 사용하려면 검색 유형 지정 을 참고합니다. Search API는 오프셋 기반 페이지네이션 을 지원합니다. 고급 검색에서는 최대 10,000건의 결과( page 곱하기 per_page )를 가져올 수 있습니다. 이 한도를 넘는 요청은 next 링크가 없는 빈 페이지를 반환하므로, 빈 응답을 받을 때까지 페이지를 넘기는 클라이언트는 이 한도에서 멈춥니다. 기본 검색과 정확한 코드 검색은 영향을 받지 않습니다. GitLab이 해당 설정을 읽지 않으므로, Elasticsearch 클러스터에서 index.max_result_window 값을 올려도 한도는 늘어나지 않습니다. 인스턴스 검색 # GitLab 인스턴스 전체에서 용어 를 검색합니다. 응답은 요청된 스코프에 따라 달라집니다. GET /search Attribute Type Required Description scope string Yes 검색할 스코프. 값에는 projects , groups , 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 결과에서 각 일치 항목 주변에 포함할 컨텍스트 라인 수. 고급 검색 및 정확한 코드 검색에서