Rescanning disk storage: vSnap server¶
If IBM Spectrum Protect Plus reports that a vSnap server is reaching its storage capacity, the vSnap storage pool must be expanded. To expand a vSnap storage pool, you must first add virtual or physical disks on the vSnap server, either by adding virtual disks to the vSnap virtual machine or adding physical disks to the vSnap physical server. See the vSphere documentation for information about creating additional virtual disks.
Method and URI¶
To rescan a vSnap server with {storageId}
, use a POST method and a URI:
POST https://{hostname|IPv4}/api/storage/{storageId}
To get information about vSnap server disks that are not registered with IBM Spectrum Protect Plus, use a GET method and a URI:
GET https://{hostname|IPv4}/api/storage/{storageId}/management/disk
Parameters¶
Parameter 1: action
Rescan the vSnap server.
Value:
rescan
Type: System string. Required. Available in the web user interface.
Data¶
None.
Example 1: Rescan vSnap server¶
Assume that you have a vSnap server ({storageId}
2101).
A Python snippet that is similar to the following example can be used to rescan the vSnap server:
storage_id = "2101"
_params = {"action": "rescan"}
requests.post('https://' + spp_ipv4 + '/api/storage/' + storage_id,
headers={...}, params=_params, verify=...)

Figure 34 The same action can be taken in the IBM Spectrum Protect Plus web user interface: In the navigation pane, click System Configuration > Backup Storage > Disk and click the Edit icon of the vSnap server to edit. In the Manage Backup Storage page, click the Disks tab, and click Rescan.¶
You will receive a response with the HTTP status of 200 (OK).
Example 2: Get information about unregistered disks in a vSnap server¶
Assume that you rescanned a vSnap server ({storageId}
2101) in the previous example, and this vSnap server has an unused, virtual hard disk drive with the capacity of 200 GB.
A Python snippet that is similar to the following example can be used to get information about
storage_id = "2101"
requests.get('https://' + spp_ipv4 + '/api/storage/' + storage_id
+ '/management/disk'
headers={...}, params=_params, verify=...)
The request prompts a response that is structured as shown, with the HTTP status of 200 (OK).
{
"links":{...},
"total":1,
"disks": [
{
"links": {...},
"resourceType": "disk",
"model": "Virtual disk",
"name": "/dev/sdd",
"size": 214748364800,
"type": "SCSI",
"uuid": "1234567890abcdef1234567890abcdef",
"vendor": "VMware",
"usedAs": "unused",
"id": "1234567890abcdef1234567890abcdef",
"storageId": "2101",
"storageServerId": "2101",
"originalPk": null,
"protectionTime": null,
"sessionId": null,
"name": "/dev/sdd"
}
]
}