# Project Aliases API > 原文：[https://docs.gitlab.com/ee/api/project_aliases.html](https://docs.gitlab.com/ee/api/project_aliases.html) * [List all project aliases](#list-all-project-aliases) * [Get project alias’ details](#get-project-alias-details) * [Create a project alias](#create-a-project-alias) * [Delete a project alias](#delete-a-project-alias) # Project Aliases API[](#project-aliases-api-premium-only "Permalink") [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/3264) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.1. 所有方法都需要管理員授權. ## List all project aliases[](#list-all-project-aliases "Permalink") 獲取所有項目別名的列表： ``` 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 alias’ details[](#get-project-alias-details "Permalink") 獲取項目別名的詳細信息： ``` GET /project_aliases/:name ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `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" } ``` ## Create a project alias[](#create-a-project-alias "Permalink") 為項目添加新的別名. 成功時回應 201，當驗證錯誤時回應 400（例如別名已經存在）： ``` POST /project_aliases ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `project_id` | integer/string | yes | 項目的 ID 或路徑. | | `name` | string | yes | 別名的名稱. 必須是唯一的. | ``` curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases" --form "project_id=1" --form "name=gitlab" ``` or ``` 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" } ``` ## Delete a project alias[](#delete-a-project-alias "Permalink") 刪除項目別名. 存在項目別名時以 204 響應，如果不存在則以 404 響應： ``` DELETE /project_aliases/:name ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `name` | string | yes | 別名的名稱 | ``` curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/project_aliases/gitlab" ```