> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AWS ECS CLI

> Run Amazon ECS tasks and list active task definitions directly from Paradime Bolt using the paradime run aws-ecs CLI commands.

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

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

  * `AWS_ACCESS_KEY_ID`
  * `AWS_SECRET_ACCESS_KEY`
  * `AWS_SESSION_TOKEN` (optional)
  * `AWS_REGION`
</Info>

### Run ECS Tasks

Run one or more AWS ECS tasks.

```bash theme={"system"}
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**

```bash theme={"system"}
paradime run aws-ecs-trigger \
  --cluster my-cluster \
  --task-definitions task1,task2 \
  --subnets subnet-abc
```

### List ECS Task Definitions

List active AWS ECS task definitions.

```bash theme={"system"}
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**

```bash theme={"system"}
paradime run aws-ecs-list
```


## Related topics

- [AWS Glue CLI](/developers/paradime-cli/aws-glue-cli.md)
- [AWS Lambda CLI](/developers/paradime-cli/aws-lambda-cli.md)
- [AWS Step Functions CLI](/developers/paradime-cli/aws-step-functions-cli.md)
- [AWS SageMaker CLI](/developers/paradime-cli/aws-sagemaker-cli.md)
- [Paradime CLI](/developers/paradime-cli/index.md)