최근에 REST API 설명서 중 일부를 이동했습니다. 원하는 항목을 찾을 수 없는 경우 새 Branches, Collaborators, Commits, Deploy Keys, Deployments, GitHub Pages, Releases, Metrics, Webhooks REST API 페이지를 사용해 볼 수 있습니다.
리포지토리 태그
REST API를 사용하여 리포지토리에 대한 태그를 관리합니다.
List tag protection states for a repository
This returns the tag protection states of a repository.
This information is only available to repository administrators.
"List tag protection states for a repository"에 대한 매개 변수
헤더 |
---|
Name, 형식, 설명 |
accept string Setting to |
경로 매개 변수 |
Name, 형식, 설명 |
owner string 필수The account owner of the repository. The name is not case sensitive. |
repo string 필수The name of the repository. The name is not case sensitive. |
"List tag protection states for a repository"에 대한 HTTP 응답 상태 코드
상태 코드 | Description |
---|---|
200 | OK |
403 | Forbidden |
404 | Resource not found |
"List tag protection states for a repository"에 대한 코드 샘플
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/tags/protection
Response
Status: 200
[
{
"id": 2,
"pattern": "v1.*"
}
]
Create a tag protection state for a repository
This creates a tag protection state for a repository. This endpoint is only available to repository administrators.
"Create a tag protection state for a repository"에 대한 매개 변수
헤더 |
---|
Name, 형식, 설명 |
accept string Setting to |
경로 매개 변수 |
Name, 형식, 설명 |
owner string 필수The account owner of the repository. The name is not case sensitive. |
repo string 필수The name of the repository. The name is not case sensitive. |
본문 매개 변수 |
Name, 형식, 설명 |
pattern string 필수An optional glob pattern to match against when enforcing tag protection. |
"Create a tag protection state for a repository"에 대한 HTTP 응답 상태 코드
상태 코드 | Description |
---|---|
201 | Created |
403 | Forbidden |
404 | Resource not found |
"Create a tag protection state for a repository"에 대한 코드 샘플
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/tags/protection \
-d '{"pattern":"v1.*"}'
Response
Status: 201
{
"enabled": true
}
Delete a tag protection state for a repository
This deletes a tag protection state for a repository. This endpoint is only available to repository administrators.
"Delete a tag protection state for a repository"에 대한 매개 변수
헤더 |
---|
Name, 형식, 설명 |
accept string Setting to |
경로 매개 변수 |
Name, 형식, 설명 |
owner string 필수The account owner of the repository. The name is not case sensitive. |
repo string 필수The name of the repository. The name is not case sensitive. |
tag_protection_id integer 필수The unique identifier of the tag protection. |
"Delete a tag protection state for a repository"에 대한 HTTP 응답 상태 코드
상태 코드 | Description |
---|---|
204 | No Content |
403 | Forbidden |
404 | Resource not found |
"Delete a tag protection state for a repository"에 대한 코드 샘플
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/tags/protection/TAG_PROTECTION_ID
Response
Status: 204