Dependencies API
Tier: Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated
이 API는 실험 중이며 불안정하다고 간주됩니다.
응답 페이로드는 GitLab 릴리스 간에 변경되거나 손상될 수 있습니다.
- GitLab 12.1에 도입되었습니다.
- 페이지네이션은 14.4에서 도입되었습니다.
이 엔드포인트에 대한 모든 호출에는 인증이 필요합니다. 이 호출을 수행하려면 사용자는 리포지터리를 읽을 권한이 있어야 합니다. 응답에서 취약점을 보려면 사용자는 프로젝트 보안 대시보드를 읽을 수 있는 권한이 있어야 합니다.
프로젝트 의존성 디렉터리
프로젝트 의존성 디렉터리을 가져옵니다. 이 API는 Dependency List 기능을 부분적으로 반영합니다. 이 디렉터리은 Gemnasium에서 지원되는 언어 및 패키지 관리자에 대해서만 생성할 수 있습니다.
GET /projects/:id/dependencies
GET /projects/:id/dependencies?package_manager=maven
GET /projects/:id/dependencies?package_manager=yarn,bundler
속성 | 유형 | 필수 | 설명 |
---|---|---|---|
id
| 정수/문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로. |
package_manager
| 문자열 배열 | 아니오 | 지정된 패키지 관리자에 속한 의존성을 반환합니다. 유효한 값: bundler , composer , conan , go , gradle , maven , npm , nuget , pip , pipenv , pnpm , yarn , sbt , 또는 setuptools .
|
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/dependencies"
응답 예시:
[
{
"name": "rails",
"version": "5.0.1",
"package_manager": "bundler",
"dependency_file_path": "Gemfile.lock",
"vulnerabilities": [
{
"name": "DDoS",
"severity": "unknown",
"id": 144827,
"url": "https://gitlab.example.com/group/project/-/security/vulnerabilities/144827"
}
],
"licenses": [
{
"name": "MIT",
"url": "https://opensource.org/licenses/MIT"
}
]
},
{
"name": "hanami",
"version": "1.3.1",
"package_manager": "bundler",
"dependency_file_path": "Gemfile.lock",
"vulnerabilities": [],
"licenses": [
{
"name": "MIT",
"url": "https://opensource.org/licenses/MIT"
}
]
}
]
의존성 페이지네이션
기본적으로 GET
요청은 API 결과가 페이지별로 20개씩 반환합니다.
자세한 내용은 페이지네이션을 참조하세요.