프로젝트 레벨 보안 파일 API
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 API를 사용해 프로젝트의 보안 파일을 관리합니다. 지정한 프로젝트의 모든 보안 파일을 나열합니다. 프로젝트에서 지정한 보안 파일의 상세 정보를 조회합니다. 지정한 프로젝트에 보안 파일을 생성합니다. 프로젝트에서 지정한 보안 파일의 내용을 다운로드합니다.
이 API를 사용해 프로젝트의 보안 파일을 관리합니다.
프로젝트의 모든 보안 파일 나열#
지정한 프로젝트의 모든 보안 파일을 나열합니다.
GET /projects/:project_id/secure_files
지원되는 속성:
| 속성 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
project_id |
integer or string | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로입니다. |
요청 예시:
curl --header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/secure_files"
응답 예시:
[
{
"id": 1,
"name": "myfile.jks",
"checksum": "16630b189ab34b2e3504f4758e1054d2e478deda510b2b08cc0ef38d12e80aac",
"checksum_algorithm": "sha256",
"created_at": "2022-02-22T22:22:22.222Z",
"expires_at": null,
"metadata": null,
"file_extension": "jks"
},
{
"id": 2,
"name": "myfile.cer",
"checksum": "16630b189ab34b2e3504f4758e1054d2e478deda510b2b08cc0ef38d12e80aa2",
"checksum_algorithm": "sha256",
"created_at": "2022-02-22T22:22:22.222Z",
"expires_at": "2023-09-21T14:55:59.000Z",
"metadata": {
"id":"75949910542696343243264405377658443914",
"issuer": {
"C":"US",
"O":"Apple Inc.",
"CN":"Apple Worldwide Developer Relations Certification Authority",
"OU":"G3"
},
"subject": {
"C":"US",
"O":"Organization Name",
"CN":"Apple Distribution: Organization Name (ABC123XYZ)",
"OU":"ABC123XYZ",
"UID":"ABC123XYZ"
},
"expires_at":"2023-09-21T14:55:59.000Z"
},
"file_extension": "cer"
}
]
보안 파일 상세 조회#
프로젝트에서 지정한 보안 파일의 상세 정보를 조회합니다.
GET /projects/:project_id/secure_files/:id
지원되는 속성:
| 속성 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
id |
integer | Yes | 보안 파일의 ID 입니다. |
project_id |
integer or string | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로입니다. |
요청 예시:
curl --header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/secure_files/1"
응답 예시:
{
"id": 1,
"name": "myfile.jks",
"checksum": "16630b189ab34b2e3504f4758e1054d2e478deda510b2b08cc0ef38d12e80aac",
"checksum_algorithm": "sha256",
"created_at": "2022-02-22T22:22:22.222Z",
"expires_at": null,
"metadata": null,
"file_extension": "jks"
}
보안 파일 생성#
지정한 프로젝트에 보안 파일을 생성합니다.
POST /projects/:project_id/secure_files
지원되는 속성:
| 속성 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
file |
file | Yes | 업로드할 파일입니다(5MB 제한). |
name |
string | Yes | 업로드할 파일의 이름입니다. 파일 이름은 프로젝트 안에서 고유해야 합니다. |
project_id |
integer or string | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로입니다. |
요청 예시:
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/secure_files" \
--form "name=myfile.jks" \
--form "file=@/path/to/file/myfile.jks"
응답 예시:
{
"id": 1,
"name": "myfile.jks",
"checksum": "16630b189ab34b2e3504f4758e1054d2e478deda510b2b08cc0ef38d12e80aac",
"checksum_algorithm": "sha256",
"created_at": "2022-02-22T22:22:22.222Z",
"expires_at": null,
"metadata": null,
"file_extension": "jks"
}
보안 파일 다운로드#
프로젝트에서 지정한 보안 파일의 내용을 다운로드합니다.
GET /projects/:project_id/secure_files/:id/download
지원되는 속성:
| 속성 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
id |
integer | Yes | 보안 파일의 ID 입니다. |
project_id |
integer or string | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로입니다. |
요청 예시:
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/secure_files/1/download" \
--output myfile.jks
보안 파일 삭제#
프로젝트에서 지정한 보안 파일을 삭제합니다.
DELETE /projects/:project_id/secure_files/:id
지원되는 속성:
| 속성 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
id |
integer | Yes | 보안 파일의 ID 입니다. |
project_id |
integer or string | Yes | 프로젝트의 ID 또는 URL 인코딩된 경로입니다. |
요청 예시:
curl --request DELETE \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/1/secure_files/1"