# exo iam role create
### Description

This command creates a new IAM Role.
To read the Policy from STDIN, append '-' to the '--policy' flag.

Pro Tip: you can reuse an existing role policy by providing the output of the show command as input:

	exo iam role show --policy --output-format json <role-name> | exo iam role create <new-role-name> --policy -

Supported output template annotations: .ID, .Name, .Description, .Editable, .Labels, .Permissions

```
exo iam role create NAME [flags]
```

### Options

| Option | Description |
|---------|------------|
|`--description` | Role description |
|`--editable` | Set --editable=false do prevent editing Policy after creation |
|`--help, -h` | help for create |
|`--label` | Role labels (format: key=value) |
|`--permissions` | Role permissions |
|`--policy` | Role policy (use &#39;-&#39; to read from STDIN) |


### Options inherited from parent commands

| Option | Description |
|---------|------------|
|`--config, -C` | Specify an alternate config file [env EXOSCALE_CONFIG] |
|`--output-format, -O` | Output format (table\|json\|text), see &#34;exo output --help&#34; for more information |
|`--output-template` | Template to use if output format is &#34;text&#34; |
|`--quiet, -Q` | Quiet mode (disable non-essential command output) |
|`--timeout` | Per-zone timeout for list operations; -1s disables timeout [env EXOSCALE_TIMEOUT] |
|`--use-account, -A` | Account to use in config file [env EXOSCALE_ACCOUNT] |


### Related Commands

* [role]({{< ref "../role">}})	 - IAM Role management