1. Packages
  2. AWS Classic
  3. API Docs
  4. efs
  5. getFileSystem

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.0 published on Saturday, Dec 2, 2023 by Pulumi

aws.efs.getFileSystem

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.13.0 published on Saturday, Dec 2, 2023 by Pulumi

    Provides information about an Elastic File System (EFS) File System.

    Example Usage

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var config = new Config();
        var fileSystemId = config.Get("fileSystemId") ?? "";
        var byId = Aws.Efs.GetFileSystem.Invoke(new()
        {
            FileSystemId = fileSystemId,
        });
    
        var byTag = Aws.Efs.GetFileSystem.Invoke(new()
        {
            Tags = 
            {
                { "Environment", "dev" },
            },
        });
    
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/efs"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		cfg := config.New(ctx, "")
    		fileSystemId := ""
    		if param := cfg.Get("fileSystemId"); param != "" {
    			fileSystemId = param
    		}
    		_, err := efs.LookupFileSystem(ctx, &efs.LookupFileSystemArgs{
    			FileSystemId: pulumi.StringRef(fileSystemId),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		_, err = efs.LookupFileSystem(ctx, &efs.LookupFileSystemArgs{
    			Tags: map[string]interface{}{
    				"Environment": "dev",
    			},
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.efs.EfsFunctions;
    import com.pulumi.aws.efs.inputs.GetFileSystemArgs;
    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 config = ctx.config();
            final var fileSystemId = config.get("fileSystemId").orElse("");
            final var byId = EfsFunctions.getFileSystem(GetFileSystemArgs.builder()
                .fileSystemId(fileSystemId)
                .build());
    
            final var byTag = EfsFunctions.getFileSystem(GetFileSystemArgs.builder()
                .tags(Map.of("Environment", "dev"))
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_aws as aws
    
    config = pulumi.Config()
    file_system_id = config.get("fileSystemId")
    if file_system_id is None:
        file_system_id = ""
    by_id = aws.efs.get_file_system(file_system_id=file_system_id)
    by_tag = aws.efs.get_file_system(tags={
        "Environment": "dev",
    })
    
    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const config = new pulumi.Config();
    const fileSystemId = config.get("fileSystemId") || "";
    const byId = aws.efs.getFileSystem({
        fileSystemId: fileSystemId,
    });
    const byTag = aws.efs.getFileSystem({
        tags: {
            Environment: "dev",
        },
    });
    
    configuration:
      fileSystemId:
        type: string
        default:
    variables:
      byId:
        fn::invoke:
          Function: aws:efs:getFileSystem
          Arguments:
            fileSystemId: ${fileSystemId}
      byTag:
        fn::invoke:
          Function: aws:efs:getFileSystem
          Arguments:
            tags:
              Environment: dev
    

    Using getFileSystem

    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 getFileSystem(args: GetFileSystemArgs, opts?: InvokeOptions): Promise<GetFileSystemResult>
    function getFileSystemOutput(args: GetFileSystemOutputArgs, opts?: InvokeOptions): Output<GetFileSystemResult>
    def get_file_system(creation_token: Optional[str] = None,
                        file_system_id: Optional[str] = None,
                        tags: Optional[Mapping[str, str]] = None,
                        opts: Optional[InvokeOptions] = None) -> GetFileSystemResult
    def get_file_system_output(creation_token: Optional[pulumi.Input[str]] = None,
                        file_system_id: Optional[pulumi.Input[str]] = None,
                        tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetFileSystemResult]
    func LookupFileSystem(ctx *Context, args *LookupFileSystemArgs, opts ...InvokeOption) (*LookupFileSystemResult, error)
    func LookupFileSystemOutput(ctx *Context, args *LookupFileSystemOutputArgs, opts ...InvokeOption) LookupFileSystemResultOutput

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

    public static class GetFileSystem 
    {
        public static Task<GetFileSystemResult> InvokeAsync(GetFileSystemArgs args, InvokeOptions? opts = null)
        public static Output<GetFileSystemResult> Invoke(GetFileSystemInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetFileSystemResult> getFileSystem(GetFileSystemArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: aws:efs/getFileSystem:getFileSystem
      arguments:
        # arguments dictionary

    The following arguments are supported:

    CreationToken string

    Restricts the list to the file system with this creation token.

    FileSystemId string

    ID that identifies the file system (e.g., fs-ccfc0d65).

    Tags Dictionary<string, string>

    Restricts the list to the file system with these tags.

    CreationToken string

    Restricts the list to the file system with this creation token.

    FileSystemId string

    ID that identifies the file system (e.g., fs-ccfc0d65).

    Tags map[string]string

    Restricts the list to the file system with these tags.

    creationToken String

    Restricts the list to the file system with this creation token.

    fileSystemId String

    ID that identifies the file system (e.g., fs-ccfc0d65).

    tags Map<String,String>

    Restricts the list to the file system with these tags.

    creationToken string

    Restricts the list to the file system with this creation token.

    fileSystemId string

    ID that identifies the file system (e.g., fs-ccfc0d65).

    tags {[key: string]: string}

    Restricts the list to the file system with these tags.

    creation_token str

    Restricts the list to the file system with this creation token.

    file_system_id str

    ID that identifies the file system (e.g., fs-ccfc0d65).

    tags Mapping[str, str]

    Restricts the list to the file system with these tags.

    creationToken String

    Restricts the list to the file system with this creation token.

    fileSystemId String

    ID that identifies the file system (e.g., fs-ccfc0d65).

    tags Map<String>

    Restricts the list to the file system with these tags.

    getFileSystem Result

    The following output properties are available:

    Arn string

    Amazon Resource Name of the file system.

    AvailabilityZoneId string

    The identifier of the Availability Zone in which the file system's One Zone storage classes exist.

    AvailabilityZoneName string

    The Availability Zone name in which the file system's One Zone storage classes exist.

    CreationToken string
    DnsName string

    DNS name for the filesystem per documented convention.

    Encrypted bool

    Whether EFS is encrypted.

    FileSystemId string
    Id string

    The provider-assigned unique ID for this managed resource.

    KmsKeyId string

    ARN for the KMS encryption key.

    LifecyclePolicy GetFileSystemLifecyclePolicy

    File system lifecycle policy object.

    Name string

    The value of the file system's Name tag.

    PerformanceMode string

    File system performance mode.

    ProvisionedThroughputInMibps double

    The throughput, measured in MiB/s, that you want to provision for the file system.

    SizeInBytes int

    Current byte count used by the file system.

    Tags Dictionary<string, string>

    A map of tags to assign to the file system.

    ThroughputMode string

    Throughput mode for the file system.

    Arn string

    Amazon Resource Name of the file system.

    AvailabilityZoneId string

    The identifier of the Availability Zone in which the file system's One Zone storage classes exist.

    AvailabilityZoneName string

    The Availability Zone name in which the file system's One Zone storage classes exist.

    CreationToken string
    DnsName string

    DNS name for the filesystem per documented convention.

    Encrypted bool

    Whether EFS is encrypted.

    FileSystemId string
    Id string

    The provider-assigned unique ID for this managed resource.

    KmsKeyId string

    ARN for the KMS encryption key.

    LifecyclePolicy GetFileSystemLifecyclePolicy

    File system lifecycle policy object.

    Name string

    The value of the file system's Name tag.

    PerformanceMode string

    File system performance mode.

    ProvisionedThroughputInMibps float64

    The throughput, measured in MiB/s, that you want to provision for the file system.

    SizeInBytes int

    Current byte count used by the file system.

    Tags map[string]string

    A map of tags to assign to the file system.

    ThroughputMode string

    Throughput mode for the file system.

    arn String

    Amazon Resource Name of the file system.

    availabilityZoneId String

    The identifier of the Availability Zone in which the file system's One Zone storage classes exist.

    availabilityZoneName String

    The Availability Zone name in which the file system's One Zone storage classes exist.

    creationToken String
    dnsName String

    DNS name for the filesystem per documented convention.

    encrypted Boolean

    Whether EFS is encrypted.

    fileSystemId String
    id String

    The provider-assigned unique ID for this managed resource.

    kmsKeyId String

    ARN for the KMS encryption key.

    lifecyclePolicy GetFileSystemLifecyclePolicy

    File system lifecycle policy object.

    name String

    The value of the file system's Name tag.

    performanceMode String

    File system performance mode.

    provisionedThroughputInMibps Double

    The throughput, measured in MiB/s, that you want to provision for the file system.

    sizeInBytes Integer

    Current byte count used by the file system.

    tags Map<String,String>

    A map of tags to assign to the file system.

    throughputMode String

    Throughput mode for the file system.

    arn string

    Amazon Resource Name of the file system.

    availabilityZoneId string

    The identifier of the Availability Zone in which the file system's One Zone storage classes exist.

    availabilityZoneName string

    The Availability Zone name in which the file system's One Zone storage classes exist.

    creationToken string
    dnsName string

    DNS name for the filesystem per documented convention.

    encrypted boolean

    Whether EFS is encrypted.

    fileSystemId string
    id string

    The provider-assigned unique ID for this managed resource.

    kmsKeyId string

    ARN for the KMS encryption key.

    lifecyclePolicy GetFileSystemLifecyclePolicy

    File system lifecycle policy object.

    name string

    The value of the file system's Name tag.

    performanceMode string

    File system performance mode.

    provisionedThroughputInMibps number

    The throughput, measured in MiB/s, that you want to provision for the file system.

    sizeInBytes number

    Current byte count used by the file system.

    tags {[key: string]: string}

    A map of tags to assign to the file system.

    throughputMode string

    Throughput mode for the file system.

    arn str

    Amazon Resource Name of the file system.

    availability_zone_id str

    The identifier of the Availability Zone in which the file system's One Zone storage classes exist.

    availability_zone_name str

    The Availability Zone name in which the file system's One Zone storage classes exist.

    creation_token str
    dns_name str

    DNS name for the filesystem per documented convention.

    encrypted bool

    Whether EFS is encrypted.

    file_system_id str
    id str

    The provider-assigned unique ID for this managed resource.

    kms_key_id str

    ARN for the KMS encryption key.

    lifecycle_policy GetFileSystemLifecyclePolicy

    File system lifecycle policy object.

    name str

    The value of the file system's Name tag.

    performance_mode str

    File system performance mode.

    provisioned_throughput_in_mibps float

    The throughput, measured in MiB/s, that you want to provision for the file system.

    size_in_bytes int

    Current byte count used by the file system.

    tags Mapping[str, str]

    A map of tags to assign to the file system.

    throughput_mode str

    Throughput mode for the file system.

    arn String

    Amazon Resource Name of the file system.

    availabilityZoneId String

    The identifier of the Availability Zone in which the file system's One Zone storage classes exist.

    availabilityZoneName String

    The Availability Zone name in which the file system's One Zone storage classes exist.

    creationToken String
    dnsName String

    DNS name for the filesystem per documented convention.

    encrypted Boolean

    Whether EFS is encrypted.

    fileSystemId String
    id String

    The provider-assigned unique ID for this managed resource.

    kmsKeyId String

    ARN for the KMS encryption key.

    lifecyclePolicy Property Map

    File system lifecycle policy object.

    name String

    The value of the file system's Name tag.

    performanceMode String

    File system performance mode.

    provisionedThroughputInMibps Number

    The throughput, measured in MiB/s, that you want to provision for the file system.

    sizeInBytes Number

    Current byte count used by the file system.

    tags Map<String>

    A map of tags to assign to the file system.

    throughputMode String

    Throughput mode for the file system.

    Supporting Types

    GetFileSystemLifecyclePolicy

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the aws Terraform Provider.

    aws logo

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.13.0 published on Saturday, Dec 2, 2023 by Pulumi