Puntos de conexión de la API de REST para etiquetas de repositorio

Usa la API de REST para administrar etiquetas para un repositorio.

This returns the tag protection states of a repository.

This information is only available to repository administrators.

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de la ruta de acceso
Nombre, Tipo, Descripción
`owner` string Requerido The account owner of the repository. The name is not case sensitive.
`repo` string Requerido The name of the repository without the `.git` extension. The name is not case sensitive.

status code	Descripción
`200`	OK
`403`	Forbidden
`404`	Resource not found

Ejemplo de solicitud

get/repos/{owner}/{repo}/tags/protection

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.

Parámetros para "Create a tag protection state for a repository"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de la ruta de acceso
Nombre, Tipo, Descripción
`owner` string Requerido The account owner of the repository. The name is not case sensitive.
`repo` string Requerido The name of the repository without the `.git` extension. The name is not case sensitive.

Parámetros del cuerpo
Nombre, Tipo, Descripción
`pattern` string Requerido An optional glob pattern to match against when enforcing tag protection.

Códigos de estado de respuesta HTTP para "Create a tag protection state for a repository"

status code	Descripción
`201`	Created
`403`	Forbidden
`404`	Resource not found

Ejemplos de código para "Create a tag protection state for a repository"

Ejemplo de solicitud

post/repos/{owner}/{repo}/tags/protection

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.

Parámetros para "Delete a tag protection state for a repository"

Encabezados
Nombre, Tipo, Descripción
`accept` string Setting to `application/vnd.github+json` is recommended.

Parámetros de la ruta de acceso
Nombre, Tipo, Descripción
`owner` string Requerido The account owner of the repository. The name is not case sensitive.
`repo` string Requerido The name of the repository without the `.git` extension. The name is not case sensitive.
`tag_protection_id` integer Requerido The unique identifier of the tag protection.

Códigos de estado de respuesta HTTP para "Delete a tag protection state for a repository"

status code	Descripción
`204`	No Content
`403`	Forbidden
`404`	Resource not found

Ejemplos de código para "Delete a tag protection state for a repository"

Ejemplo de solicitud

delete/repos/{owner}/{repo}/tags/protection/{tag_protection_id}

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