github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/website/source/docs/providers/aws/r/efs_mount_target.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_efs_mount_target"
     4  sidebar_current: "docs-aws-resource-efs-mount-target"
     5  description: |-
     6    Provides an Elastic File System (EFS) mount target.
     7  ---
     8  
     9  # aws\_efs\_mount\_target
    10  
    11  Provides an Elastic File System (EFS) mount target.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "aws_efs_mount_target" "alpha" {
    17    file_system_id = "${aws_efs_file_system.foo.id}"
    18    subnet_id      = "${aws_subnet.alpha.id}"
    19  }
    20  
    21  resource "aws_vpc" "foo" {
    22    cidr_block = "10.0.0.0/16"
    23  }
    24  
    25  resource "aws_subnet" "alpha" {
    26    vpc_id            = "${aws_vpc.foo.id}"
    27    availability_zone = "us-west-2a"
    28    cidr_block        = "10.0.1.0/24"
    29  }
    30  ```
    31  
    32  ## Argument Reference
    33  
    34  The following arguments are supported:
    35  
    36  * `file_system_id` - (Required) The ID of the file system for which the mount target is intended.
    37  * `subnet_id` - (Required) The ID of the subnet to add the mount target in.
    38  * `ip_address` - (Optional) The address (within the address range of the specified subnet) at
    39  which the file system may be mounted via the mount target.
    40  * `security_groups` - (Optional) A list of up to 5 VPC security group IDs (that must
    41  be for the same VPC as subnet specified) in effect for the mount target.
    42  
    43  ## Attributes Reference
    44  
    45  ~> **Note:** The `dns_name` attribute is only useful if the mount target is in a VPC that has
    46  support for DNS hostnames enabled. See [Using DNS with Your VPC](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-dns.html)
    47  and [VPC resource](https://www.terraform.io/docs/providers/aws/r/vpc.html#enable_dns_hostnames) in Terraform for more information.
    48  
    49  The following attributes are exported:
    50  
    51  * `id` - The ID of the mount target.
    52  * `dns_name` - The DNS name for the given subnet/AZ per [documented convention](http://docs.aws.amazon.com/efs/latest/ug/mounting-fs-mount-cmd-dns-name.html).
    53  * `network_interface_id` - The ID of the network interface that Amazon EFS created when it created the mount target.
    54  
    55  ## Import
    56  
    57  The EFS mount targets can be imported using the `id`, e.g.
    58  
    59  ```
    60  $ terraform import aws_efs_mount_target.alpha fsmt-52a643fb
    61  ```