Dominio de acciones

pipeline

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.

33 · acciones4 · destructivas15 · 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. pipeline.cancel

   Pipeline Cancel

   Cancel a running pipeline. Returns: updated pipeline metadata reflecting the canceled status. See also: pipeline.get, pipeline.retry, job.list_project.

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

   Token fine-grained: Pipeline: Update en proyecto

2. pipeline.create

   Pipeline Create

   Create a new pipeline. Returns: created pipeline metadata including ID, status, and target ref. See also: pipeline.get, pipeline.wait, job.list_project.

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

   Token fine-grained: Pipeline: Create en proyecto

3. pipeline.delete

   Pipeline Deletedestructiva

   Delete a pipeline and all its jobs. Returns: a success status and confirmation message. See also: pipeline.get, pipeline.list, pipeline.cancel.

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

   Token fine-grained: Pipeline: Delete en proyecto

4. pipeline.get

   Pipeline Getsolo lectura

   Get one pipeline by ID. Returns: full pipeline metadata, status lifecycle fields, and links. See also: pipeline.list, pipeline.variables, job.list_project, pipeline.retry.

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

   Token fine-grained: Pipeline: Read en proyecto

5. pipeline.latest

   Pipeline Latestsolo lectura

   Get the latest pipeline of a ref (the default branch when ref is omitted): the one GitLab ran for the commit at its head, or, when that commit has none on the ref, the newest on the ref (the first under any filters or ordering passed). Returns: full pipeline metadata, plus head_sha and fallback_note when the pipeline ran for an earlier commit. See also: pipeline.get, pipeline.list, job.list_project.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Pipeline: Read en proyecto

6. pipeline.list

   Pipeline Listsolo lectura

   List project pipelines with filters and pagination. Returns: pipeline IDs, refs, statuses, source, and timing metadata. See also: pipeline.get, pipeline.latest, job.list_project.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Pipeline: Read en proyecto

7. pipeline.resource_group_edit

   Edit Resource Group

   Update the process mode of one CI resource group by key. Returns: the updated resource group ID, key, new process mode that controls how queued jobs sharing the resource group are serialized, and created and updated times. See also: pipeline.resource_group_get, pipeline.resource_group_list, pipeline.resource_group_upcoming_jobs.

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

   Token fine-grained: Resource Group: Update en proyecto

8. pipeline.resource_group_get

   Get Resource Groupsolo lectura

   Get one CI resource group in a project by key. Returns: the resource group ID, key, process mode (the concurrency mode that controls how jobs sharing the resource group are serialized), and created and updated times. See also: pipeline.resource_group_list, pipeline.resource_group_edit, pipeline.resource_group_upcoming_jobs.

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

   Token fine-grained: Resource Group: Read en proyecto

9. pipeline.resource_group_list

   List Resource Groupssolo lectura

   List the CI resource groups configured for a project. Returns: each resource group's ID, key, process mode that controls how jobs sharing the group are serialized to limit pipeline concurrency, and created and updated times, with pagination metadata. See also: pipeline.resource_group_get, pipeline.resource_group_edit, pipeline.resource_group_upcoming_jobs.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Resource Group: Read en proyecto

10. pipeline.resource_group_upcoming_jobs

    List Resource Group Upcoming Jobssolo lectura

    List the upcoming CI jobs queued for one resource group by key. Returns: each pending job's ID, name, status, stage, ref, tag and allow-failure flags, pipeline, web URL, and creation time, ordered as they will run under the resource group's process mode, with pagination metadata. See also: pipeline.resource_group_get, pipeline.resource_group_list, job.list.

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

    Token fine-grained: Job: Read y Resource Group: Read en proyecto

11. pipeline.retry

    Pipeline Retry

    Retry failed and canceled jobs in a pipeline. Returns: updated pipeline metadata after re-queuing jobs. See also: pipeline.get, pipeline.cancel, job.list_project.

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

    Token fine-grained: Pipeline: Update en proyecto

12. pipeline.schedule_create

    Pipeline Schedule Create

    Create a pipeline schedule. Returns: the created schedule with id, description, ref, cron, owner, and inputs. See also: pipeline.schedule_get, pipeline.schedule_update, pipeline.schedule_list.

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

    Token fine-grained: Pipeline Schedule: Create en proyecto

13. pipeline.schedule_create_variable

    Pipeline Schedule Create Variable

    Create a pipeline schedule variable. Returns: the created variable with key, value, variable_type, and raw. See also: pipeline.schedule_edit_variable, pipeline.schedule_delete_variable.

    Parámetros obligatorios: key (string), project_id (string|integer), schedule_id (integer), value (string)

    Token fine-grained: Pipeline Schedule: Update en proyecto

14. pipeline.schedule_delete

    Pipeline Schedule Deletedestructiva

    Delete a pipeline schedule permanently. Returns: a success confirmation. See also: pipeline.schedule_get, pipeline.schedule_list.

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

    Token fine-grained: Pipeline Schedule: Delete en proyecto

15. pipeline.schedule_delete_variable

    Pipeline Schedule Delete Variabledestructiva

    Delete a pipeline schedule variable. Returns: a success confirmation naming the key. See also: pipeline.schedule_create_variable, pipeline.schedule_edit_variable.

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

    Token fine-grained: Pipeline Schedule: Update en proyecto

16. pipeline.schedule_edit_variable

    Pipeline Schedule Edit Variable

    Edit a pipeline schedule variable. Returns: the updated variable with key, value, variable_type, and raw. See also: pipeline.schedule_create_variable, pipeline.schedule_delete_variable.

    Parámetros obligatorios: key (string), project_id (string|integer), schedule_id (integer), value (string)

    Token fine-grained: Pipeline Schedule: Update en proyecto

17. pipeline.schedule_get

    Pipeline Schedule Getsolo lectura

    Get a single pipeline schedule by ID. Returns: the schedule with cron, ref, owner, last_pipeline, variables, and inputs. See also: pipeline.schedule_list, pipeline.schedule_update, pipeline.schedule_run.

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

    Token fine-grained: Pipeline Schedule: Read en proyecto

18. pipeline.schedule_list

    Pipeline Schedule Listsolo lectura

    List pipeline schedules in a project. Returns: schedules with description, ref, cron, owner, and pagination metadata. See also: pipeline.schedule_get, pipeline.schedule_create.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Pipeline Schedule: Read en proyecto

19. pipeline.schedule_list_triggered_pipelines

    Pipeline Schedule List Triggered Pipelinessolo lectura

    List pipelines triggered by a schedule. Returns: triggered pipelines with status, ref, sha, web URL, and pagination metadata. See also: pipeline.schedule_get, pipeline.schedule_run.

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

    Token fine-grained: Pipeline: Read y Pipeline Schedule: Read en proyecto

20. pipeline.schedule_run

    Pipeline Schedule Run

    Run a pipeline schedule immediately. Returns: the schedule's current state after triggering. See also: pipeline.schedule_get, pipeline.schedule_list_triggered_pipelines.

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

    Token fine-grained: Pipeline Schedule: Read y Pipeline Schedule: Update en proyecto

21. pipeline.schedule_take_ownership

    Pipeline Schedule Take Ownership

    Take ownership of a pipeline schedule. Returns: the schedule with the caller as owner. See also: pipeline.schedule_update, pipeline.schedule_run.

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

    Token fine-grained: Pipeline Schedule: Update en proyecto

22. pipeline.schedule_update

    Pipeline Schedule Update

    Update a pipeline schedule. Returns: the updated schedule with cron, ref, owner, and inputs. See also: pipeline.schedule_get, pipeline.schedule_take_ownership.

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

    Token fine-grained: Pipeline Schedule: Update en proyecto

23. pipeline.test_report

    Pipeline Test Reportsolo lectura

    Get a pipeline's full test report. Returns: total/passed/failed/skipped counts and per-suite breakdown. See also: pipeline.test_report_summary, pipeline.get, job.list_project.

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

    Token fine-grained: Pipeline: Read en proyecto

24. pipeline.test_report_summary

    Pipeline Test Report Summarysolo lectura

    Get a pipeline's test report summary. Returns: aggregate test totals and per-suite summaries with build IDs. See also: pipeline.test_report, pipeline.get, job.list_project.

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

    Token fine-grained: Pipeline: Read en proyecto

25. pipeline.trigger_create

    Pipeline Trigger Create

    Create a pipeline trigger token. Returns: the created trigger with id, description, token secret, and owner. See also: pipeline.trigger_run, pipeline.trigger_list, pipeline.trigger_delete.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Trigger: Create en proyecto

26. pipeline.trigger_delete

    Pipeline Trigger Deletedestructiva

    Delete a pipeline trigger token. Returns: a success confirmation. See also: pipeline.trigger_get, pipeline.trigger_create.

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

    Token fine-grained: Trigger: Delete en proyecto

27. pipeline.trigger_get

    Pipeline Trigger Getsolo lectura

    Get a single pipeline trigger token. Returns: the trigger with id, description, token, owner, and timestamps. See also: pipeline.trigger_list, pipeline.trigger_update, pipeline.trigger_delete.

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

    Token fine-grained: Trigger: Read en proyecto

28. pipeline.trigger_list

    Pipeline Trigger Listsolo lectura

    List a project's pipeline trigger tokens. Returns: trigger tokens with id, description, owner, last-used time, and pagination metadata. See also: pipeline.trigger_get, pipeline.trigger_create, pipeline.trigger_run.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Trigger: Read en proyecto

29. pipeline.trigger_run

    Pipeline Trigger Run

    Trigger a pipeline using a trigger token. Returns: the created pipeline with id, status, ref, sha, source, user, detailed_status, and web URL. See also: pipeline.trigger_list, pipeline.get.

    Parámetros obligatorios: project_id (string|integer)

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

30. pipeline.trigger_update

    Pipeline Trigger Update

    Update a pipeline trigger token's description. Returns: the updated trigger with id, description, token, and owner. See also: pipeline.trigger_get, pipeline.trigger_delete.

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

    Token fine-grained: Trigger: Update en proyecto

31. pipeline.update_metadata

    Pipeline Update Metadata

    Update a pipeline's name. Returns: updated pipeline metadata reflecting the new name. See also: pipeline.get, pipeline.list, pipeline.create.

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

    Token fine-grained: Pipeline: Update en proyecto

32. pipeline.variables

    Pipeline Variablessolo lectura

    List a pipeline's runtime variables. Returns: variable keys, values, types, and whether each value is raw (not expanded). See also: pipeline.get, pipeline.create, job.list_project.

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

    Token fine-grained: Pipeline: Read en proyecto

33. pipeline.wait

    Pipeline Waitsolo lectura

    Use only to poll an existing pipeline_id until a terminal status. For merge when pipeline succeeds, use merge_request.merge with auto_merge=true instead.

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

    Token fine-grained: Pipeline: Read en proyecto