Task

An Amazon ECS task running on Fargate

ComputeContainersECSEKSMicroservicesServerless

Properties

Name	Type	Description
taskArn	string	ARN of the task
clusterArn	string	ARN of the cluster
taskDefinitionArn	string	ARN of the task definition
lastStatus	string	Last known status
desiredStatus	string	Desired status
launchType	string	Launch type
cpu	string	CPU units
memory	string	Memory in MiB
createdAt	string	Time task was created
startedAt	string	Time task started running
stoppedAt	string	Time task stopped
stoppedReason	string	Reason task stopped
networkInterfaces	array	Network interfaces
tags	array	Tags

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-fargate/refs/heads/main/json-schema/amazon-fargate-task-schema.json",
  "title": "Task",
  "description": "An Amazon ECS task running on Fargate",
  "type": "object",
  "properties": {
    "taskArn": {
      "type": "string",
      "description": "ARN of the task",
      "example": "arn:aws:ecs:us-east-1:123456789012:task/my-fargate-cluster/abc123"
    },
    "clusterArn": {
      "type": "string",
      "description": "ARN of the cluster",
      "example": "arn:aws:ecs:us-east-1:123456789012:cluster/my-fargate-cluster"
    },
    "taskDefinitionArn": {
      "type": "string",
      "description": "ARN of the task definition",
      "example": "arn:aws:ecs:us-east-1:123456789012:task-definition/my-fargate-task:1"
    },
    "lastStatus": {
      "type": "string",
      "description": "Last known status",
      "example": "RUNNING",
      "enum": [
        "PROVISIONING",
        "PENDING",
        "ACTIVATING",
        "RUNNING",
        "DEACTIVATING",
        "STOPPING",
        "DEPROVISIONING",
        "STOPPED",
        "DELETED"
      ]
    },
    "desiredStatus": {
      "type": "string",
      "description": "Desired status",
      "example": "RUNNING"
    },
    "launchType": {
      "type": "string",
      "description": "Launch type",
      "example": "FARGATE",
      "enum": [
        "EC2",
        "FARGATE",
        "EXTERNAL"
      ]
    },
    "cpu": {
      "type": "string",
      "description": "CPU units",
      "example": "256"
    },
    "memory": {
      "type": "string",
      "description": "Memory in MiB",
      "example": "512"
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Time task was created",
      "example": "2026-04-19T12:00:00Z"
    },
    "startedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Time task started running",
      "example": "2026-04-19T12:00:30Z"
    },
    "stoppedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Time task stopped"
    },
    "stoppedReason": {
      "type": "string",
      "description": "Reason task stopped"
    },
    "networkInterfaces": {
      "type": "array",
      "description": "Network interfaces",
      "items": {
        "type": "object"
      }
    },
    "tags": {
      "type": "array",
      "description": "Tags",
      "items": {
        "$ref": "#/components/schemas/Tag"
      }
    }
  }
}