Dominio de acciones

runner

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.

19 · acciones4 · destructivas8 · 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. runner.delete_by_token

   Runner Delete By Tokendestructiva

   Delete a registered runner by its authentication token. Returns: a success confirmation. See also: runner.delete_registered, runner.remove.

   Parámetros obligatorios: token (string)

   Token fine-grained: la concesión no lo juzga (GitLab autentica esta petición de otra forma)

2. runner.delete_registered

   Runner Delete Registereddestructiva

   Delete a registered runner by its numeric runner_id. Returns: a success confirmation. See also: runner.delete_by_token, runner.remove.

   Parámetros obligatorios: runner_id (integer)

   Token fine-grained: Runner: Delete en proyecto, grupo o instancia

3. runner.disable_project

   Runner Disable Projectdestructiva

   Remove a runner assignment from a project by project_id and runner_id. Returns: a success confirmation. See also: runner.enable_project, runner.list_project.

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

   Token fine-grained: Runner: Assign en proyecto

4. runner.enable_project

   Runner Enable Project

   Assign an existing runner to a project by project_id and runner_id. Returns: the enabled runner. See also: runner.disable_project, runner.list_project.

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

   Token fine-grained: Runner: Assign en proyecto

5. runner.get

   Runner Getsolo lectura

   Get full configuration for one runner by numeric runner_id. Returns: runner details including tags, locked, access level, maximum timeout, contact time, and associated groups/projects. See also: runner.list, runner.update, runner.jobs.

   Parámetros obligatorios: runner_id (integer)

   Token fine-grained: Runner: Read en proyecto, grupo o instancia

6. runner.jobs

   Runner Jobssolo lectura

   List jobs processed by a runner, with status/order/sort filters and pagination. Returns: jobs with id, name, status, stage, ref, and duration, plus pagination metadata. See also: runner.get, job.get.

   Parámetros obligatorios: runner_id (integer)

   Token fine-grained: Runner: Read en proyecto, grupo o instancia

7. runner.list

   Runner Listsolo lectura

   List runners owned by the authenticated user, with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, paused/shared/online flags, plus pagination metadata. See also: runner.get, runner.list_all, runner.list_project.

   Parámetros obligatorios: Sin parámetros obligatorios

   Token fine-grained: Runner: Read en usuario

8. runner.list_all

   Runner List Allsolo lectura

   List every runner on the instance (admin token required), with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.list, runner.get.

   Parámetros obligatorios: Sin parámetros obligatorios

   Token fine-grained: Runner: Read en instancia

9. runner.list_group

   Runner List Groupsolo lectura

   List runners available in a group (specific and shared), with type/status/tag filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.list, runner.list_project.

   Parámetros obligatorios: group_id (string|integer)

   Token fine-grained: Runner: Read en grupo

10. runner.list_managers

    Runner List Managerssolo lectura

    List the managers of a runner by runner_id. Returns: runner managers with system id, version, revision, platform, architecture, status, and IP. See also: runner.get, runner.list.

    Parámetros obligatorios: runner_id (integer)

    Token fine-grained: Runner: Read en proyecto, grupo o instancia

11. runner.list_project

    Runner List Projectsolo lectura

    List runners assigned to a project, with type/status/tag/scope filters and pagination. Returns: runners with id, name, type, status, flags, plus pagination metadata. See also: runner.enable_project, runner.disable_project, runner.list.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Runner: Read en proyecto

12. runner.register

    Runner Register

    Register a new runner with a registration token, optional info hashmap, tags, and configuration. Returns: the created runner including its authentication token. See also: runner.verify, runner.list.

    Parámetros obligatorios: token (string)

    Token fine-grained: la concesión no lo juzga (GitLab autentica esta petición de otra forma)

13. runner.remove

    Runner Removedestructiva

    Remove (unregister) a runner by numeric runner_id. Returns: a success confirmation. See also: runner.disable_project, runner.delete_registered, runner.get.

    Parámetros obligatorios: runner_id (integer)

    Token fine-grained: Runner: Delete en proyecto, grupo o instancia

14. runner.reset_group_reg_token

    Runner Reset Group Reg Token

    Reset a group's runner registration token by group_id (deprecated). Returns: the new registration token and its expiry. See also: runner.reset_instance_reg_token, runner.reset_project_reg_token.

    Parámetros obligatorios: group_id (string|integer)

    Token fine-grained: Runner Registration Token: Reset en grupo

15. runner.reset_instance_reg_token

    Runner Reset Instance Reg Token

    Reset the instance-level runner registration token (deprecated, admin only). Returns: the new registration token and its expiry. See also: runner.reset_group_reg_token, runner.reset_project_reg_token.

    Parámetros obligatorios: Sin parámetros obligatorios

    Token fine-grained: Runner Registration Token: Reset en instancia

16. runner.reset_project_reg_token

    Runner Reset Project Reg Token

    Reset a project's runner registration token by project_id (deprecated). Returns: the new registration token and its expiry. See also: runner.reset_instance_reg_token, runner.reset_group_reg_token.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Runner Registration Token: Reset en proyecto

17. runner.reset_token

    Runner Reset Token

    Reset a runner's authentication token by runner_id. Returns: the new token and its expiry. See also: runner.verify, runner.get.

    Parámetros obligatorios: runner_id (integer)

    Token fine-grained: Runner: Update en proyecto, grupo o instancia

18. runner.update

    Runner Update

    Update a runner's configuration (description, pause state, tags, locked, access level, timeout) by runner_id. Returns: the updated runner details. See also: runner.get, runner.remove.

    Parámetros obligatorios: runner_id (integer)

    Token fine-grained: Runner: Update en proyecto, grupo o instancia

19. runner.verify

    Runner Verifysolo lectura

    Verify that a runner authentication token is valid. Returns: a success confirmation when the token authenticates. See also: runner.register, runner.reset_token.

    Parámetros obligatorios: token (string)

    Token fine-grained: la concesión no lo juzga (GitLab autentica esta petición de otra forma)