# Create account alias

Create account alias.

## Usage

```bash
tkm org accounts create-alias \
  --account-id <account-id> \
  --alias <alias>
```

## Positional arguments

This command has no positional arguments.

## Options

In addition to the [common options](https://docs.takomo.io/command-line-usage/common-options), this command has the following options.

* `--account-id <account id>`
  * Account id. Required.
* `--alias <alias>`
  * Account alias to create. Required.

## IAM permissions

These are the minimum IAM permissions required to run this command.

```yaml
# Permission needed to assume a role from the target account
# used to create the account alias.
Statement:
  - Effect: Allow
    Action: sts:AssumeRole
    Resource: "*"
```

The role in the target account must have the following permissions.

```yaml
Statement:
  - Effect: Allow
    Action: iam:CreateAccountAlias
    Resource: "*"
```

## Examples

Create account alias

```bash
tkm org accounts create-alias \
  --account-id 123456789012 \
  --alias my-account-alias
```