Perform Capacity Upgrade

To modify the capacity of the PSC Dedicated array, you can use the array cloud-capacity endpoint in CLI or REST. This will trigger a backend process that will update the PSC Dedicated array capacity. The array capacity can be updated only to values defined by the capacity steps endpoint. When an existing capacity update request is in progress, any new request to update of the capacity will receive an error response. To be able to perform the Capacity Upgrade, the user must have the Array_admin policy associated.

Note:

For non-PSC Dedicated arrays, this feature is not supported and requests will receive an error response.

Using CLI

The capacity upgrade can be achieved using the cloud-capacity endpoint.


purearray cloud-capacity --help
usage: purearray cloud-capacity [-h] {list,setattr}

{list,setattr}
    list             get current capacity or list supported capacities
    setattr          update the capacity

options:
  -h, --help         show this help message and exit

1. Check the status of the capacity update. It can be on of the following values:

idle - default state, no update is in progress, updates are allowed
expanding - update is in progress, further updates are not allowed


purearray cloud-capacity list

Output Example:


pureuser@cbspv2> purearray cloud-capacity list
Requested Capacity  Current Capacity  Status  Details
14.00T              14.00T            idle

2. List the available capacity points, the values are shown in raw capacity. You can map raw to usable capacity in the Capacity Point section.


purearray cloud-capacity list --supported

Output Example (V20 Model):


pureuser@cbspv2> purearray cloud-capacity list --supported
Supported Capacity
7.00T
14.00T
28.00T
42.00T
56.00T
70.00T
84.00T
98.00T
112.00T
126.00T
140.00T
154.00T
168.00T
182.00T
196.00T
210.00T
224.00T

3. Request a capacity upgrade, use the setattr --requested-capacity flag. The <raw-capacity> attribute indicates the total raw capacity the array will have after the expansion is complete.


purearray cloud-capacity setattr --requested-capacity <raw-capacity>

Output Example:


pureuser@cbspv2> purearray cloud-capacity setattr --requested-capacity 28T
Requested Capacity  Current Capacity  Status     Details
28.00T      14.00T     expanding

4. If you check the status of the capacity upgrade after requesting the capacity. You will be getting updates under Details.


pureuser@cbspv2> purearray cloud-capacity list
Requested Capacity  Current Capacity  Status     Details
28.00T      14.00T     expanding  Capacity update in progress

pureuser@cbspv2> purearray cloud-capacity list
Requested Capacity  Current Capacity  Status     Details
28.00T      14.00T    expanding  2 drives out of 14 updated successfully

5. On Azure Managed Resource Group you can see the size of corresponding disks will change after capacity upgrade process is finished.

Using REST API

The capacity upgrade can also be achieved using the cloud-capacity endpoint via REST.

1. GET arrays/cloud-capacity List PSC Dedicated array capacity status, including the progress of the capacity update.

Example using cURL:


curl -X GET -H "Authorization: Bearer $TOKEN" https://my-array/api/2.X/arrays/cloud-capacity

Response:


{
  "items": [
    {
      "id":                 "0f58952a-13e4-4182-b1dd-76914257a1f1",
      "name":               "PAZ-array",
      "requested_capacity": 10995116277760,
      "current_capacity":   10995116277760,
      "status":             "idle",
      "detail":             null
    }
  ],
}

2. GET /arrays/cloud-capacity/supported-steps List the available PSC Dedicated capacity points

Example using cURL:


curl -X GET -H "Authorization: Bearer $TOKEN" https://my-array/api/2.X/arrays/cloud-capacity/supported-steps"

Response:


{
  "items": [
    {
      "supported_capacity": 10995116277760,
    },
    {
      "supported_capacity": 21990232555520,
    },
    ...
  ],
}

3. PATCH /arrays/cloud-capacity Update the (raw) requested capacity. The requested capacity indicates the total raw capacity the array will have after the expansion is complete.

Example using cURL:


curl -X PATCH -H "Authorization: Bearer $TOKEN" "https://my-array/api/2.29/arrays/cloud-capacity" -d "{ \"requested_capacity\": 10995116277760}"

Response:


{
  "items": [
    {
      "id":                 "0f58952a-13e4-4182-b1dd-76914257a1f1",
      "name":               "my-array",
      "requested_capacity": 10995116277760,
      "current_capacity":   10995116277760,
      "status":             "idle",
      "detail":             null
    }
  ],
}

GET Request (after triggering the capacity expansion)


{
  "items": [
    {
      "requested_capacity": 21990232555520,
      "current_capacity":   10995116277760,
      "status":             "expanding",
      "detail":             null
    }
  ],
}