ionoscloud_nfs_share

Get information on Network File Storage (NFS) Share objects

Returns information about shares of Network File Storage (NFS) on IonosCloud.

Example Usage

By ID

data "ionoscloud_nfs_share" "example" {
  location = "location"
  cluster_id = "cluster-id"
  id = "share-id"
}

By Name

data "ionoscloud_nfs_share" "example" {
  location = "location"
  cluster_id = "cluster-id"
  name = "partial-name"
  partial_match = true
}

output "share_test_output" {
    value = format("share %s quota %sMiB path '%s'",
        data.ionoscloud_nfs_share.example.name,
        data.ionoscloud_nfs_share.example.quota,
        data.ionoscloud_nfs_share.example.nfs_path,
    )
}

Argument Reference

• location - (Optional) The location where the Network File Storage share is located. Available locations: de/fra, de/fra/2, de/txl, fr/par, gb/lhr, es/vit, us/las, us/ewr, us/mci.

• cluster_id - (Required) The ID of the Network File Storage cluster.

• name - (Optional) Name of the Network File Storage share.

• id - (Optional) ID of the Network File Storage share.

• partial_match - (Optional) Whether partial matching is allowed or not when using the name filter. Defaults to false.

Attributes Reference

• id - The ID of the Network File Storage share.

• name - The name of the Network File Storage share.

• location - The location where the Network File Storage share is located.

• cluster_id - The ID of the Network File Storage cluster.

• nfs_path - Path to the NFS export. The NFS path is the path to the directory being exported.

• quota - The quota in MiB for the export. The quota can restrict the amount of data that can be stored within the export. The quota can be disabled using 0.

• gid - The group ID that will own the exported directory. If not set, anonymous (512) will be used.

• uid - The user ID that will own the exported directory. If not set, anonymous (512) will be used.

• client_groups - The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:

  • description - Optional description for the clients groups.

  • ip_networks - The allowed host or network to which the export is being shared. The IP address can be either IPv4 or IPv6 and has to be given with CIDR notation.

  • hosts - A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.

  • nfs - The NFS configuration for the client group. Each NFS configuration supports the following:

    • squash - The squash mode for the export. The squash mode can be: none - No squash mode. no mapping, root-anonymous - Map root user to anonymous uid, all-anonymous - Map all users to anonymous uid.