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.42.0 published on Wednesday, Jun 26, 2024 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.42.0 published on Wednesday, Jun 26, 2024 by Pulumi

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

    Example Usage

    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",
        },
    });
    
    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",
    })
    
    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
    	})
    }
    
    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 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());
    
        }
    }
    
    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.
    Protections List<GetFileSystemProtection>
    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.
    Protections []GetFileSystemProtection
    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.
    protections List<GetFileSystemProtection>
    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.
    protections GetFileSystemProtection[]
    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.
    protections Sequence[GetFileSystemProtection]
    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.
    protections List<Property Map>
    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

    GetFileSystemProtection

    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.42.0 published on Wednesday, Jun 26, 2024 by Pulumi