Maven API

本文是 Maven 软件包的 API 文档。

caution此 API 由 Maven 包管理器客户端使用并且通常不适合手动使用。

有关如何从极狐GitLab 软件包库上传和安装 Maven 包的说明,请参阅 Maven 软件包库文档

note这些端点不遵守标准的 API 身份验证方法。 有关支持的 Header 和令牌类型的详细信息,请参阅 Maven 软件包库文档。将来可能会删除未记录的身份验证方法。

下载实例级的软件包文件

下载 Maven 软件包文件:

GET packages/maven/*path/:file_name
参数 类型 是否必需 描述
path string yes Maven 软件包路径,格式为 <groupId>/<artifactId>/<version>。使用 / 替换 groupId 中的 .
file_name string yes Maven 软件包的名称
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar"

将输出写入文件:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar" >> mypkg-1.0-SNAPSHOT.jar

将下载文件写入到当前目录中的 mypkg-1.0-SNAPSHOT.jar

下载群组级的软件包文件

下载 Maven 软件包文件:

GET groups/:id/-/packages/maven/*path/:file_name
参数 类型 是否必需 描述
path string yes Maven 软件包路径,格式为 <groupId>/<artifactId>/<version>。使用 / 替换 groupId 中的 .
file_name string yes Maven 软件包文件的名称
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/groups/1/-/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar"

将输出写入到文件:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/groups/1/-/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar" >> mypkg-1.0-SNAPSHOT.jar

将下载文件写入到当前目录中的 mypkg-1.0-SNAPSHOT.jar

下载项目级的软件包文件

下载 Maven 软件包文件:

GET projects/:id/packages/maven/*path/:file_name
参数 类型 是否必需 描述
path string yes Maven 软件包路径,格式为 <groupId>/<artifactId>/<version>。使用 / 替换 groupId 中的 .
file_name string yes Maven 软件包文件的名称
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar"

将输出写入到文件:

curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.jar" >> mypkg-1.0-SNAPSHOT.jar

将下载文件写入到当前目录中的 mypkg-1.0-SNAPSHOT.jar

上传软件包文件

上传 Maven 软件包文件:

PUT projects/:id/packages/maven/*path/:file_name
参数 类型 是否必需 描述
path string yes Maven 软件包路径,格式为 <groupId>/<artifactId>/<version>。使用 / 替换 groupId 中的 .
file_name string yes Maven 软件包文件的名称
curl --request PUT \
     --upload-file path/to/mypkg-1.0-SNAPSHOT.pom \
     --header "Private-Token: <personal_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/packages/maven/foo/bar/mypkg/1.0-SNAPSHOT/mypkg-1.0-SNAPSHOT.pom"