Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ionoscloud Provider
  3. API Docs
  4. getNfsShare
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud
ionos-cloud/terraform-provider-ionoscloud

ionoscloud.getNfsShare

Explore with Pulumi AI

ionoscloud logo
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud
ionos-cloud/terraform-provider-ionoscloud

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

    By ID

    import * as pulumi from "@pulumi/pulumi";
import * as ionoscloud from "@pulumi/ionoscloud";

const example = ionoscloud.getNfsShare({
    clusterId: "cluster-id",
    id: "share-id",
    location: "location",
});

    import pulumi
import pulumi_ionoscloud as ionoscloud

example = ionoscloud.get_nfs_share(cluster_id="cluster-id",
    id="share-id",
    location="location")

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/ionoscloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ionoscloud.LookupNfsShare(ctx, &ionoscloud.LookupNfsShareArgs{
			ClusterId: "cluster-id",
			Id:        pulumi.StringRef("share-id"),
			Location:  pulumi.StringRef("location"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ionoscloud = Pulumi.Ionoscloud;

return await Deployment.RunAsync(() => 
{
    var example = Ionoscloud.GetNfsShare.Invoke(new()
    {
        ClusterId = "cluster-id",
        Id = "share-id",
        Location = "location",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ionoscloud.IonoscloudFunctions;
import com.pulumi.ionoscloud.inputs.GetNfsShareArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var example = IonoscloudFunctions.getNfsShare(GetNfsShareArgs.builder()
            .clusterId("cluster-id")
            .id("share-id")
            .location("location")
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: ionoscloud:getNfsShare
      arguments:
        clusterId: cluster-id
        id: share-id
        location: location

    Using getNfsShare

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getNfsShare(args: GetNfsShareArgs, opts?: InvokeOptions): Promise<GetNfsShareResult>
function getNfsShareOutput(args: GetNfsShareOutputArgs, opts?: InvokeOptions): Output<GetNfsShareResult>
    def get_nfs_share(client_groups: Optional[Sequence[GetNfsShareClientGroup]] = None,
                  cluster_id: Optional[str] = None,
                  gid: Optional[float] = None,
                  id: Optional[str] = None,
                  location: Optional[str] = None,
                  name: Optional[str] = None,
                  partial_match: Optional[bool] = None,
                  quota: Optional[float] = None,
                  uid: Optional[float] = None,
                  opts: Optional[InvokeOptions] = None) -> GetNfsShareResult
def get_nfs_share_output(client_groups: Optional[pulumi.Input[Sequence[pulumi.Input[GetNfsShareClientGroupArgs]]]] = None,
                  cluster_id: Optional[pulumi.Input[str]] = None,
                  gid: Optional[pulumi.Input[float]] = None,
                  id: Optional[pulumi.Input[str]] = None,
                  location: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  partial_match: Optional[pulumi.Input[bool]] = None,
                  quota: Optional[pulumi.Input[float]] = None,
                  uid: Optional[pulumi.Input[float]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetNfsShareResult]
    func LookupNfsShare(ctx *Context, args *LookupNfsShareArgs, opts ...InvokeOption) (*LookupNfsShareResult, error)
func LookupNfsShareOutput(ctx *Context, args *LookupNfsShareOutputArgs, opts ...InvokeOption) LookupNfsShareResultOutput

    > Note: This function is named LookupNfsShare in the Go SDK.

    public static class GetNfsShare 
{
    public static Task<GetNfsShareResult> InvokeAsync(GetNfsShareArgs args, InvokeOptions? opts = null)
    public static Output<GetNfsShareResult> Invoke(GetNfsShareInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetNfsShareResult> getNfsShare(GetNfsShareArgs args, InvokeOptions options)
public static Output<GetNfsShareResult> getNfsShare(GetNfsShareArgs args, InvokeOptions options)

    fn::invoke:
  function: ionoscloud:index/getNfsShare:getNfsShare
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ClusterId string
    The ID of the Network File Storage cluster.
    ClientGroups List<GetNfsShareClientGroup>
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    Gid double
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    Id string
    ID of the Network File Storage share.
    Location string
    The location where the Network File Storage share is located.
    Name string
    Name of the Network File Storage share.
    PartialMatch bool
    Whether partial matching is allowed or not when using the name filter. Defaults to false.
    Quota double
    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.
    Uid double
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    ClusterId string
    The ID of the Network File Storage cluster.
    ClientGroups []GetNfsShareClientGroup
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    Gid float64
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    Id string
    ID of the Network File Storage share.
    Location string
    The location where the Network File Storage share is located.
    Name string
    Name of the Network File Storage share.
    PartialMatch bool
    Whether partial matching is allowed or not when using the name filter. Defaults to false.
    Quota float64
    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.
    Uid float64
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    clusterId String
    The ID of the Network File Storage cluster.
    clientGroups List<GetNfsShareClientGroup>
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    gid Double
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id String
    ID of the Network File Storage share.
    location String
    The location where the Network File Storage share is located.
    name String
    Name of the Network File Storage share.
    partialMatch Boolean
    Whether partial matching is allowed or not when using the name filter. Defaults to false.
    quota Double
    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.
    uid Double
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    clusterId string
    The ID of the Network File Storage cluster.
    clientGroups GetNfsShareClientGroup[]
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    gid number
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id string
    ID of the Network File Storage share.
    location string
    The location where the Network File Storage share is located.
    name string
    Name of the Network File Storage share.
    partialMatch boolean
    Whether partial matching is allowed or not when using the name filter. Defaults to false.
    quota number
    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.
    uid number
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    cluster_id str
    The ID of the Network File Storage cluster.
    client_groups Sequence[GetNfsShareClientGroup]
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    gid float
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id str
    ID of the Network File Storage share.
    location str
    The location where the Network File Storage share is located.
    name str
    Name of the Network File Storage share.
    partial_match bool
    Whether partial matching is allowed or not when using the name filter. Defaults to false.
    quota float
    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.
    uid float
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    clusterId String
    The ID of the Network File Storage cluster.
    clientGroups List<Property Map>
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    gid Number
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id String
    ID of the Network File Storage share.
    location String
    The location where the Network File Storage share is located.
    name String
    Name of the Network File Storage share.
    partialMatch Boolean
    Whether partial matching is allowed or not when using the name filter. Defaults to false.
    quota Number
    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.
    uid Number
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.

    getNfsShare Result

    The following output properties are available:

    ClusterId string
    The ID of the Network File Storage cluster.
    Gid double
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    Id string
    The ID of the Network File Storage share.
    Name string
    The name of the Network File Storage share.
    NfsPath string
    Path to the NFS export. The NFS path is the path to the directory being exported.
    Quota double
    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.
    Uid double
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    ClientGroups List<GetNfsShareClientGroup>
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    Location string
    The location where the Network File Storage share is located.
    PartialMatch bool
    ClusterId string
    The ID of the Network File Storage cluster.
    Gid float64
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    Id string
    The ID of the Network File Storage share.
    Name string
    The name of the Network File Storage share.
    NfsPath string
    Path to the NFS export. The NFS path is the path to the directory being exported.
    Quota float64
    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.
    Uid float64
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    ClientGroups []GetNfsShareClientGroup
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    Location string
    The location where the Network File Storage share is located.
    PartialMatch bool
    clusterId String
    The ID of the Network File Storage cluster.
    gid Double
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id String
    The ID of the Network File Storage share.
    name String
    The name of the Network File Storage share.
    nfsPath String
    Path to the NFS export. The NFS path is the path to the directory being exported.
    quota Double
    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.
    uid Double
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    clientGroups List<GetNfsShareClientGroup>
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    location String
    The location where the Network File Storage share is located.
    partialMatch Boolean
    clusterId string
    The ID of the Network File Storage cluster.
    gid number
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id string
    The ID of the Network File Storage share.
    name string
    The name of the Network File Storage share.
    nfsPath string
    Path to the NFS export. The NFS path is the path to the directory being exported.
    quota number
    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.
    uid number
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    clientGroups GetNfsShareClientGroup[]
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    location string
    The location where the Network File Storage share is located.
    partialMatch boolean
    cluster_id str
    The ID of the Network File Storage cluster.
    gid float
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id str
    The ID of the Network File Storage share.
    name str
    The name of the Network File Storage share.
    nfs_path str
    Path to the NFS export. The NFS path is the path to the directory being exported.
    quota float
    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.
    uid float
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    client_groups Sequence[GetNfsShareClientGroup]
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    location str
    The location where the Network File Storage share is located.
    partial_match bool
    clusterId String
    The ID of the Network File Storage cluster.
    gid Number
    The group ID that will own the exported directory. If not set, anonymous (512) will be used.
    id String
    The ID of the Network File Storage share.
    name String
    The name of the Network File Storage share.
    nfsPath String
    Path to the NFS export. The NFS path is the path to the directory being exported.
    quota Number
    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.
    uid Number
    The user ID that will own the exported directory. If not set, anonymous (512) will be used.
    clientGroups List<Property Map>
    The groups of clients are the systems connecting to the Network File Storage cluster. Each client group supports the following:
    location String
    The location where the Network File Storage share is located.
    partialMatch Boolean

    Supporting Types

    GetNfsShareClientGroup

    Description string
    Optional description for the clients groups.
    Hosts List<string>
    A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.
    IpNetworks List<string>
    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.
    Nfs List<GetNfsShareClientGroupNf>
    The NFS configuration for the client group. Each NFS configuration supports the following:
    Description string
    Optional description for the clients groups.
    Hosts []string
    A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.
    IpNetworks []string
    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.
    Nfs []GetNfsShareClientGroupNf
    The NFS configuration for the client group. Each NFS configuration supports the following:
    description String
    Optional description for the clients groups.
    hosts List<String>
    A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.
    ipNetworks List<String>
    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.
    nfs List<GetNfsShareClientGroupNf>
    The NFS configuration for the client group. Each NFS configuration supports the following:
    description string
    Optional description for the clients groups.
    hosts string[]
    A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.
    ipNetworks string[]
    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.
    nfs GetNfsShareClientGroupNf[]
    The NFS configuration for the client group. Each NFS configuration supports the following:
    description str
    Optional description for the clients groups.
    hosts Sequence[str]
    A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.
    ip_networks Sequence[str]
    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.
    nfs Sequence[GetNfsShareClientGroupNf]
    The NFS configuration for the client group. Each NFS configuration supports the following:
    description String
    Optional description for the clients groups.
    hosts List<String>
    A singular host allowed to connect to the share. The host can be specified as IP address and can be either IPv4 or IPv6.
    ipNetworks List<String>
    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.
    nfs List<Property Map>
    The NFS configuration for the client group. Each NFS configuration supports the following:

    GetNfsShareClientGroupNf

    Squash string
    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.
    Squash string
    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.
    squash String
    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.
    squash string
    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.
    squash str
    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.
    squash String
    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.

    Package Details

    Repository
    ionoscloud ionos-cloud/terraform-provider-ionoscloud
    License
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud
    ionos-cloud/terraform-provider-ionoscloud