그룹 마크다운 업로드 API

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

마크다운 업로드는 그룹에 업로드된 파일로, epic이나 위키 페이지의 마크다운 텍스트에서 참조될 수 있습니다.

업로드 목록

그룹의 모든 업로드를 created_at을 기준으로 내림차순으로 정렬하여 가져옵니다.

이 엔드포인트를 사용하려면 적어도 Maintainer 역할이 있어야 합니다. 

GET /groups/:id/uploads
속성 타입 필요 여부 설명
id integer 또는 string Yes 그룹의 ID 또는 URL-encoded path.

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads"

예시 응답: 

[
  {
    "id": 1,
    "size": 1024,
    "filename": "image.png",
    "created_at":"2024-06-20T15:53:03.067Z",
    "uploaded_by": {
      "id": 18,
      "name" : "Alexandra Bashirian",
      "username" : "eileen.lowe"
    }
  },
  {
    "id": 2,
    "size": 512,
    "filename": "other-image.png",
    "created_at":"2024-06-19T15:53:03.067Z",
    "uploaded_by": null
  }
]

ID별 업로드된 파일 다운로드

이 엔드포인트를 사용하려면 적어도 Maintainer 역할이 있어야 합니다. 

GET /groups/:id/uploads/:upload_id

지원되는 속성:

속성 타입 필요 여부 설명
id integer 또는 string Yes 그룹의 ID 또는 URL-encoded path.
upload_id integer Yes 업로드의 ID

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/1"

성공할 경우, 응답 본문에는 200과 함께 업로드된 파일이 반환됩니다.

시크릿과 파일 이름으로 업로드된 파일 다운로드

이 엔드포인트를 사용하려면 적어도 Guest 역할이 있어야 합니다. 

GET /groups/:id/uploads/:secret/:filename

지원되는 속성:

속성 타입 필요 여부 설명
id integer 또는 string Yes 그룹의 ID 또는 URL-encoded path.
secret string Yes 업로드의 32자 시크릿
filename string Yes 업로드된 파일의 이름

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/648d97c6eef5fc5df8d1004565b3ee5a/sample.jpg"

성공할 경우, 응답 본문에는 200과 함께 업로드된 파일이 반환됩니다.

ID별 업로드된 파일 삭제

이 엔드포인트를 사용하려면 적어도 Maintainer 역할이 있어야 합니다. 

DELETE /groups/:id/uploads/:upload_id

지원되는 속성:

속성 타입 필요 여부 설명
id integer 또는 string Yes 그룹의 ID 또는 URL-encoded path.
upload_id integer Yes 업로드의 ID

예시 요청: 

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/1"

성공할 경우, 응답 본문없이 204 상태 코드가 반환됩니다.

시크릿과 파일 이름으로 업로드된 파일 삭제

이 엔드포인트를 사용하려면 적어도 Maintainer 역할이 있어야 합니다. 

DELETE /groups/:id/uploads/:secret/:filename

지원되는 속성:

속성 타입 필요 여부 설명
id integer 또는 string Yes 그룹의 ID 또는 URL-encoded path.
secret string Yes 업로드의 32자 시크릿
filename string Yes 업로드된 파일의 이름

예시 요청: 

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5/uploads/648d97c6eef5fc5df8d1004565b3ee5a/sample.jpg"

성공할 경우, 응답 본문없이 204 상태 코드가 반환됩니다.