릴리스 링크 API
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated
Offering: GitLab.com, Self-managed, GitLab Dedicated
GitLab CI/CD 작업 토큰 인증 지원이 GitLab 15.1에서 도입됨.
이 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 . |
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 |
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"
}