github.com/xsb/terraform@v0.6.13-0.20160314145438-fe415c2f09d7/website/source/docs/providers/aws/r/kms_alias.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_kms_alias"
     4  sidebar_current: "docs-aws-resource-kms-alias"
     5  description: |-
     6    Provides a display name for a customer master key.
     7  ---
     8  
     9  # aws\_kms\_alias
    10  
    11  Provides an alias for a KMS customer master key. AWS Console enforces 1-to-1 mapping between aliases & keys,
    12  but API (hence Terraform too) allows you to create as many aliases as
    13  the [account limits](http://docs.aws.amazon.com/kms/latest/developerguide/limits.html) allow you.
    14  
    15  ## Example Usage
    16  
    17  ```
    18  resource "aws_kms_key" "a" {
    19  }
    20  
    21  resource "aws_kms_alias" "a" {
    22      name = "alias/my-key-alias"
    23      target_key_id = "${aws_kms_key.a.key_id}"
    24  }
    25  ```
    26  
    27  ## Argument Reference
    28  
    29  The following arguments are supported:
    30  
    31  * `name` - (Required) The display name of the alias. The name must start with the word "alias" followed by a forward slash (alias/)
    32  * `target_key_id` - (Required) Identifier for the key for which the alias is for, can be either an ARN or key_id.
    33  
    34  ## Attributes Reference
    35  
    36  The following attributes are exported:
    37  
    38  * `arn` - The Amazon Resource Name (ARN) of the key alias.