Module efs

This provider is a derived work of the Terraform Provider distributed under MPL 2.0. If you encounter a bug or missing feature, first check the pulumi/pulumi-aws repo; however, if that doesn’t turn up anything, please consult the source terraform-providers/terraform-provider-aws repo.

Resources

Data Sources

Others

Resources

Resource FileSystem

class FileSystem extends CustomResource

Provides an Elastic File System (EFS) resource.

Example Usage

EFS File System w/ tags
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const foo = new aws.efs.FileSystem("foo", {
    tags: {
        Name: "MyProduct",
    },
});
Using lifecycle policy
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const fooWithLifecylePolicy = new aws.efs.FileSystem("fooWithLifecylePolicy", {
    lifecyclePolicy: {
        transitionToIa: "AFTER_30_DAYS",
    },
});

This content is derived from https://github.com/terraform-providers/terraform-provider-aws/blob/master/website/docs/r/efs_file_system.html.markdown.

constructor

new FileSystem(name: string, args?: FileSystemArgs, opts?: pulumi.CustomResourceOptions)

Create a FileSystem resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: FileSystemState, opts?: pulumi.CustomResourceOptions): FileSystem

Get an existing FileSystem resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

public static isInstance(obj: any): boolean

Returns true if the given object is an instance of FileSystem. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

Amazon Resource Name of the file system.

property creationToken

public creationToken: pulumi.Output<string>;

A unique name (a maximum of 64 characters are allowed) used as reference when creating the Elastic File System to ensure idempotent file system creation. By default generated by this provider. See Elastic File System user guide for more information.

property dnsName

public dnsName: pulumi.Output<string>;

The DNS name for the filesystem per documented convention.

property encrypted

public encrypted: pulumi.Output<boolean>;

If true, the disk will be encrypted.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property kmsKeyId

public kmsKeyId: pulumi.Output<string>;

The ARN for the KMS encryption key. When specifying kms_key_id, encrypted needs to be set to true.

property lifecyclePolicy

public lifecyclePolicy: pulumi.Output<outputs.efs.FileSystemLifecyclePolicy | undefined>;

A file system lifecycle policy object (documented below).

property performanceMode

public performanceMode: pulumi.Output<string>;

The file system performance mode. Can be either "generalPurpose" or "maxIO" (Default: "generalPurpose").

property provisionedThroughputInMibps

public provisionedThroughputInMibps: pulumi.Output<number | undefined>;

The throughput, measured in MiB/s, that you want to provision for the file system. Only applicable with throughputMode set to provisioned.

property tags

public tags: pulumi.Output<{[key: string]: any} | undefined>;

A mapping of tags to assign to the file system.

property throughputMode

public throughputMode: pulumi.Output<string | undefined>;

Throughput mode for the file system. Defaults to bursting. Valid values: bursting, provisioned. When using provisioned, also set provisionedThroughputInMibps.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

Resource MountTarget

class MountTarget extends CustomResource

Provides an Elastic File System (EFS) mount target.

Example Usage

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

const foo = new aws.ec2.Vpc("foo", {
    cidrBlock: "10.0.0.0/16",
});
const alphaSubnet = new aws.ec2.Subnet("alpha", {
    availabilityZone: "us-west-2a",
    cidrBlock: "10.0.1.0/24",
    vpcId: foo.id,
});
const alphaMountTarget = new aws.efs.MountTarget("alpha", {
    fileSystemId: aws_efs_file_system_foo.id,
    subnetId: alphaSubnet.id,
});

This content is derived from https://github.com/terraform-providers/terraform-provider-aws/blob/master/website/docs/r/efs_mount_target.html.markdown.

constructor

new MountTarget(name: string, args: MountTargetArgs, opts?: pulumi.CustomResourceOptions)

Create a MountTarget resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MountTargetState, opts?: pulumi.CustomResourceOptions): MountTarget

Get an existing MountTarget resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

public static isInstance(obj: any): boolean

Returns true if the given object is an instance of MountTarget. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property dnsName

public dnsName: pulumi.Output<string>;

The DNS name for the given subnet/AZ per documented convention.

property fileSystemArn

public fileSystemArn: pulumi.Output<string>;

Amazon Resource Name of the file system.

property fileSystemId

public fileSystemId: pulumi.Output<string>;

The ID of the file system for which the mount target is intended.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property ipAddress

public ipAddress: pulumi.Output<string>;

The address (within the address range of the specified subnet) at which the file system may be mounted via the mount target.

property networkInterfaceId

public networkInterfaceId: pulumi.Output<string>;

The ID of the network interface that Amazon EFS created when it created the mount target.

property securityGroups

public securityGroups: pulumi.Output<string[]>;

A list of up to 5 VPC security group IDs (that must be for the same VPC as subnet specified) in effect for the mount target.

property subnetId

public subnetId: pulumi.Output<string>;

The ID of the subnet to add the mount target in.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

Data Sources

Data Source getFileSystem

getFileSystem(args?: GetFileSystemArgs, opts?: pulumi.InvokeOptions): Promise<GetFileSystemResult> & GetFileSystemResult

Provides information about an Elastic File System (EFS).

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,
});

This content is derived from https://github.com/terraform-providers/terraform-provider-aws/blob/master/website/docs/d/efs_file_system.html.markdown.

Data Source getMountTarget

getMountTarget(args: GetMountTargetArgs, opts?: pulumi.InvokeOptions): Promise<GetMountTargetResult> & GetMountTargetResult

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

Example Usage

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

const config = new pulumi.Config();
const mountTargetId = config.get("mountTargetId") || "";

const byId = aws.efs.getMountTarget({
    mountTargetId: mountTargetId,
});

This content is derived from https://github.com/terraform-providers/terraform-provider-aws/blob/master/website/docs/d/efs_mount_target.html.markdown.

Others

interface FileSystemArgs

interface FileSystemArgs

The set of arguments for constructing a FileSystem resource.

property creationToken

creationToken?: pulumi.Input<string>;

A unique name (a maximum of 64 characters are allowed) used as reference when creating the Elastic File System to ensure idempotent file system creation. By default generated by this provider. See Elastic File System user guide for more information.

property encrypted

encrypted?: pulumi.Input<boolean>;

If true, the disk will be encrypted.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key. When specifying kms_key_id, encrypted needs to be set to true.

property lifecyclePolicy

lifecyclePolicy?: pulumi.Input<inputs.efs.FileSystemLifecyclePolicy>;

A file system lifecycle policy object (documented below).

property performanceMode

performanceMode?: pulumi.Input<string>;

The file system performance mode. Can be either "generalPurpose" or "maxIO" (Default: "generalPurpose").

property provisionedThroughputInMibps

provisionedThroughputInMibps?: pulumi.Input<number>;

The throughput, measured in MiB/s, that you want to provision for the file system. Only applicable with throughputMode set to provisioned.

property tags

tags?: pulumi.Input<{[key: string]: any}>;

A mapping of tags to assign to the file system.

property throughputMode

throughputMode?: pulumi.Input<string>;

Throughput mode for the file system. Defaults to bursting. Valid values: bursting, provisioned. When using provisioned, also set provisionedThroughputInMibps.

interface FileSystemState

interface FileSystemState

Input properties used for looking up and filtering FileSystem resources.

property arn

arn?: pulumi.Input<string>;

Amazon Resource Name of the file system.

property creationToken

creationToken?: pulumi.Input<string>;

A unique name (a maximum of 64 characters are allowed) used as reference when creating the Elastic File System to ensure idempotent file system creation. By default generated by this provider. See Elastic File System user guide for more information.

property dnsName

dnsName?: pulumi.Input<string>;

The DNS name for the filesystem per documented convention.

property encrypted

encrypted?: pulumi.Input<boolean>;

If true, the disk will be encrypted.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN for the KMS encryption key. When specifying kms_key_id, encrypted needs to be set to true.

property lifecyclePolicy

lifecyclePolicy?: pulumi.Input<inputs.efs.FileSystemLifecyclePolicy>;

A file system lifecycle policy object (documented below).

property performanceMode

performanceMode?: pulumi.Input<string>;

The file system performance mode. Can be either "generalPurpose" or "maxIO" (Default: "generalPurpose").

property provisionedThroughputInMibps

provisionedThroughputInMibps?: pulumi.Input<number>;

The throughput, measured in MiB/s, that you want to provision for the file system. Only applicable with throughputMode set to provisioned.

property tags

tags?: pulumi.Input<{[key: string]: any}>;

A mapping of tags to assign to the file system.

property throughputMode

throughputMode?: pulumi.Input<string>;

Throughput mode for the file system. Defaults to bursting. Valid values: bursting, provisioned. When using provisioned, also set provisionedThroughputInMibps.

interface GetFileSystemArgs

interface GetFileSystemArgs

A collection of arguments for invoking getFileSystem.

property creationToken

creationToken?: undefined | string;

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

property fileSystemId

fileSystemId?: undefined | string;

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

property tags

tags?: undefined | {[key: string]: any};

interface GetFileSystemResult

interface GetFileSystemResult

A collection of values returned by getFileSystem.

property arn

arn: string;

Amazon Resource Name of the file system.

property creationToken

creationToken: string;

property dnsName

dnsName: string;

The DNS name for the filesystem per documented convention.

property encrypted

encrypted: boolean;

Whether EFS is encrypted.

property fileSystemId

fileSystemId: string;

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property kmsKeyId

kmsKeyId: string;

The ARN for the KMS encryption key.

property performanceMode

performanceMode: string;

The PerformanceMode of the file system.

property tags

tags: {[key: string]: any};

The list of tags assigned to the file system.

interface GetMountTargetArgs

interface GetMountTargetArgs

A collection of arguments for invoking getMountTarget.

property mountTargetId

mountTargetId: string;

ID of the mount target that you want to have described

interface GetMountTargetResult

interface GetMountTargetResult

A collection of values returned by getMountTarget.

property dnsName

dnsName: string;

The DNS name for the given subnet/AZ per documented convention.

property fileSystemArn

fileSystemArn: string;

Amazon Resource Name of the file system for which the mount target is intended.

property fileSystemId

fileSystemId: string;

ID of the file system for which the mount target is intended.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property ipAddress

ipAddress: string;

Address at which the file system may be mounted via the mount target.

property mountTargetId

mountTargetId: string;

property networkInterfaceId

networkInterfaceId: string;

The ID of the network interface that Amazon EFS created when it created the mount target.

property securityGroups

securityGroups: string[];

List of VPC security group IDs attached to the mount target.

property subnetId

subnetId: string;

ID of the mount target’s subnet.

interface MountTargetArgs

interface MountTargetArgs

The set of arguments for constructing a MountTarget resource.

property fileSystemId

fileSystemId: pulumi.Input<string>;

The ID of the file system for which the mount target is intended.

property ipAddress

ipAddress?: pulumi.Input<string>;

The address (within the address range of the specified subnet) at which the file system may be mounted via the mount target.

property securityGroups

securityGroups?: pulumi.Input<pulumi.Input<string>[]>;

A list of up to 5 VPC security group IDs (that must be for the same VPC as subnet specified) in effect for the mount target.

property subnetId

subnetId: pulumi.Input<string>;

The ID of the subnet to add the mount target in.

interface MountTargetState

interface MountTargetState

Input properties used for looking up and filtering MountTarget resources.

property dnsName

dnsName?: pulumi.Input<string>;

The DNS name for the given subnet/AZ per documented convention.

property fileSystemArn

fileSystemArn?: pulumi.Input<string>;

Amazon Resource Name of the file system.

property fileSystemId

fileSystemId?: pulumi.Input<string>;

The ID of the file system for which the mount target is intended.

property ipAddress

ipAddress?: pulumi.Input<string>;

The address (within the address range of the specified subnet) at which the file system may be mounted via the mount target.

property networkInterfaceId

networkInterfaceId?: pulumi.Input<string>;

The ID of the network interface that Amazon EFS created when it created the mount target.

property securityGroups

securityGroups?: pulumi.Input<pulumi.Input<string>[]>;

A list of up to 5 VPC security group IDs (that must be for the same VPC as subnet specified) in effect for the mount target.

property subnetId

subnetId?: pulumi.Input<string>;

The ID of the subnet to add the mount target in.