Skip to main content
이제 REST API의 버전이 지정되었습니다. 자세한 내용은 "API 버전 관리 정보"를 참조하세요.

리포지토리 태그에 대한 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"에 대한 세분화된 액세스 토큰

This endpoint works with the following fine-grained token types:

토큰에 다음 권한 집합이 있어야 합니다.:

  • "Administration" repository permissions (read)

"List tag protection states for a repository"에 대한 매개 변수

헤더
이름, Type, 설명
accept string

Setting to application/vnd.github+json is recommended.

경로 매개 변수
이름, Type, 설명
owner string Required

The account owner of the repository. The name is not case sensitive.

repo string Required

The name of the repository without the .git extension. The name is not case sensitive.

"List tag protection states for a repository"에 대한 HTTP 응답 상태 코드

상태 코드설명
200

OK

403

Forbidden

404

Resource not found

"List tag protection states for a repository"에 대한 코드 샘플

요청 예제

get/repos/{owner}/{repo}/tags/protection
curl -L \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/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"에 대한 세분화된 액세스 토큰

This endpoint works with the following fine-grained token types:

토큰에 다음 권한 집합이 있어야 합니다.:

  • "Administration" repository permissions (write)

"Create a tag protection state for a repository"에 대한 매개 변수

헤더
이름, Type, 설명
accept string

Setting to application/vnd.github+json is recommended.

경로 매개 변수
이름, Type, 설명
owner string Required

The account owner of the repository. The name is not case sensitive.

repo string Required

The name of the repository without the .git extension. The name is not case sensitive.

본문 매개 변수
이름, Type, 설명
pattern string Required

An optional glob pattern to match against when enforcing tag protection.

"Create a tag protection state for a repository"에 대한 HTTP 응답 상태 코드

상태 코드설명
201

Created

403

Forbidden

404

Resource not found

"Create a tag protection state for a repository"에 대한 코드 샘플

요청 예제

post/repos/{owner}/{repo}/tags/protection
curl -L \ -X POST \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/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"에 대한 세분화된 액세스 토큰

This endpoint works with the following fine-grained token types:

토큰에 다음 권한 집합이 있어야 합니다.:

  • "Administration" repository permissions (write)

"Delete a tag protection state for a repository"에 대한 매개 변수

헤더
이름, Type, 설명
accept string

Setting to application/vnd.github+json is recommended.

경로 매개 변수
이름, Type, 설명
owner string Required

The account owner of the repository. The name is not case sensitive.

repo string Required

The name of the repository without the .git extension. The name is not case sensitive.

tag_protection_id integer Required

The unique identifier of the tag protection.

"Delete a tag protection state for a repository"에 대한 HTTP 응답 상태 코드

상태 코드설명
204

No Content

403

Forbidden

404

Resource not found

"Delete a tag protection state for a repository"에 대한 코드 샘플

요청 예제

delete/repos/{owner}/{repo}/tags/protection/{tag_protection_id}
curl -L \ -X DELETE \ -H "Accept: application/vnd.github+json" \ -H "Authorization: Bearer <YOUR-TOKEN>" \ -H "X-GitHub-Api-Version: 2022-11-28" \ https://api.github.com/repos/OWNER/REPO/tags/protection/TAG_PROTECTION_ID

Response

Status: 204