# 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
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://organizations.takomo.io/command-line-usage/account/create-account-alias.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.