릴리스 링크 API

요약

이 API를 사용하여 릴리스에 대한 링크와 상호작용합니다. GitLab은 다음 프로토콜을 사용하는 에셋 링크를 지원합니다: 프로젝트 릴리스와 직접 상호작용하려면 프로젝트 릴리스 API를 참조하세요. 릴리스의 모든 에셋을 링크로 나열합니다.

히스토리

GitLab 15.1에서 GitLab CI/CD 잡 토큰을 사용한 인증이 추가되었습니다.

이 API를 사용하여 릴리스에 대한 링크와 상호작용합니다.

GitLab은 다음 프로토콜을 사용하는 에셋 링크를 지원합니다:

http
https
ftp

Note

프로젝트 릴리스와 직접 상호작용하려면 프로젝트 릴리스 API를 참조하세요.

모든 릴리스 링크 목록 조회#

릴리스의 모든 에셋을 링크로 나열합니다.

GET /projects/:id/releases/:tag_name/assets/links

속성	유형	필수	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.

요청 예시:

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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`link_id`	정수	예	링크의 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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`name`	문자열	예	링크의 이름. 링크 이름은 릴리스에서 고유해야 합니다.
`url`	문자열	예	링크의 URL. 링크 URL은 릴리스에서 고유해야 합니다.
`direct_asset_path`	문자열	아니요	직접 에셋 링크에 대한 선택적 경로.
`link_type`	문자열	아니요	링크 유형: `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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`link_id`	정수	예	링크의 ID.
`name`	문자열	아니요	링크의 이름.
`url`	문자열	아니요	링크의 URL.
`direct_asset_path`	문자열	아니요	직접 에셋 링크에 대한 선택적 경로.
`link_type`	문자열	아니요	링크 유형: `other`, `runbook`, `image`, `package`. 기본값은 `other`.

Note

name 또는 url 중 하나 이상을 지정해야 합니다.

요청 예시:

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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`link_id`	정수	예	링크의 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"
}

릴리스 링크 API

Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

원문 보기

번역일: 2026-05-22

요약

히스토리

GitLab 15.1에서 GitLab CI/CD 잡 토큰을 사용한 인증이 추가되었습니다.

이 API를 사용하여 릴리스에 대한 링크와 상호작용합니다.

GitLab은 다음 프로토콜을 사용하는 에셋 링크를 지원합니다:

http
https
ftp

Note

프로젝트 릴리스와 직접 상호작용하려면 프로젝트 릴리스 API를 참조하세요.

모든 릴리스 링크 목록 조회#

릴리스의 모든 에셋을 링크로 나열합니다.

GET /projects/:id/releases/:tag_name/assets/links

속성	유형	필수	설명
`id`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.

요청 예시:

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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`link_id`	정수	예	링크의 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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`name`	문자열	예	링크의 이름. 링크 이름은 릴리스에서 고유해야 합니다.
`url`	문자열	예	링크의 URL. 링크 URL은 릴리스에서 고유해야 합니다.
`direct_asset_path`	문자열	아니요	직접 에셋 링크에 대한 선택적 경로.
`link_type`	문자열	아니요	링크 유형: `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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`link_id`	정수	예	링크의 ID.
`name`	문자열	아니요	링크의 이름.
`url`	문자열	아니요	링크의 URL.
`direct_asset_path`	문자열	아니요	직접 에셋 링크에 대한 선택적 경로.
`link_type`	문자열	아니요	링크 유형: `other`, `runbook`, `image`, `package`. 기본값은 `other`.

Note

name 또는 url 중 하나 이상을 지정해야 합니다.

요청 예시:

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`	정수 또는 문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로.
`tag_name`	문자열	예	릴리스와 연결된 태그.
`link_id`	정수	예	링크의 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"
}