Go 代理 API
本文是 Go 软件包的 API 文档。 此 API 位于默认禁用的功能标志后面。有权访问极狐GitLab Rails 控制台的极狐GitLab 管理员可以为您的极狐GitLab 实例启用此 API。
Go 客户端使用此 API 并且通常不适合手动使用。
有关如何使用 Go 代理的说明，请参阅 Go 代理包文档。
这些端点不遵守标准的 API 身份验证方法。
有关支持的 Header 和令牌类型的详细信息，请参阅 Go 代理包文档。将来可能会删除未记录的身份验证方法。
列表
引入于极狐GitLab 13.1。
获取特定 Go 模块的所有打标签的版本。
GET projects/:id/packages/go/:module_name/@v/list
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
id |
string | yes | 项目的 ID 或完整路径 |
module_name |
string | yes | Go 模块的名称 |
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/list"
输出示例：
"v1.0.0\nv1.0.1\nv1.3.8\n2.0.0\n2.1.0\n3.0.0"
版本元数据
引入于极狐GitLab 13.1。
获取特定 Go 模块的所有打标签的版本：
GET projects/:id/packages/go/:module_name/@v/:module_version.info
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
id |
string | yes | 项目的 ID 或完整路径 |
module_name |
string | yes | Go 模块的名称 |
module_version |
string | yes | Go 模块的版本 |
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.info"
输出示例：
{
"Version": "v1.0.0",
"Time": "1617822312 -0600"
}
下载模块文件
引入于极狐GitLab 13.1。
获取 .mod 模块文件：
GET projects/:id/packages/go/:module_name/@v/:module_version.mod
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
id |
string | yes | 项目的 ID 或完整路径 |
module_name |
string | yes | Go 模块的名称 |
module_version |
string | yes | Go 模块的版本 |
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.mod"
写入文件：
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.mod" >> foo.mod
写入当前目录中的 foo.mod。
下载模块来源
引入于极狐GitLab 13.1。
获取模块来源的 .zip：
GET projects/:id/packages/go/:module_name/@v/:module_version.zip
| 参数 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
id |
string | yes | 项目的 ID 或完整路径 |
module_name |
string | yes | Go 模块的名称 |
module_version |
string | yes | Go 模块的版本 |
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.zip"
写入文件：
curl --header "Private-Token: <personal_access_token>" "https://gitlab.example.com/api/v4/projects/1/packages/go/my-go-module/@v/1.0.0.zip" >> foo.zip
写入当前目录中的 foo.zip。