Skip to main content

Esta versão do GitHub Enterprise Server foi descontinuada em 2024-07-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

O controle de versão da API REST já foi feito. Para obter mais informações, confira "Sobre o controle de versão da API".

Pontos de extremidade da API REST para tags de repositório

Use a API REST para gerenciar as tags de um repositório.

Deprecated - List tag protection states for a repository

Note: This operation is deprecated and will be removed after August 30th 2024 Use the "Repository Rulesets" endpoint instead.

This returns the tag protection states of a repository.

This information is only available to repository administrators.

Parâmetros para "Deprecated - List tag protection states for a repository"

Cabeçalhos
Nome, Tipo, Descrição
accept string

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

Parâmetros de caminho
Nome, Tipo, Descrição
owner string Obrigatório

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

repo string Obrigatório

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

Códigos de status de resposta HTTP para "Deprecated - List tag protection states for a repository"

Código de statusDescrição
200

OK

403

Forbidden

404

Resource not found

Exemplos de código para "Deprecated - List tag protection states for a repository"

Exemplo de solicitação

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" \ http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/tags/protection

Response

Status: 200
[ { "id": 2, "pattern": "v1.*" } ]

Deprecated - Create a tag protection state for a repository

Note: This operation is deprecated and will be removed after August 30th 2024 Use the "Repository Rulesets" endpoint instead.

This creates a tag protection state for a repository. This endpoint is only available to repository administrators.

Parâmetros para "Deprecated - Create a tag protection state for a repository"

Cabeçalhos
Nome, Tipo, Descrição
accept string

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

Parâmetros de caminho
Nome, Tipo, Descrição
owner string Obrigatório

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

repo string Obrigatório

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

Parâmetros do corpo
Nome, Tipo, Descrição
pattern string Obrigatório

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

Códigos de status de resposta HTTP para "Deprecated - Create a tag protection state for a repository"

Código de statusDescrição
201

Created

403

Forbidden

404

Resource not found

Exemplos de código para "Deprecated - Create a tag protection state for a repository"

Exemplo de solicitação

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" \ http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/tags/protection \ -d '{"pattern":"v1.*"}'

Response

Status: 201
{ "enabled": true }

Deprecated - Delete a tag protection state for a repository

Note: This operation is deprecated and will be removed after August 30th 2024 Use the "Repository Rulesets" endpoint instead.

This deletes a tag protection state for a repository. This endpoint is only available to repository administrators.

Parâmetros para "Deprecated - Delete a tag protection state for a repository"

Cabeçalhos
Nome, Tipo, Descrição
accept string

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

Parâmetros de caminho
Nome, Tipo, Descrição
owner string Obrigatório

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

repo string Obrigatório

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

tag_protection_id integer Obrigatório

The unique identifier of the tag protection.

Códigos de status de resposta HTTP para "Deprecated - Delete a tag protection state for a repository"

Código de statusDescrição
204

No Content

403

Forbidden

404

Resource not found

Exemplos de código para "Deprecated - Delete a tag protection state for a repository"

Exemplo de solicitação

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" \ http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/tags/protection/TAG_PROTECTION_ID

Response

Status: 204