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

# plerion aws

> AWS integration helpers for external IDs, CloudFormation, and tokens.

With **plerion aws**, you can access AWS integration helpers including external ID retrieval, CloudFormation template generation, and temporary token generation.

***

## Synopsis

```bash theme={"system"}
plerion aws <subcommand> [options]
```

***

## Subcommands

### get-external-id

Returns the tenant's external ID used for cross-account AWS role trust policies.

```bash theme={"system"}
plerion aws get-external-id
```

### get-cloudformation-template

Returns the CloudFormation template for setting up a Plerion AWS integration.

```bash theme={"system"}
plerion aws get-cloudformation-template --type <type>
```

| Option   | Type   | Description                                                |
| -------- | ------ | ---------------------------------------------------------- |
| `--type` | string | **(required)** Template type. Allowed values: `AWSAccount` |

### generate-token

Generates a temporary authentication token for an AWS integration.

```bash theme={"system"}
plerion aws generate-token --integration-id <id>
```

***

## Examples

```bash theme={"system"}
# Get the external ID for AWS role trust policy
plerion aws get-external-id --output json | jq '.data.externalId'

# Download the CloudFormation template
plerion aws get-cloudformation-template --type AWSAccount > plerion-template.json

# Generate a temporary token
plerion aws generate-token --integration-id int-abc123
```

### Example output (get-external-id, JSON)

```json theme={"system"}
{
  "data": {
    "externalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
```