프로젝트 별칭 API
Tier: Premium, Ultimate
Offering: Self-Managed, GitLab Dedicated
모든 메소드는 관리자 권한이 필요합니다.
모든 프로젝트 별칭 나열
모든 프로젝트 별칭의 디렉터리을 가져옵니다:
GET /project_aliases
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases"
예시 응답:
[
{
"id": 1,
"project_id": 1,
"name": "gitlab-foss"
},
{
"id": 2,
"project_id": 2,
"name": "gitlab"
}
]
프로젝트 별칭 세부 정보 가져오기
프로젝트 별칭의 세부 정보를 가져옵니다:
GET /project_aliases/:name
속성 | 타입 | 필수 | 설명 |
---|---|---|---|
name
| string | Yes | 별칭의 이름. |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases/gitlab"
예시 응답:
{
"id": 1,
"project_id": 1,
"name": "gitlab"
}
프로젝트 별칭 생성
프로젝트에 새로운 별칭을 추가합니다. 성공적으로 완료되면 201 Created
로 응답합니다.
예를 들어 별칭이 이미 존재하는 경우와 같은 유효성 검사 오류가 있는 경우 400 Bad Request
로 응답합니다:
POST /project_aliases
속성 | 타입 | 필수 | 설명 |
---|---|---|---|
name
| string | Yes | 별칭의 이름. 고유해야 합니다. |
project_id
| 정수 또는 문자열 | Yes | 프로젝트의 ID 또는 경로. |
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
"https://gitlab.example.com/api/v4/project_aliases" --form "project_id=1" --form "name=gitlab"
또는
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
"https://gitlab.example.com/api/v4/project_aliases" --form "project_id=gitlab-org/gitlab" --form "name=gitlab"
예시 응답:
{
"id": 1,
"project_id": 1,
"name": "gitlab"
}
프로젝트 별칭 삭제
프로젝트 별칭을 제거합니다. 프로젝트 별칭이 있는 경우 204로 응답하며, 별칭이 없는 경우 404로 응답합니다:
DELETE /project_aliases/:name
속성 | 타입 | 필수 | 설명 |
---|---|---|---|
name
| string | Yes | 별칭의 이름. |
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases/gitlab"