pulumi-aws-kotlin/com.pulumi.aws.fsx.kotlin/OntapVolume

OntapVolume

class OntapVolume : KotlinCustomResource

Manages a FSx ONTAP Volume. See the FSx ONTAP User Guide for more information.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.fsx.OntapVolume("test", {
    name: "test",
    junctionPath: "/test",
    sizeInMegabytes: 1024,
    storageEfficiencyEnabled: true,
    storageVirtualMachineId: testAwsFsxOntapStorageVirtualMachine.id,
});

import pulumi
import pulumi_aws as aws
test = aws.fsx.OntapVolume("test",
    name="test",
    junction_path="/test",
    size_in_megabytes=1024,
    storage_efficiency_enabled=True,
    storage_virtual_machine_id=test_aws_fsx_ontap_storage_virtual_machine["id"])

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var test = new Aws.Fsx.OntapVolume("test", new()
    {
        Name = "test",
        JunctionPath = "/test",
        SizeInMegabytes = 1024,
        StorageEfficiencyEnabled = true,
        StorageVirtualMachineId = testAwsFsxOntapStorageVirtualMachine.Id,
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/fsx"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := fsx.NewOntapVolume(ctx, "test", &fsx.OntapVolumeArgs{
			Name:                     pulumi.String("test"),
			JunctionPath:             pulumi.String("/test"),
			SizeInMegabytes:          pulumi.Int(1024),
			StorageEfficiencyEnabled: pulumi.Bool(true),
			StorageVirtualMachineId:  pulumi.Any(testAwsFsxOntapStorageVirtualMachine.Id),
		})
		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.fsx.OntapVolume;
import com.pulumi.aws.fsx.OntapVolumeArgs;
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) {
        var test = new OntapVolume("test", OntapVolumeArgs.builder()
            .name("test")
            .junctionPath("/test")
            .sizeInMegabytes(1024)
            .storageEfficiencyEnabled(true)
            .storageVirtualMachineId(testAwsFsxOntapStorageVirtualMachine.id())
            .build());
    }
}

resources:
  test:
    type: aws:fsx:OntapVolume
    properties:
      name: test
      junctionPath: /test
      sizeInMegabytes: 1024
      storageEfficiencyEnabled: true
      storageVirtualMachineId: ${testAwsFsxOntapStorageVirtualMachine.id}

Using Tiering Policy

Additional information on tiering policy with ONTAP Volumes can be found in the FSx ONTAP Guide.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.fsx.OntapVolume("test", {
    name: "test",
    junctionPath: "/test",
    sizeInMegabytes: 1024,
    storageEfficiencyEnabled: true,
    storageVirtualMachineId: testAwsFsxOntapStorageVirtualMachine.id,
    tieringPolicy: {
        name: "AUTO",
        coolingPeriod: 31,
    },
});

import pulumi
import pulumi_aws as aws
test = aws.fsx.OntapVolume("test",
    name="test",
    junction_path="/test",
    size_in_megabytes=1024,
    storage_efficiency_enabled=True,
    storage_virtual_machine_id=test_aws_fsx_ontap_storage_virtual_machine["id"],
    tiering_policy={
        "name": "AUTO",
        "cooling_period": 31,
    })

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var test = new Aws.Fsx.OntapVolume("test", new()
    {
        Name = "test",
        JunctionPath = "/test",
        SizeInMegabytes = 1024,
        StorageEfficiencyEnabled = true,
        StorageVirtualMachineId = testAwsFsxOntapStorageVirtualMachine.Id,
        TieringPolicy = new Aws.Fsx.Inputs.OntapVolumeTieringPolicyArgs
        {
            Name = "AUTO",
            CoolingPeriod = 31,
        },
    });
});

package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/fsx"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := fsx.NewOntapVolume(ctx, "test", &fsx.OntapVolumeArgs{
			Name:                     pulumi.String("test"),
			JunctionPath:             pulumi.String("/test"),
			SizeInMegabytes:          pulumi.Int(1024),
			StorageEfficiencyEnabled: pulumi.Bool(true),
			StorageVirtualMachineId:  pulumi.Any(testAwsFsxOntapStorageVirtualMachine.Id),
			TieringPolicy: &fsx.OntapVolumeTieringPolicyArgs{
				Name:          pulumi.String("AUTO"),
				CoolingPeriod: pulumi.Int(31),
			},
		})
		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.fsx.OntapVolume;
import com.pulumi.aws.fsx.OntapVolumeArgs;
import com.pulumi.aws.fsx.inputs.OntapVolumeTieringPolicyArgs;
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) {
        var test = new OntapVolume("test", OntapVolumeArgs.builder()
            .name("test")
            .junctionPath("/test")
            .sizeInMegabytes(1024)
            .storageEfficiencyEnabled(true)
            .storageVirtualMachineId(testAwsFsxOntapStorageVirtualMachine.id())
            .tieringPolicy(OntapVolumeTieringPolicyArgs.builder()
                .name("AUTO")
                .coolingPeriod(31)
                .build())
            .build());
    }
}

resources:
  test:
    type: aws:fsx:OntapVolume
    properties:
      name: test
      junctionPath: /test
      sizeInMegabytes: 1024
      storageEfficiencyEnabled: true
      storageVirtualMachineId: ${testAwsFsxOntapStorageVirtualMachine.id}
      tieringPolicy:
        name: AUTO
        coolingPeriod: 31

Import

Using pulumi import, import FSx ONTAP volume using the id. For example:

$ pulumi import aws:fsx/ontapVolume:OntapVolume example fsvol-12345678abcdef123

Properties

aggregateConfiguration

val aggregateConfiguration: Output<OntapVolumeAggregateConfiguration>?

The Aggregate configuration only applies to FLEXGROUP volumes. See `aggregate_configuration` Block for details.

arn

val arn: Output<String>

Amazon Resource Name of the volune.

bypassSnaplockEnterpriseRetention

val bypassSnaplockEnterpriseRetention: Output<Boolean>?

Setting this to true allows a SnapLock administrator to delete an FSx for ONTAP SnapLock Enterprise volume with unexpired write once, read many (WORM) files. This configuration must be applied separately before attempting to delete the resource to have the desired behavior. Defaults to false.

copyTagsToBackups

val copyTagsToBackups: Output<Boolean>?

A boolean flag indicating whether tags for the volume should be copied to backups. This value defaults to false.

fileSystemId

val fileSystemId: Output<String>

Describes the file system for the volume, e.g. fs-12345679

finalBackupTags

val finalBackupTags: Output<Map<String, String>>?

A map of tags to apply to the volume's final backup.

flexcacheEndpointType

val flexcacheEndpointType: Output<String>

Specifies the FlexCache endpoint type of the volume, Valid values are NONE, ORIGIN, CACHE. Default value is NONE. These can be set by the ONTAP CLI or API and are use with FlexCache feature.

val id: Output<String>

junctionPath

val junctionPath: Output<String>?

Specifies the location in the storage virtual machine's namespace where the volume is mounted. The junction_path must have a leading forward slash, such as /vol3

name

val name: Output<String>

The name of the Volume. You can use a maximum of 203 alphanumeric characters, plus the underscore (_) special character.

ontapVolumeType

val ontapVolumeType: Output<String>

Specifies the type of volume, valid values are RW, DP. Default value is RW. These can be set by the ONTAP CLI or API. This setting is used as part of migration and replication Migrating to Amazon FSx for NetApp ONTAP

pulumiChildResources

val pulumiChildResources: Set<KotlinResource>

pulumiResourceName

val pulumiResourceName: String

pulumiResourceType

val pulumiResourceType: String

securityStyle

val securityStyle: Output<String>

Specifies the volume security style, Valid values are UNIX, NTFS, and MIXED.

sizeInBytes

val sizeInBytes: Output<String>

Specifies the size of the volume, in megabytes (MB), that you are creating. Can be used for any size but required for volumes over 2 PB. Either size_in_bytes or size_in_megabytes must be specified. Minimum size for FLEXGROUP volumes are 100GiB per constituent.

sizeInMegabytes

val sizeInMegabytes: Output<Int>

Specifies the size of the volume, in megabytes (MB), that you are creating. Supported when creating volumes under 2 PB. Either size_in_bytes or size_in_megabytes must be specified. Minimum size for FLEXGROUP volumes are 100GiB per constituent.

skipFinalBackup

val skipFinalBackup: Output<Boolean>?

When enabled, will skip the default final backup taken when the volume is deleted. This configuration must be applied separately before attempting to delete the resource to have the desired behavior. Defaults to false.

snaplockConfiguration

val snaplockConfiguration: Output<OntapVolumeSnaplockConfiguration>?

The SnapLock configuration for an FSx for ONTAP volume. See snaplock_configuration Block for details.

snapshotPolicy

val snapshotPolicy: Output<String>

Specifies the snapshot policy for the volume. See snapshot policies in the Amazon FSx ONTAP User Guide

storageEfficiencyEnabled

val storageEfficiencyEnabled: Output<Boolean>?

Set to true to enable deduplication, compression, and compaction storage efficiency features on the volume.

storageVirtualMachineId

val storageVirtualMachineId: Output<String>

Specifies the storage virtual machine in which to create the volume. The following arguments are optional: