Dominio de acciones

tag

Todas las acciones que este dominio expone vía gitlab_execute_action, del manifiesto gitlab://tools. Cada entrada se despliega a su descripción completa y sus parámetros obligatorios.

9 · acciones2 · destructivas5 · solo lectura

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cuenta 868 operaciones en Community Edition y hasta 1.094 en el tier más alto de GitLab.com, mientras que este despliegue publica 768 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

Cada entrada dice también qué necesita un token de acceso personal fine-grained de GitLab para ejecutarla, tal como lo declara GitLab 19.4.1: todos los permisos de una línea, en uno de los ámbitos indicados. Cuando hay alternativas, basta con cualquiera.

Volver a la ficha del servidor

1. tag.create

   Tag Create

   Create a new tag in a project pointing at a ref. Returns: the created tag with target, message, protection flag, and the associated commit object. See also: tag.get, tag.delete, release.create.

   Parámetros obligatorios: project_id (string|integer), ref (string), tag_name (string)

   Token fine-grained: Repository Tag: Create en proyecto

2. tag.delete

   Tag Deletedestructiva

   Delete a tag from a project permanently. Returns: a success confirmation naming the tag and project. See also: tag.get, tag.list, tag.unprotect.

   Parámetros obligatorios: project_id (string|integer), tag_name (string)

   Token fine-grained: Repository Tag: Delete en proyecto

3. tag.get

   Tag Getsolo lectura

   Get a single tag from a project by name. Returns: the tag with target, message, protection flag, the full associated commit object, release note, and creation time. See also: tag.list, tag.get_signature, release.get.

   Parámetros obligatorios: project_id (string|integer), tag_name (string)

   Token fine-grained: Repository Tag: Read en proyecto

4. tag.get_protected

   Tag Get Protectedsolo lectura

   Get a single protected tag or wildcard rule by name. Returns: the protected tag with its create access levels (access level, user, group, and deploy key descriptions). See also: tag.list_protected, tag.protect, tag.unprotect.

   Parámetros obligatorios: project_id (string|integer), tag_name (string)

   Token fine-grained: Protected Tag: Read en proyecto

5. tag.get_signature

   Tag Get Signaturesolo lectura

   Get the X.509 signature of a tag. Returns: the signature type, verification status, and the X.509 certificate with issuer detail. See also: tag.get, tag.list.

   Parámetros obligatorios: project_id (string|integer), tag_name (string)

   Token fine-grained: Repository Tag: Read en proyecto

6. tag.list

   Tag Listsolo lectura

   List tags in one project with optional search and offset or keyset pagination. Returns: matching tags with target, message, protection flag, the associated commit object, release note, and pagination metadata. See also: tag.get, tag.create, release.list.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Repository Tag: Read en proyecto

7. tag.list_protected

   Tag List Protectedsolo lectura

   List protected tags in one project with offset or keyset pagination. Returns: protected tag patterns with their create access levels and pagination metadata. See also: tag.get_protected, tag.protect, tag.list.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Protected Tag: Read en proyecto

8. tag.protect

   Tag Protect

   Protect a tag or wildcard pattern with create access levels. Returns: the protected tag with its resolved create access levels. See also: tag.unprotect, tag.list_protected, tag.get_protected.

   Parámetros obligatorios: project_id (string|integer), tag_name (string)

   Token fine-grained: Tag: Protect en proyecto

9. tag.unprotect

   Tag Unprotectdestructiva

   Remove protection from a tag or wildcard pattern. Returns: a success confirmation naming the tag and project. See also: tag.protect, tag.list_protected, tag.get_protected.

   Parámetros obligatorios: project_id (string|integer), tag_name (string)

   Token fine-grained: Tag: Protect en proyecto