Get a single environment

GET

/api/v3/organizations/{organisation}/applications/{application}/environments/{environment}

const url = 'https://dashboard.quantcdn.io/api/v3/organizations/test-org/applications/test-app/environments/test-env';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://dashboard.quantcdn.io/api/v3/organizations/test-org/applications/test-app/environments/test-env \
  --header 'Authorization: Bearer <token>'

Authorizations

BearerAuth

Parameters

Path Parameters

organisation

required

string

The organisation ID

Example

test-org

application

required

string

The application ID

Example

test-app

environment

required

string

The environment ID

Example

test-env

Responses

200

The environment with runtime details

application/json

Environment response schema with runtime details

object

envName

required

Environment name

string

status

Environment status

string

runningCount

Number of running tasks

integer

desiredCount

Desired number of tasks

integer

minCapacity

Minimum capacity for autoscaling

integer

maxCapacity

Maximum capacity for autoscaling

integer

publicIpAddress

Public IP address for SSH access

string

nullable

deploymentStatus

Current deployment status

string

Allowed values: COMPLETED IN_PROGRESS FAILED

deploymentFailureType

Why the most recent task stopped. SPOT_INTERRUPTION is informational: AWS reclaimed the task and ECS replaces it.

string

nullable

Allowed values: IMAGE_NOT_FOUND ACCESS_DENIED ARCHITECTURE_MISMATCH RESOURCE_LIMIT SPOT_INTERRUPTION OTHER

deploymentFailureReason

Reason for deployment failure

string

nullable

taskDefinition

ECS task definition details

object

service

ECS service details

object

loadBalancer

Load balancer configuration

object

securityGroup

Security group configuration

object

subnet

Subnet configuration

object

vpc

VPC configuration

object

containerNames

Container name list

Array<string>

volumes

Persistent storage volumes

Array<object>

object

volumeId

string

volumeName

string

description

string

environmentEfsId

string

createdAt

string

rootDirectory

string

accessPointId

string

accessPointArn

string

cron

Scheduled cron jobs

Array<object>

object

name

string

description

string

nullable

scheduleExpression

string

command

Array<string>

targetContainerName

string

nullable

isEnabled

boolean

albRouting

ALB routing configuration

object

createdAt

Creation timestamp

string format: date-time

updatedAt

Last update timestamp

string format: date-time

Example

{
  "envName": "production",
  "status": "ACTIVE",
  "runningCount": 2,
  "desiredCount": 2,
  "minCapacity": 1,
  "maxCapacity": 5,
  "publicIpAddress": "54.123.45.67",
  "deploymentStatus": "COMPLETED",
  "deploymentFailureType": "IMAGE_NOT_FOUND"
}

404

The environment not found