Amazon CodeDeploy · JSON Structure

Amazon Codedeploy Ecs Task Set Structure

Information about a set of Amazon ECS tasks in an CodeDeploy deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic. An CodeDeploy application that uses the Amazon ECS compute platform deploys a containerized application in an Amazon ECS service as a task set.

Type: object Properties: 8
AmazonDeploymentDevOpsCI/CDRelease ManagementBlue/Green Deployment

ECSTaskSet is a JSON Structure definition published by Amazon CodeDeploy, describing 8 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

identifer desiredCount pendingCount runningCount status trafficWeight targetGroup taskSetLabel

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-codedeploy/refs/heads/main/json-structure/amazon-codedeploy-ecs-task-set-structure.json",
  "name": "ECSTaskSet",
  "description": " Information about a set of Amazon ECS tasks in an CodeDeploy deployment. An Amazon ECS task set includes details such as the desired number of tasks, how many tasks are running, and whether the task set serves production traffic. An CodeDeploy application that uses the Amazon ECS compute platform deploys a containerized application in an Amazon ECS service as a task set. ",
  "type": "object",
  "properties": {
    "identifer": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ECSTaskSetIdentifier"
        },
        {
          "description": " A unique ID of an <code>ECSTaskSet</code>. "
        }
      ]
    },
    "desiredCount": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ECSTaskSetCount"
        },
        {
          "description": " The number of tasks in a task set. During a deployment that uses the Amazon ECS compute type, CodeDeploy instructs Amazon ECS to create a new task set and uses this value to determine how many tasks to create. After the updated task set is created, CodeDeploy shifts traffic to the new task set. "
        }
      ]
    },
    "pendingCount": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ECSTaskSetCount"
        },
        {
          "description": " The number of tasks in the task set that are in the <code>PENDING</code> status during an Amazon ECS deployment. A task in the <code>PENDING</code> state is preparing to enter the <code>RUNNING</code> state. A task set enters the <code>PENDING</code> status when it launches for the first time, or when it is restarted after being in the <code>STOPPED</code> state. "
        }
      ]
    },
    "runningCount": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ECSTaskSetCount"
        },
        {
          "description": " The number of tasks in the task set that are in the <code>RUNNING</code> status during an Amazon ECS deployment. A task in the <code>RUNNING</code> state is running and ready for use. "
        }
      ]
    },
    "status": {
      "allOf": [
        {
          "$ref": "#/components/schemas/ECSTaskSetStatus"
        },
        {
          "description": "<p> The status of the task set. There are three valid task set statuses: </p> <ul> <li> <p> <code>PRIMARY</code>: Indicates the task set is serving production traffic. </p> </li> <li> <p> <code>ACTIVE</code>: Indicates the task set is not serving production traffic. </p> </li> <li> <p> <code>DRAINING</code>: Indicates the tasks in the task set are being stopped and their corresponding targets are being deregistered from their target group. </p> </li> </ul>"
        }
      ]
    },
    "trafficWeight": {
      "allOf": [
        {
          "$ref": "#/components/schemas/TrafficWeight"
        },
        {
          "description": " The percentage of traffic served by this task set. "
        }
      ]
    },
    "targetGroup": {
      "allOf": [
        {
          "$ref": "#/components/schemas/TargetGroupInfo"
        },
        {
          "description": " The target group associated with the task set. The target group is used by CodeDeploy to manage traffic to a task set. "
        }
      ]
    },
    "taskSetLabel": {
      "allOf": [
        {
          "$ref": "#/components/schemas/TargetLabel"
        },
        {
          "description": " A label that identifies whether the ECS task set is an original target (<code>BLUE</code>) or a replacement target (<code>GREEN</code>). "
        }
      ]
    }
  }
}