AWS ECS CLI

The Paradime SDK provides CLI commands to interact with AWS ECS, allowing you to run one or more tasks and list active task definitions.

AWS credentials are read from environment variables or the AWS credential chain:

Run one or more AWS ECS tasks.

paradime run aws-ecs-trigger

Options

Flag	Type	Description
`--aws-access-key-id`	Optional, TEXT	AWS Access Key ID for authentication. [env: `AWS_ACCESS_KEY_ID`]
`--aws-secret-access-key`	Optional, TEXT	AWS Secret Access Key for authentication. [env: `AWS_SECRET_ACCESS_KEY`]
`--aws-session-token`	Optional, TEXT	Optional AWS Session Token for temporary credentials. [env: `AWS_SESSION_TOKEN`]
`--aws-region`	Optional, TEXT	AWS region name (e.g., us-east-1). [env: `AWS_REGION`]
`--cluster`	Required, TEXT	ECS cluster name or ARN.
`--task-definitions`	Required, TEXT (comma-separated)	Comma-separated task definition name(s) or ARN(s) to run
`--launch-type`	Optional, CHOICE	Launch type for the task. Choices: `FARGATE`, `EC2`. Default: `FARGATE`.
`--subnets`	Optional, TEXT (comma-separated)	Comma-separated subnet ID(s) for awsvpc network mode.
`--security-groups`	Optional, TEXT (comma-separated)	Comma-separated security group ID(s) for awsvpc network mode.
`--assign-public-ip` / `--no-assign-public-ip`	Optional, Flag	Assign public IP to the task (Fargate only). Default: `--no-assign-public-ip`.
`--wait` / `--no-wait`	Optional, Flag	Wait for tasks to complete before returning. Default: `--wait`. [env: `AWS_ECS_TRIGGER_WAIT`]
`--timeout`	Optional, INTEGER	Maximum time to wait in minutes. Default: 1440. [env: `AWS_ECS_TRIGGER_TIMEOUT`]
`--json`	Optional, Flag	Output results as JSON. Default: `False`.
`--help`	Optional, Flag	Show the help message and exit.

Example

paradime run aws-ecs-trigger \
  --cluster my-cluster \
  --task-definitions task1,task2 \
  --subnets subnet-abc

List active AWS ECS task definitions.

paradime run aws-ecs-list

Options

Flag	Type	Description
`--aws-access-key-id`	Optional, TEXT	AWS Access Key ID for authentication. [env: `AWS_ACCESS_KEY_ID`]
`--aws-secret-access-key`	Optional, TEXT	AWS Secret Access Key for authentication. [env: `AWS_SECRET_ACCESS_KEY`]
`--aws-session-token`	Optional, TEXT	Optional AWS Session Token for temporary credentials. [env: `AWS_SESSION_TOKEN`]
`--aws-region`	Optional, TEXT	AWS region name (e.g., us-east-1). [env: `AWS_REGION`]
`--json`	Optional, Flag	Output results as JSON. Default: `False`.
`--help`	Optional, Flag	Show the help message and exit.

Example

paradime run aws-ecs-list