Welcome to Pulumi Registry, your window into the cloud. Read the announcement.

AWS Classic

v4.25.0 published on Friday, Oct 15, 2021 by Pulumi

getFileSystem

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

Example Usage

using Pulumi;
using Aws = Pulumi.Aws;

class MyStack : Stack
{
    public MyStack()
    {
        var config = new Config();
        var fileSystemId = config.Get("fileSystemId") ?? "";
        var byId = Output.Create(Aws.Efs.GetFileSystem.InvokeAsync(new Aws.Efs.GetFileSystemArgs
        {
            FileSystemId = fileSystemId,
        }));
        var byTag = Output.Create(Aws.Efs.GetFileSystem.InvokeAsync(new Aws.Efs.GetFileSystemArgs
        {
            Tags = 
            {
                { "Environment", "dev" },
            },
        }));
    }

}
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v4/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
		}
		opt0 := fileSystemId
		_, err := efs.LookupFileSystem(ctx, &efs.LookupFileSystemArgs{
			FileSystemId: &opt0,
		}, 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
	})
}
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",
    },
});

Using getFileSystem

function getFileSystem(args: GetFileSystemArgs, opts?: InvokeOptions): Promise<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
func LookupFileSystem(ctx *Context, args *LookupFileSystemArgs, opts ...InvokeOption) (*LookupFileSystemResult, error)

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

public static class GetFileSystem {
    public static Task<GetFileSystemResult> InvokeAsync(GetFileSystemArgs args, InvokeOptions? opts = null)
}

The following arguments are supported:

CreationToken string
Restricts the list to the file system with this creation token.
FileSystemId string
The 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
The 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
The 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
The ID that identifies the file system (e.g. fs-ccfc0d65).
tags Mapping[str, str]
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
The 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
The ARN for the KMS encryption key.
LifecyclePolicy GetFileSystemLifecyclePolicy
A file system lifecycle policy object.
PerformanceMode string
The file system performance mode.
ProvisionedThroughputInMibps double

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

  • tags -A map of tags to assign to the file system.
SizeInBytes int
The current byte count used by the file system.
Tags Dictionary<string, string>
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
The 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
The ARN for the KMS encryption key.
LifecyclePolicy GetFileSystemLifecyclePolicy
A file system lifecycle policy object.
PerformanceMode string
The file system performance mode.
ProvisionedThroughputInMibps float64

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

  • tags -A map of tags to assign to the file system.
SizeInBytes int
The current byte count used by the file system.
Tags map[string]string
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
The 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
The ARN for the KMS encryption key.
lifecyclePolicy GetFileSystemLifecyclePolicy
A file system lifecycle policy object.
performanceMode string
The file system performance mode.
provisionedThroughputInMibps number

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

  • tags -A map of tags to assign to the file system.
sizeInBytes number
The current byte count used by the file system.
tags {[key: string]: string}
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
The 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
The ARN for the KMS encryption key.
lifecycle_policy GetFileSystemLifecyclePolicy
A file system lifecycle policy object.
performance_mode str
The file system performance mode.
provisioned_throughput_in_mibps float

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

  • tags -A map of tags to assign to the file system.
size_in_bytes int
The current byte count used by the file system.
tags Mapping[str, str]
throughput_mode str
Throughput mode for the file system.

Supporting Types

GetFileSystemLifecyclePolicy

Package Details

Repository
https://github.com/pulumi/pulumi-aws
License
Apache-2.0
Notes
This Pulumi package is based on the aws Terraform Provider.