Dominio de acciones

environment

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.

18 · acciones4 · destructivas7 · 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. environment.create

   Environment Create

   Create an environment in a project. Use when introducing new runtime targets such as review, staging, or production environments.

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

   Token fine-grained: Environment: Create en proyecto

2. environment.delete

   Environment Deletedestructiva

   Delete a stopped environment from a project. Returns: a success confirmation naming the deleted environment. See also: environment.stop, environment.list, environment.get.

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

   Token fine-grained: Environment: Delete en proyecto

3. environment.deployment_approve_or_reject

   Deployment Approve Or Reject

   Approve or reject a blocked deployment awaiting protected-environment approval, optionally with a comment and an approval rule to represent. Returns: a confirmation message naming the deployment and the applied status. See also: environment.deployment_get, environment.deployment_update.

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

   Token fine-grained: Deployment: Approve en proyecto

4. environment.deployment_create

   Deployment Create

   Create a deployment record for an environment at a given ref and sha with an initial status. Returns: the created deployment with id, iid, ref, sha, status, and nested user, environment, and deployable objects. See also: environment.get, environment.deployment_list, environment.deployment_update.

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

   Token fine-grained: Deployment: Create en proyecto

5. environment.deployment_delete

   Deployment Deletedestructiva

   Delete a deployment record by deployment_id within a project. Returns: a confirmation that the deployment was deleted. See also: environment.deployment_get, environment.deployment_list.

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

   Token fine-grained: Deployment: Delete en proyecto

6. environment.deployment_get

   Deployment Getsolo lectura

   Get one deployment by deployment_id for a project. Use when investigating a specific deployment state, environment, or actor metadata.

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

   Token fine-grained: Deployment: Read en proyecto

7. environment.deployment_list

   Deployment Listsolo lectura

   List deployments in a project with environment, status, and date filters plus offset or keyset pagination. Returns: matching deployments with ref, sha, status, user, environment, and deployable (CI job) objects, and pagination metadata. See also: environment.deployment_get, environment.list, pipeline.get.

   Parámetros obligatorios: project_id (string|integer)

   Token fine-grained: Deployment: Read en proyecto

8. environment.deployment_merge_requests

   List Deployment Merge Requestssolo lectura

   List the merge requests associated with a deployment, with merge-request filtering (state, approval, author, assignee, draft, created date) and offset or keyset pagination. Returns: matching merge requests with full metadata (author, assignees, reviewers, labels, milestone, pipelines, time stats, timestamps) and pagination metadata. See also: merge_request.get, merge_request.list, environment.deployment_list.

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

   Token fine-grained: Deployment: Read y Merge Request: Read en proyecto

9. environment.deployment_update

   Deployment Update

   Update a deployment's status by deployment_id within a project. Returns: the updated deployment with id, iid, ref, sha, status, and nested user, environment, and deployable objects. See also: environment.deployment_get, environment.deployment_list, environment.deployment_approve_or_reject.

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

   Token fine-grained: Deployment: Update en proyecto

10. environment.freeze_create

    Create Freeze Period

    Create a deploy freeze period for a project. Returns: the created freeze period with id, freeze_start/freeze_end cron expressions, and cron_timezone.

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

    Token fine-grained: Freeze Period: Create en proyecto

11. environment.freeze_delete

    Delete Freeze Perioddestructiva

    Delete a deploy freeze period. Returns: no content on success (HTTP 204).

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

    Token fine-grained: Freeze Period: Delete en proyecto

12. environment.freeze_get

    Get Freeze Periodsolo lectura

    Get a specific deploy freeze period. Returns: the freeze period's id, freeze_start/freeze_end cron expressions, cron_timezone, and created/updated timestamps.

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

    Token fine-grained: Freeze Period: Read en proyecto

13. environment.freeze_list

    List Freeze Periodssolo lectura

    List deploy freeze periods for a project. Returns: each freeze period's id, freeze_start/freeze_end cron expressions, cron_timezone, and created/updated timestamps.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Freeze Period: Read en proyecto

14. environment.freeze_update

    Update Freeze Period

    Update an existing deploy freeze period. Returns: the updated freeze period with id, freeze_start/freeze_end cron expressions, and cron_timezone.

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

    Token fine-grained: Freeze Period: Update en proyecto

15. environment.get

    Environment Getsolo lectura

    Get one environment by environment_id. Use when inspecting state, tier, external URL, and stop behavior of a specific environment.

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

    Token fine-grained: Environment: Read en proyecto

16. environment.list

    Environment Listsolo lectura

    List environments in one project with filters and pagination. Use this to discover environment IDs before get/update/stop/delete operations.

    Parámetros obligatorios: project_id (string|integer)

    Token fine-grained: Environment: Read en proyecto

17. environment.stop

    Environment Stopdestructiva

    Stop an active environment. This is modeled as a delete-style action but intentionally marked non-destructive because it changes runtime state without deleting the environment resource.

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

    Token fine-grained: Environment: Stop en proyecto

18. environment.update

    Environment Update

    Update an existing environment in a project. Returns: the updated environment with state, tier, external URL, cluster agent, Kubernetes namespace, Flux resource path, and auto-stop settings. See also: environment.get, environment.list, environment.stop.

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

    Token fine-grained: Environment: Update en proyecto