Skip to main content
REST API теперь версия. Дополнительные сведения см. в разделе "О управлении версиями API".

Теги репозитория

Используйте REST API для управления тегами для репозитория.

List tag protection states for a repository

Совместим с GitHub Apps

This returns the tag protection states of a repository.

This information is only available to repository administrators.

Параметры для "List tag protection states for a repository"

Заголовки
Имя, Вид, Description
accept string

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

Параметры пути
Имя, Вид, Description
owner string Обязательное поле

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

repo string Обязательное поле

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

Коды состояния http-ответа для "List tag protection states for a repository"

Код состоянияDescription
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

Совместим с GitHub Apps

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"

Заголовки
Имя, Вид, Description
accept string

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

Параметры пути
Имя, Вид, Description
owner string Обязательное поле

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

repo string Обязательное поле

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

Параметры запроса
Имя, Вид, Description
pattern string Обязательное поле

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

Коды состояния http-ответа для "Create a tag protection state for a repository"

Код состоянияDescription
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

Delete a tag protection state for a repository

Совместим с GitHub Apps

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"

Заголовки
Имя, Вид, Description
accept string

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

Параметры пути
Имя, Вид, Description
owner string Обязательное поле

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

repo string Обязательное поле

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

tag_protection_id integer Обязательное поле

The unique identifier of the tag protection.

Коды состояния http-ответа для "Delete a tag protection state for a repository"

Код состоянияDescription
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