Amazon Fargate · Schema

Service

An Amazon ECS service

ComputeContainersECSEKSMicroservicesServerless

Properties

Name Type Description
serviceArn string ARN of the service
serviceName string Name of the service
clusterArn string ARN of the cluster
taskDefinition string Task definition ARN or family:revision
desiredCount integer Desired number of tasks
runningCount integer Number of running tasks
pendingCount integer Number of pending tasks
status string Service status
launchType string Launch type
networkConfiguration object
loadBalancers array Load balancer configurations
createdAt string Service creation time
tags array Tags
View JSON Schema on GitHub

JSON Schema

amazon-fargate-service-schema.json Raw ↑
{
  "$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-service-schema.json",
  "title": "Service",
  "description": "An Amazon ECS service",
  "type": "object",
  "properties": {
    "serviceArn": {
      "type": "string",
      "description": "ARN of the service",
      "example": "arn:aws:ecs:us-east-1:123456789012:service/my-fargate-cluster/my-fargate-service"
    },
    "serviceName": {
      "type": "string",
      "description": "Name of the service",
      "example": "my-fargate-service"
    },
    "clusterArn": {
      "type": "string",
      "description": "ARN of the cluster",
      "example": "arn:aws:ecs:us-east-1:123456789012:cluster/my-fargate-cluster"
    },
    "taskDefinition": {
      "type": "string",
      "description": "Task definition ARN or family:revision",
      "example": "my-fargate-task:1"
    },
    "desiredCount": {
      "type": "integer",
      "description": "Desired number of tasks",
      "example": 2
    },
    "runningCount": {
      "type": "integer",
      "description": "Number of running tasks",
      "example": 2
    },
    "pendingCount": {
      "type": "integer",
      "description": "Number of pending tasks",
      "example": 0
    },
    "status": {
      "type": "string",
      "description": "Service status",
      "example": "ACTIVE",
      "enum": [
        "ACTIVE",
        "DRAINING",
        "INACTIVE"
      ]
    },
    "launchType": {
      "type": "string",
      "description": "Launch type",
      "example": "FARGATE"
    },
    "networkConfiguration": {
      "$ref": "#/components/schemas/NetworkConfiguration"
    },
    "loadBalancers": {
      "type": "array",
      "description": "Load balancer configurations",
      "items": {
        "$ref": "#/components/schemas/LoadBalancer"
      }
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Service creation time"
    },
    "tags": {
      "type": "array",
      "description": "Tags",
      "items": {
        "$ref": "#/components/schemas/Tag"
      }
    }
  }
}