---
title: "Containers (ECS) and Pipeline"
description: "Run Docker images in Istanbul on a dedicated or serverless node pool; services, scaling, domains, private registry and Git-driven builds (Gyro Pipeline)."
url: https://www.gyrohosting.com/developers/en/products/containers.html
language: en
openapi: https://www.gyrohosting.com/developers/openapi.json
api_version: 2.30.0
---

# Containers (ECS) and Pipeline

Run Docker images in Istanbul on a dedicated or serverless node pool; services, scaling, domains, private registry and Git-driven builds (Gyro Pipeline).


## How-to guides

- [Run a container service](https://www.gyrohosting.com/developers/en/howto/container-service.md)
- [Deploy on git push (Gyro Pipeline)](https://www.gyrohosting.com/developers/en/howto/container-pipeline.md)
- [Containers: egress IPs and internal addresses](https://www.gyrohosting.com/developers/en/guides/container-network.md)

## Containers

Gyro Containers (ECS), Istanbul tr-ist-1: run Docker images on a node pool dedicated to you (no other customer's containers on your nodes). Services with zero-downtime deploys, revision history and rollback, scaling, environment variables and encrypted secrets, HTTPS address <name>-<code>.gyroapp.net plus your own domains (free certificates), logs and metrics. Order the environment like any product (`/cloud/services` lists it); manage it here.

- `GET /cloud/containers/{id}/services` — [List container services](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__services)
- `POST /cloud/containers/{id}/services` — [Create a container service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__services)
- `GET /cloud/containers/{id}/services/{name}` — [Get a container service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__services__name)
- `PATCH /cloud/containers/{id}/services/{name}` — [Deploy a new version / change settings](https://www.gyrohosting.com/developers/en/api/containers.md#typed_patch_containers__id__services__name)
- `DELETE /cloud/containers/{id}/services/{name}` — [Delete a container service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_delete_containers__id__services__name)
- `POST /cloud/containers/{id}/services/{name}/scale` — [Scale a service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__services__name__scale)
- `POST /cloud/containers/{id}/services/{name}/restart` — [Restart a service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__services__name__restart)
- `POST /cloud/containers/{id}/services/{name}/rollback` — [Roll back to an earlier revision](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__services__name__rollback)
- `GET /cloud/containers/{id}/services/{name}/revisions` — [Revision history](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__services__name__revisions)
- `PUT /cloud/containers/{id}/services/{name}/env` — [Set environment variables](https://www.gyrohosting.com/developers/en/api/containers.md#typed_put_containers__id__services__name__env)
- `PUT /cloud/containers/{id}/services/{name}/secrets` — [Set secret values](https://www.gyrohosting.com/developers/en/api/containers.md#typed_put_containers__id__services__name__secrets)
- `DELETE /cloud/containers/{id}/services/{name}/secrets` — [Delete secret values](https://www.gyrohosting.com/developers/en/api/containers.md#typed_delete_containers__id__services__name__secrets)
- `GET /cloud/containers/{id}/services/{name}/logs` — [Service logs](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__services__name__logs)
- `GET /cloud/containers/{id}/services/{name}/metrics` — [Service CPU / memory](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__services__name__metrics)
- `GET /cloud/containers/{id}/services/{name}/domains` — [Domains of a service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__services__name__domains)
- `POST /cloud/containers/{id}/services/{name}/domains` — [Attach a domain](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__services__name__domains)
- `POST /cloud/containers/{id}/services/{name}/domains/verify` — [Re-check pending domains](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__services__name__domains_verify)
- `DELETE /cloud/containers/{id}/services/{name}/domains/{domain}` — [Detach a domain](https://www.gyrohosting.com/developers/en/api/containers.md#typed_delete_containers__id__services__name__domains__domain)
- `PUT /cloud/containers/{id}/services/{name}/autoscaling` — [Autoscaling / alert threshold of a service](https://www.gyrohosting.com/developers/en/api/containers.md#typed_put_containers__id__services__name__autoscaling)
- `GET /cloud/containers/{id}/notifications` — [Notification settings and current alerts](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__notifications)
- `PUT /cloud/containers/{id}/notifications` — [Set notification channels](https://www.gyrohosting.com/developers/en/api/containers.md#typed_put_containers__id__notifications)
- `POST /cloud/containers/{id}/notifications/test` — [Send a test notification](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__notifications_test)
- `POST /cloud/containers/{id}/notifications/webhook-secret` — [Webhook signing secret](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__notifications_webhook_secret)
- `GET /cloud/containers/{id}/nodes` — [Node pool](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__nodes)
- `PUT /cloud/containers/{id}/nodes` — [Set the extra node count](https://www.gyrohosting.com/developers/en/api/containers.md#setContainerNodes)
- `GET /cloud/containers/{id}` — [Container environment detail (namespace, internal addressing, egress IPs)](https://www.gyrohosting.com/developers/en/api/containers.md#getContainerEnvironment)
- `DELETE /cloud/containers/{id}` — [Delete a container environment (prepaid)](https://www.gyrohosting.com/developers/en/api/containers.md#deleteContainerEnvironment)
- `GET /cloud/containers/{id}/egress-ips` — [Egress IPs of a container environment](https://www.gyrohosting.com/developers/en/api/containers.md#getContainerEgressIps)
- `GET /cloud/containers/{id}/events` — [Recent warnings](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__events)
- `PUT /cloud/containers/{id}/egress-approval` — [Approval step for egress changes](https://www.gyrohosting.com/developers/en/api/containers.md#setContainerEgressApproval)
- `POST /cloud/containers/{id}/egress-change/approve` — [Approve the pending egress change](https://www.gyrohosting.com/developers/en/api/containers.md#approveContainerEgressChange)
- `PUT /cloud/containers/{id}/external-registry` — [External private registry credentials](https://www.gyrohosting.com/developers/en/api/containers.md#typed_put_containers__id__external_registry)
- `DELETE /cloud/containers/{id}/external-registry` — [Remove external registry credentials](https://www.gyrohosting.com/developers/en/api/containers.md#typed_delete_containers__id__external_registry)
- `GET /cloud/containers/{id}/registry` — [Gyro image registry of the environment](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__registry)
- `POST /cloud/containers/{id}/registry/credentials` — [Registry password](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__registry_credentials)
- `POST /cloud/containers/{id}/registry/rotate` — [Rotate the registry password](https://www.gyrohosting.com/developers/en/api/containers.md#typed_post_containers__id__registry_rotate)
- `PUT /cloud/containers/{id}/registry/policy` — [Image clean-up policy](https://www.gyrohosting.com/developers/en/api/containers.md#typed_put_containers__id__registry_policy)
- `GET /cloud/containers/{id}/registry/images` — [Images in the registry](https://www.gyrohosting.com/developers/en/api/containers.md#typed_get_containers__id__registry_images)
- `DELETE /cloud/containers/{id}/registry/images` — [Delete an image tag](https://www.gyrohosting.com/developers/en/api/containers.md#typed_delete_containers__id__registry_images)
- `GET /cloud/containers/{id}/registry/imports` — [Image imports (progress and history)](https://www.gyrohosting.com/developers/en/api/containers.md#listContainerImageImports)
- `POST /cloud/containers/{id}/registry/imports` — [Import an image from another registry](https://www.gyrohosting.com/developers/en/api/containers.md#importContainerImage)
- `GET /cloud/containers/{id}/pipelines` — [List pipelines](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_list)
- `POST /cloud/containers/{id}/pipelines` — [Create a pipeline](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_create)
- `GET /cloud/containers/{id}/pipelines/{pipeline}` — [Get a pipeline](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_get)
- `PATCH /cloud/containers/{id}/pipelines/{pipeline}` — [Change a pipeline](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_update)
- `DELETE /cloud/containers/{id}/pipelines/{pipeline}` — [Delete a pipeline](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_delete)
- `GET /cloud/containers/{id}/pipelines/{pipeline}/webhook` — [Webhook address and secret](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_webhook)
- `POST /cloud/containers/{id}/pipelines/{pipeline}/webhook/rotate` — [Rotate the webhook secret](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_rotate_secret)
- `POST /cloud/containers/{id}/pipelines/{pipeline}/test` — [Test repository access](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_test)
- `PUT /cloud/containers/{id}/pipelines/{pipeline}/secrets` — [Set build secrets](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_secret_set)
- `DELETE /cloud/containers/{id}/pipelines/{pipeline}/secrets/{secret}` — [Delete a build secret](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_secret_delete)
- `GET /cloud/containers/{id}/pipelines/{pipeline}/runs` — [Runs of a pipeline](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_runs)
- `POST /cloud/containers/{id}/pipelines/{pipeline}/runs` — [Start a run](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_run)
- `GET /cloud/containers/{id}/pipeline-runs/{run}` — [Get a run](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_run_get)
- `GET /cloud/containers/{id}/pipeline-runs/{run}/logs` — [Run log](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_logs)
- `POST /cloud/containers/{id}/pipeline-runs/{run}/cancel` — [Stop a run](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_cancel)
- `POST /cloud/containers/{id}/pipeline-runs/{run}/approve` — [Approve the deployment](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_approve)
- `POST /cloud/containers/{id}/pipeline-runs/{run}/reject` — [Reject the deployment](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_reject)
- `POST /cloud/containers/{id}/pipeline-runs/{run}/redeploy` — [Deploy this run's image again (rollback)](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_redeploy)
- `POST /cloud/containers/{id}/pipelines/{pipeline}/uploads` — [Upload URL for an archive build](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_upload)
- `PUT /cloud/containers/{id}/pipelines/{pipeline}/deploy-key` — [Create the SSH deploy key](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_deploy_key_create)
- `DELETE /cloud/containers/{id}/pipelines/{pipeline}/deploy-key` — [Delete the SSH deploy key](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_deploy_key_delete)
- `GET /cloud/containers/{id}/pipelines/{pipeline}/host-key` — [SSH server host key](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_host_key_scan)
- `PUT /cloud/containers/{id}/pipelines/{pipeline}/host-key` — [Confirm (or forget) the SSH host key](https://www.gyrohosting.com/developers/en/api/containers.md#pipeline_host_key_trust)
- `GET /cloud/containers/plans` — [List container environment plans](https://www.gyrohosting.com/developers/en/api/containers.md#listContainerPlans)
- `POST /cloud/containers` — [Create container environments (batch)](https://www.gyrohosting.com/developers/en/api/containers.md#createContainerEnvironments)