Skip to content

StorageVirtualMachine

The StorageVirtualMachine resource lets you create and manage AWS FSx StorageVirtualMachines for your Amazon FSx for Windows File Server file systems. This resource enables you to configure a virtual machine that manages data stored within your FSx file system.

Minimal Example

Create a basic Storage Virtual Machine with required properties and one optional property:

ts
import AWS from "alchemy/aws/control";

const storageVirtualMachine = await AWS.FSx.StorageVirtualMachine("myStorageVM", {
  fileSystemId: "fs-0123456789abcdef0",
  name: "MyStorageVM",
  svmAdminPassword: "SecurePassword123!",
  rootVolumeSecurityStyle: "UNIX"
});

Advanced Configuration

Configure a Storage Virtual Machine with Active Directory integration and tags:

ts
const advancedStorageVM = await AWS.FSx.StorageVirtualMachine("advancedStorageVM", {
  fileSystemId: "fs-0987654321fedcba0",
  name: "AdvancedStorageVM",
  svmAdminPassword: "AnotherSecurePassword!",
  activeDirectoryConfiguration: {
    activeDirectoryId: "d-1234567890",
    organizationalUnitDistinguishedName: "OU=FSxOU,DC=example,DC=com",
    userName: "admin@example.com",
    password: "ADPassword123!"
  },
  tags: [
    { Key: "Environment", Value: "Production" },
    { Key: "Department", Value: "Finance" }
  ]
});

Integrating with Existing Resources

Create a Storage Virtual Machine that adopts an existing resource if it already exists:

ts
const adoptStorageVM = await AWS.FSx.StorageVirtualMachine("adoptStorageVM", {
  fileSystemId: "fs-1122334455667788",
  name: "AdoptStorageVM",
  adopt: true
});

Security Style Configuration

Set up a Storage Virtual Machine with specific security styles for the root volume:

ts
const securityStyleVM = await AWS.FSx.StorageVirtualMachine("securityStyleVM", {
  fileSystemId: "fs-2233445566778899",
  name: "SecurityStyleVM",
  rootVolumeSecurityStyle: "NTFS"
});