github.com/ves/terraform@v0.8.0-beta2/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  ~> **NOTE:** As per the current [documentation](https://docs.aws.amazon.com/efs/latest/ug/limits.html)
    14  the limit is 1 mount target per Availability Zone for a single EFS file system.
    15  
    16  ## Example Usage
    17  
    18  ```
    19  resource "aws_efs_mount_target" "alpha" {
    20    file_system_id = "${aws_efs_file_system.foo.id}"
    21    subnet_id = "${aws_subnet.alpha.id}"
    22  }
    23  
    24  resource "aws_vpc" "foo" {
    25    cidr_block = "10.0.0.0/16"
    26  }
    27  
    28  resource "aws_subnet" "alpha" {
    29    vpc_id = "${aws_vpc.foo.id}"
    30    availability_zone = "us-west-2a"
    31    cidr_block = "10.0.1.0/24"
    32  }
    33  ```
    34  
    35  ## Argument Reference
    36  
    37  The following arguments are supported:
    38  
    39  * `file_system_id` - (Required) The ID of the file system for which the mount target is intended.
    40  * `subnet_id` - (Required) The ID of the subnet to add the mount target in.
    41  * `ip_address` - (Optional) The address (within the address range of the specified subnet) at
    42  which the file system may be mounted via the mount target.
    43  * `security_groups` - (Optional) A list of up to 5 VPC security group IDs (that must
    44  be for the same VPC as subnet specified) in effect for the mount target.
    45  
    46  ## Attributes Reference
    47  
    48  ~> **Note:** The `dns_name` attribute is only useful if the mount target is in a VPC that has
    49  support for DNS hostnames enabled. See [Using DNS with Your VPC](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/vpc-dns.html)
    50  and [VPC resource](https://www.terraform.io/docs/providers/aws/r/vpc.html#enable_dns_hostnames) in Terraform for more information.
    51  
    52  The following attributes are exported:
    53  
    54  * `id` - The ID of the mount target.
    55  * `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).
    56  * `network_interface_id` - The ID of the network interface that Amazon EFS created when it created the mount target.
    57  
    58  ## Import
    59  
    60  The EFS mount targets can be imported using the `id`, e.g.
    61  
    62  ```
    63  $ terraform import aws_efs_mount_target.alpha fsmt-52a643fb
    64  ```