# Template alias operations


A *template alias* is a reference to a version of a template. For example, suppose that you create the template alias `exampleAlias` for version 1 of the template `exampleTemp`. You can use the template alias `exampleAlias` to reference version 1 of template `exampleTemp` in a `DescribeTemplate` API operation, as in the following example.

```
aws quicksight describe-template 
    --aws-account-id AWSACCOUNTID 
    --template-id exampleTempID 
    --alias-name exampleAlias
```

With template alias API operations, you can perform actions on Quick Sight template aliases. For more information, see the following API operations.

**Topics**
+ [

# CreateTemplateAlias
](create-template-alias.md)
+ [

# DeleteTemplateAlias
](delete-template-alais.md)
+ [

# DescribeTemplateAlias
](describe-template-alias.md)
+ [

# ListTemplateAliases
](list-template-aliases.md)
+ [

# UpdateTemplateAlias
](update-template-alias.md)

# CreateTemplateAlias


Use the `CreateTemplateAlias` operation to create a template alias for a template. To use this operation, you need the ID of the template that you want to create an alias for. You can use the `ListTemplates` operation to list all templates and their corresponding template IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight create-template-alias 
    --aws-account-id AWSACCOUNTID 
    --template-id TEMPLATEID 
    --alias-name ALIAS 
    --template-version-number VERSION
```

You can also make this command using a CLI skeleton file with the following command. For more information about CLI skeleton files, see [Use CLI skeleton files](cli-skeletons.md).

```
aws quicksight create-template-alias 
    --cli-input-json file://createtemplatealias.json
```

------

For more information about the `CreateTemplateAlias` operation, see [CreateTemplateAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateTemplateAlias) in the *Quick Sight API Reference*.

# DeleteTemplateAlias


Use the `DeleteTemplateAlias` operation to delete the item that the specified template alias points to. If you provide a specific alias, you delete the version of the template that the alias points to. To use this operation, you need the ID of the template that is using the alias you want to delete. You can use the `ListTemplates` operation to list all templates and their corresponding template IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight delete-template-alias 
    --aws-account-id AWSACCOUNTID 
    --template-id TEMPLATEID 
    --alias-name ALIAS
```

------

For more information about the `DeleteTemplateAlias` operation, see [DeleteTemplateAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteTemplateAlias) in the *Quick Sight API Reference*.

# DescribeTemplateAlias


Use the `DescribeTemplateAlias` operation to describe the template alias for a template. To use this operation, you need the ID of the template that is using the alias that you want to describe. You can use the `ListTemplates` operation to list all templates and their corresponding template IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight describe-template-alias
    --aws-account-id AWSACCOUNTID 
    --template-id 222244446666 
    --alias-name ALIAS
```

------

The parameter value for `alias-name` can be `$LATEST`.

For more information about the `DescribeTemplateAlias` operation, see [DescribeTemplateAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeTemplateAlias) in the *Quick Sight API Reference*.

# ListTemplateAliases


Use the `ListTemplateAliases` operation to list all the aliases of a template. To use this operation, you need the ID of the template that is using the aliases that you want to list. You can use the `ListTemplates` operation to list all templates and their corresponding template IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight list-template-aliases 
    --aws-account-id AWSACCOUNTID 
    --template-id TEMPLATEID 
    --page-size 10
    --max-items 100
```

------

For more information about the `ListTemplateAliases` operation, see [ListTemplateAliases](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListTemplateAliases) in the *Quick Sight API Reference*.

# UpdateTemplateAlias


Use the `UpdateTemplateAlias` operation to update the template alias of a template. To use this operation, you need the ID of the template that is using the alias that you want to update. You can use the `ListTemplates` operation to list all templates and their corresponding template IDs.

Following is an example AWS CLI command for this operation.

------
#### [ AWS CLI ]

```
aws quicksight update-template-alias 
    --aws-account-id AWSACCOUNTID 
    --template-id TEMPLATEID 
    --alias-name ALIAS 
    --template-version-number VERSION
```

You can also make this command using a CLI skeleton file with the following command. For more information about CLI skeleton files, see [Use CLI skeleton files](cli-skeletons.md).

```
aws quicksight update-template-alias 
    --cli-input-json file://updatetemplatealias.json
```

------

The parameter value for `alias-name` can be `$LATEST`.

For more information about the `UpdateTemplateAlias` operation, see [UpdateTemplateAlias](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateTemplateAlias) in the *Quick Sight API Reference*.