Volume
Volume resource Uses Azure REST API version 2022-11-01. In version 1.x of the Azure Native provider, it used API version 2020-12-01. Other available API versions: 2021-10-01, 2022-11-01-preview, 2023-05-01, 2023-05-01-preview, 2023-07-01, 2023-07-01-preview, 2023-11-01, 2023-11-01-preview, 2024-01-01, 2024-03-01, 2024-03-01-preview, 2024-05-01, 2024-05-01-preview, 2024-07-01, 2024-07-01-preview, 2024-09-01, 2024-09-01-preview.
Example Usage
Volumes_CreateOrUpdate
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var volume = new AzureNative.NetApp.Volume("volume", new()
{
AccountName = "account1",
CreationToken = "my-unique-file-path",
Location = "eastus",
PoolName = "pool1",
ResourceGroupName = "myRG",
ServiceLevel = AzureNative.NetApp.ServiceLevel.Premium,
SubnetId = "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
UsageThreshold = 107374182400,
VolumeName = "volume1",
});
});package main
import (
netapp "github.com/pulumi/pulumi-azure-native-sdk/netapp/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := netapp.NewVolume(ctx, "volume", &netapp.VolumeArgs{
AccountName: pulumi.String("account1"),
CreationToken: pulumi.String("my-unique-file-path"),
Location: pulumi.String("eastus"),
PoolName: pulumi.String("pool1"),
ResourceGroupName: pulumi.String("myRG"),
ServiceLevel: pulumi.String(netapp.ServiceLevelPremium),
SubnetId: pulumi.String("/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"),
UsageThreshold: pulumi.Float64(107374182400),
VolumeName: pulumi.String("volume1"),
})
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.azurenative.netapp.Volume;
import com.pulumi.azurenative.netapp.VolumeArgs;
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 volume = new Volume("volume", VolumeArgs.builder()
.accountName("account1")
.creationToken("my-unique-file-path")
.location("eastus")
.poolName("pool1")
.resourceGroupName("myRG")
.serviceLevel("Premium")
.subnetId("/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3")
.usageThreshold(107374182400)
.volumeName("volume1")
.build());
}
}Import
An existing resource can be imported using its type token, name, and identifier, e.g.
$ pulumi import azure-native:netapp:Volume account1/pool1/volume1 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}Properties
Actual throughput in MiB/s for auto qosType volumes calculated based on size and serviceLevel
Specifies whether the volume is enabled for Azure VMware Solution (AVS) datastore purpose
Unique Baremetal Tenant Identifier.
Pool Resource Id used in case of creating a volume through volume group
When a volume is being restored from another volume's snapshot, will show the percentage completion of this cloning process. When this value is empty/null there is no cloning process currently happening on this volume. This value will update every 5 minutes during cloning.
Specifies whether Cool Access(tiering) is enabled for the volume.
Specifies the number of days after which data that is not accessed by clients will be tiered.
A unique file path for the volume. Used when creating mount targets
DataProtection type volumes include an object containing details of the replication
Data store resource unique identifier
Default group quota for volume in KiBs. If isDefaultQuotaEnabled is set, the minimum value of 4 KiBs applies.
Default user quota for volume in KiBs. If isDefaultQuotaEnabled is set, the minimum value of 4 KiBs applies .
If enabled (true) the snapshot the volume was created from will be automatically deleted after the volume create operation has finished. Defaults to false
Flag indicating whether subvolume operations are enabled on the volume
Source of key used to encrypt data in volume. Applicable if NetApp account has encryption.keySource = 'Microsoft.KeyVault'. Possible values (case-insensitive) are: 'Microsoft.NetApp, Microsoft.KeyVault'
Set of export policy rules
Flag indicating whether file access logs are enabled for the volume, based on active diagnostic settings present on the volume.
Unique FileSystem Identifier.
Specifies if default quota is enabled for the volume.
Specifies whether volume is a Large Volume or Regular Volume.
Restoring
Describe if a volume is KerberosEnabled. To be use with swagger version 2020-05-01 or later
The resource ID of private endpoint for KeyVault. It must reside in the same VNET as the volume. Only applicable if encryptionKeySource = 'Microsoft.KeyVault'.
Specifies whether LDAP is enabled or not for a given NFS volume.
Maximum number of files allowed. Needs a service request in order to be changed. Only allowed to be changed if volume quota is more than 4TiB.
List of mount targets
Basic network, or Standard features available to the volume.
Network Sibling Set ID for the the group of volumes sharing networking resources.
Id of the snapshot or backup that the volume is restored from.
Application specific placement rules for the particular volume
Set of protocol types, default NFSv3, CIFS for SMB protocol
The availability zone where the volume is provisioned. This refers to the logical availability zone where the volume resides.
Azure lifecycle management
Proximity placement group associated with the volume
The security style of volume, default unix, defaults to ntfs for dual protocol or CIFS protocol
The service level of the file system
Enables access based enumeration share property for SMB Shares. Only applicable for SMB/DualProtocol volume
Enables continuously available share property for smb volume. Only applicable for SMB volume
Enables encryption for in-flight smb3 data. Only applicable for SMB/DualProtocol volume. To be used with swagger version 2020-08-01 or later
Enables non browsable property for SMB Shares. Only applicable for SMB/DualProtocol volume
If enabled (true) the volume will contain a read-only snapshot directory which provides access to each of the volume's snapshots (defaults to true).
UUID v4 or resource identifier used to identify the Snapshot.
Provides storage to network proximity information for the volume.
Azure Resource Manager metadata containing createdBy and modifiedBy information.
UNIX permissions for NFS volume accepted in octal 4 digit format. First digit selects the set user ID(4), set group ID (2) and sticky (1) attributes. Second digit selects permission for the owner of the file: read (4), write (2) and execute (1). Third selects permissions for other users in the same group. the fourth for other users not in the group. 0755 - gives read/write/execute permissions to owner and read/execute to group and other users.
Maximum storage quota allowed for a file system in bytes. This is a soft quota used for alerting only. Minimum size is 100 GiB. Upper limit is 100TiB, 500Tib for LargeVolume. Specified in bytes.
Volume Group Name
Volume spec name is the application specific designation or identifier for the particular volume in a volume group for e.g. data, log
What type of volume is this. For destination volumes in Cross Region Replication, set type to DataProtection