AWS::FSx::StorageVirtualMachine - AWS CloudFormation

AWS::FSx::StorageVirtualMachine

Creates a storage virtual machine (SVM) for an Amazon FSx for ONTAP file system.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::FSx::StorageVirtualMachine", "Properties" : { "ActiveDirectoryConfiguration" : ActiveDirectoryConfiguration, "FileSystemId" : String, "Name" : String, "RootVolumeSecurityStyle" : String, "SvmAdminPassword" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::FSx::StorageVirtualMachine Properties: ActiveDirectoryConfiguration: ActiveDirectoryConfiguration FileSystemId: String Name: String RootVolumeSecurityStyle: String SvmAdminPassword: String Tags: - Tag

Properties

ActiveDirectoryConfiguration

Describes the Microsoft Active Directory configuration to which the SVM is joined, if applicable.

Required: No

Type: ActiveDirectoryConfiguration

Update requires: No interruption

FileSystemId

Specifies the FSx for ONTAP file system on which to create the SVM.

Required: Yes

Type: String

Update requires: Replacement

Name

The name of the SVM.

Required: Yes

Type: String

Minimum: 1

Maximum: 47

Pattern: ^[^\u0000\u0085\u2028\u2029\r\n]{1,47}$

Update requires: Replacement

RootVolumeSecurityStyle

The security style of the root volume of the SVM. Specify one of the following values:

  • UNIX if the file system is managed by a UNIX administrator, the majority of users are NFS clients, and an application accessing the data uses a UNIX user as the service account.

  • NTFS if the file system is managed by a Windows administrator, the majority of users are SMB clients, and an application accessing the data uses a Windows user as the service account.

  • MIXED if the file system is managed by both UNIX and Windows administrators and users consist of both NFS and SMB clients.

Required: No

Type: String

Allowed values: MIXED | NTFS | UNIX

Update requires: Replacement

SvmAdminPassword

Specifies the password to use when logging on to the SVM using a secure shell (SSH) connection to the SVM's management endpoint. Doing so enables you to manage the SVM using the NetApp ONTAP CLI or REST API. If you do not specify a password, you can still use the file system's fsxadmin user to manage the SVM. For more information, see Managing SVMs using the NetApp ONTAP CLI in the FSx for ONTAP User Guide.

Required: No

Type: String

Update requires: No interruption

Tags

An array of key-value pairs to apply to this resource.

For more information, see Tag.

Required: No

Type: List of Tag

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the resource ID, such as svm-01234567890123456. For example:

{"Ref": "svm_logical_id"} returns

svm-01234567890123456

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

ResourceARN

Returns the storage virtual machine's Amazon Resource Name (ARN).

Example: arn:aws:fsx:us-east-2:111111111111:storage-virtual-machine/fs-0123456789abcdef1/svm-01234567890123456

StorageVirtualMachineId

Returns the storgage virtual machine's system generated ID.

Example: svm-0123456789abcedf1

UUID

Returns the storage virtual machine's system generated unique identifier (UUID).

Example: abcd0123-cd45-ef67-11aa-1111aaaa23bc

Examples

Create an Amazon FSx for NetApp ONTAP Storage Virtual Machine

The following examples create a 1.2 TiB persistent Amazon FSx for Lustre file system, with a PerUnitStorageThroughput of 200 MB/s/TiB.

JSON

{ "OntapStorageVirtualMachineWithAllConfigs": { "Type": "AWS::FSx::StorageVirtualMachine", "Properties": { "ActiveDirectoryConfiguration": { "NetBiosName": "svm1", "SelfManagedActiveDirectoryConfiguration": { "DnsIps": [ "10.0.10.67" ], "DomainName": "CFN-CUSTOMER-AD.SIMBA.LOCAL", "FileSystemAdministratorsGroup": "Domain Admins", "OrganizationalUnitDistinguishedName": "OU=cfn-customer-ad,DC=cfn-customer-ad,DC=simba,DC=local", "Password": { "Fn::Join": [ ":", [ "{{resolve:secretsmanager", { "Fn::ImportValue": "CustomerADCredentialName" }, "SecretString}}" ] ] }, "UserName": "Admin" } }, "FileSystemId": { "Ref": "OntapMultiAzFileSystemWithAllConfigs" }, "Name": "svm1", "RootVolumeSecurityStyle": "MIXED", "SvmAdminPassword": { "Password": { "Fn::Join": [ ":", [ "{{resolve:secretsmanager", { "Fn::ImportValue": "CustomerADCredentialName" }, "SecretString}}" ] ] } }, "Tags": [ { "Key": "Name", "Value": "OntapSvm" } ] } } }

YAML

OntapStorageVirtualMachineWithAllConfigs: Type: "AWS::FSx::StorageVirtualMachine" Properties: ActiveDirectoryConfiguration: NetBiosName: "svm1" SelfManagedActiveDirectoryConfiguration: DnsIps: ["10.0.10.67"] DomainName: "CFN-CUSTOMER-AD.SIMBA.LOCAL" FileSystemAdministratorsGroup: "Domain Admins" OrganizationalUnitDistinguishedName: "OU=cfn-customer-ad,DC=cfn-customer-ad,DC=simba,DC=local" Password: !Join - ':' - - '{{resolve:secretsmanager' - !ImportValue CustomerADCredentialName - 'SecretString}}' UserName: "Admin" FileSystemId: !Ref OntapMultiAzFileSystemWithAllConfigs Name: "svm1" RootVolumeSecurityStyle: "MIXED" SvmAdminPassword: Password: !Join - ':' - - '{{resolve:secretsmanager' - !ImportValue CustomerADCredentialName - 'SecretString}}' Tags: - Key: "Name" Value: "OntapSvm"