{{< details >}}

  • Tier: 基础版, 专业版, 旗舰版
  • Offering: JihuLab.com, 私有化部署

{{< /details >}}

{{< history >}}

{{< /history >}}

使用这个 API 来操作极狐GitLab 发布 链接。要操作其他发布资产，请参阅 发布 API。

极狐GitLab 支持链接到 http、https 和 ftp 资产。

列出发布的链接

从发布中获取资产作为链接。

GET /projects/:id/releases/:tag_name/assets/links
属性 类型 是否必需 描述
id integer/string 是 项目的 ID 或 URL 编码路径。
tag_name string 是 与发布相关的标签。

示例请求：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/24/releases/v0.1/assets/links"

示例响应：

[
   {
      "id":2,
      "name":"awesome-v0.2.msi",
      "url":"http://192.168.10.15:3000/msi",
      "link_type":"other"
   },
   {
      "id":1,
      "name":"awesome-v0.2.dmg",
      "url":"http://192.168.10.15:3000",
      "link_type":"other"
   }
]

获取发布链接

从发布中获取资产作为链接。

GET /projects/:id/releases/:tag_name/assets/links/:link_id
属性 类型 是否必需 描述
id integer/string 是 项目的 ID 或 URL 编码路径。
tag_name string 是 与发布相关的标签。
link_id integer 是 链接的 ID。

示例请求：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/24/releases/v0.1/assets/links/1"

示例响应：

{
   "id":1,
   "name":"awesome-v0.2.dmg",
   "url":"http://192.168.10.15:3000",
   "link_type":"other"
}

创建发布链接

创建一个资产作为发布中的链接。

POST /projects/:id/releases/:tag_name/assets/links
属性 类型 是否必需 描述
id integer/string 是 项目的 ID 或 URL 编码路径。
tag_name string 是 与发布相关的标签。
name string 是 链接的名称。链接名称在发布中必须是唯一的。
url string 是 链接的 URL。链接 URL 在发布中必须是唯一的。
direct_asset_path string 否 直接资产链接 的可选路径。
link_type string 否 链接类型：other、runbook、image、package。默认值为 other。

示例请求：

curl --request POST \
    --header "PRIVATE-TOKEN: <your_access_token>" \
    --data name="hellodarwin-amd64" \
    --data url="https://gitlab.example.com/mynamespace/hello/-/jobs/688/artifacts/raw/bin/hello-darwin-amd64" \
    --data direct_asset_path="/bin/hellodarwin-amd64" \
    "https://gitlab.example.com/api/v4/projects/20/releases/v1.7.0/assets/links"

示例响应：

{
   "id":2,
   "name":"hellodarwin-amd64",
   "url":"https://gitlab.example.com/mynamespace/hello/-/jobs/688/artifacts/raw/bin/hello-darwin-amd64",
   "direct_asset_url":"https://gitlab.example.com/mynamespace/hello/-/releases/v1.7.0/downloads/bin/hellodarwin-amd64",
   "link_type":"other"
}

更新发布链接

更新一个资产作为发布中的链接。

PUT /projects/:id/releases/:tag_name/assets/links/:link_id
属性 类型 是否必需 描述
id integer/string 是 项目的 ID 或 URL 编码路径。
tag_name string 是 与发布相关的标签。
link_id integer 是 链接的 ID。
name string 否 链接的名称。
url string 否 链接的 URL。
direct_asset_path string 否 直接资产链接 的可选路径。
link_type string 否 链接类型：other、runbook、image、package。默认值为 other。

{{< alert type=”note” >}}

您必须至少指定 name 或 url 之一

{{< /alert >}}

示例请求：

curl --request PUT --data name="new name" --data link_type="runbook" \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/projects/24/releases/v0.1/assets/links/1"

示例响应：

{
   "id":1,
   "name":"new name",
   "url":"http://192.168.10.15:3000",
   "link_type":"runbook"
}

删除发布链接

删除一个资产作为发布中的链接。

DELETE /projects/:id/releases/:tag_name/assets/links/:link_id
属性 类型 是否必需 描述
id integer/string 是 项目的 ID 或 URL 编码路径。
tag_name string 是 与发布相关的标签。
link_id integer 是 链接的 ID。

示例请求：

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/24/releases/v0.1/assets/links/1"

示例响应：

{
   "id":1,
   "name":"new name",
   "url":"http://192.168.10.15:3000",
   "link_type":"other"
}