Creating a Single Volume

Microsoft Platform Guide

Audience
Public
Source Type
Documentation

Creating volumes on the FlashArray is very simple because we remove all of the complexities of needing to define RAID groups or aggregates. All of the below examples of how to work with volumes assumes that an existing connection to the Everpure FlashArray has been created using the How-To: Connect to a FlashArray with the PowerShell SDK v1 topic.

Note:

Remember from the How-To: Connect to a FlashArray with the PowerShell SDK v1 topic that the $FlashArray variable will be used to perform tasks against the authenticated FlashArray.

Let's first create a single volume using the New-PfaVolume cmdlet. The only parameters that are required:

  • -VolumeName -- Target volume name.
  • -Unit -- Valid unit symbols are K, M, G, T, P, representing KiB, MiB, GiB, TiB, and PiB, respectively, where "Ki" denotes 2^10, "Mi" denotes 2^20, and so on.
  • -Size -- Size in bytes of the volume.

PS C:\> New-PfaVolume -Array $FlashArray -VolumeName 'SDK-Sample' -Unit G -Size 500

source  :
serial  : 95DAA3D006E43D8F0004B467
created : 2016-11-01T21:30:47Z
name    : SDK-Sample
size    : 536870912000
Note:

The New-PfaVolume cmdlet has a -WhatIf parameter that shows the exact REST API call in JSON format. This is helpful when wanting to understand what exactly a cmdlet is passing to the REST API.


PS C:\> New-PfaVolume -Array $FlashArray -VolumeName 'SDK-Sample' -Unit G -Size 500 -WhatIf
What if: Performing the operation "New-PfaVolume" on target "
POST https://10.0.0.1/api/1.7/volume/SDK-Sample
{
  "size": "500G"
}".