terraform-provider-google/website/docs/r/filestore_instance.html.markdown
The Magician 63216b0c90 Mark Filestore as GA (#3522)
Signed-off-by: Modular Magician <magic-modules@google.com>
2019-05-02 10:29:08 -07:00

4.6 KiB

layout page_title sidebar_current description
google Google: google_filestore_instance docs-google-filestore-instance A Google Cloud Filestore instance.

google_filestore_instance

A Google Cloud Filestore instance.

To get more information about Instance, see:

## Example Usage - Filestore Instance Basic
resource "google_filestore_instance" "instance" {
  name = "test-instance"
  zone = "us-central1-b"
  tier = "PREMIUM"

  file_shares {
    capacity_gb = 2660
    name        = "share1"
  }

  networks {
    network = "default"
    modes   = ["MODE_IPV4"]
  }
}

Argument Reference

The following arguments are supported:

  • name - (Required) The resource name of the instance.

  • tier - (Required) The service tier of the instance.

  • file_shares - (Required) File system shares on the instance. For this version, only a single file share is supported. Structure is documented below.

  • networks - (Required) VPC networks to which the instance is connected. For this version, only a single network is supported. Structure is documented below.

  • zone - (Required) The name of the Filestore zone of the instance.

The file_shares block supports:

  • name - (Required) The name of the fileshare (16 characters or less)

  • capacity_gb - (Required) File share capacity in GB.

The networks block supports:

  • network - (Required) The name of the GCE VPC network to which the instance is connected.

  • modes - (Required) IP versions for which the instance has IP addresses assigned.

  • reserved_ip_range - (Optional) A /29 CIDR block that identifies the range of IP addresses reserved for this instance.

  • ip_addresses - A list of IPv4 or IPv6 addresses.


  • description - (Optional) A description of the instance.

  • labels - (Optional) Resource labels to represent user-provided metadata.

  • project - (Optional) The ID of the project in which the resource belongs. If it is not provided, the provider project is used.

Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

  • create_time - Creation timestamp in RFC3339 text format.

  • etag - Server-specified ETag for the instance resource to prevent simultaneous updates from overwriting each other.

Timeouts

This resource provides the following Timeouts configuration options:

  • create - Default is 6 minutes.
  • update - Default is 6 minutes.
  • delete - Default is 6 minutes.

Import

Instance can be imported using any of these accepted formats:

$ terraform import google_filestore_instance.default projects/{{project}}/locations/{{zone}}/instances/{{name}}
$ terraform import google_filestore_instance.default {{project}}/{{zone}}/{{name}}
$ terraform import google_filestore_instance.default {{name}}

-> If you're importing a resource with beta features, make sure to include -provider=google-beta as an argument so that Terraform uses the correct provider to import your resource.