List Containers
Retrieve a list of containers for a specific app.
Authorizations
Service Account Token authentication. To authenticate API requests:
-
Create a Service Account Token:
- Go to the Cerebrium Dashboard and open the API Keys page
- Click Create Service Account, name it (e.g., "GitHub Actions CI/CD"), choose an expiry date, and click Create
- Copy the token generated for the desired service account
-
Use the Token: Include the service account token in the Authorization header of API requests:
Authorization: Bearer <your-service-account-token> -
Best Practices:
- Create separate service accounts for different environments (dev, staging, prod)
- Store tokens securely as secrets in consuming applications or workflows
- Set appropriate expiry dates and rotate tokens regularly
- Never commit tokens to source control
For CI/CD integration examples, see the CI/CD documentation.
Response
A list of the app's current containers with their lifecycle and readiness state.
Identifier of the app the container belongs to.
Readiness of the container to serve traffic (Ready, NotReady, or Terminating).
Unique identifier of the container instance.
Total number of times the container has restarted.
How long the container has been running, in milliseconds.
Time the container started (ISO 8601). Omitted if the container has not started.
Lifecycle state of the container (Running, Succeeded, Failed, or Pending).
Time the container stopped serving (ISO 8601). Omitted if the container has not terminated.
IP address of the host machine running the container.
Instance name of the container; matches containerId.
Identifier of the project the app belongs to.
Deployment revision of the app this container is serving. Omitted if unavailable.
Time at which this status snapshot was taken (ISO 8601).