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}

Parameters

Parameter 1: action

Rescan the vSnap server.

  • Value: rescan

  • Type: System string. Required. Available in the web user interface.

Data

None.

Example: 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=...)
_images/reference_vsnap_rescan01.png

Figure 35 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 Actions > Rescan.

The request prompts a response that is structured as shown, with the HTTP status of 200 (OK).

{
    "links": {...},
    "resourceType": "storage",
    "type": "vsnap",
    "typeDisplayName": "vSnap",
    "site": "1000",
    "name": "10.0.1.1",
    "storageId": "2101",
    "user": {
        "href": "https://10.0.1.100:-1/api/identity/user/2120"
    },
    "rbacPath": "root:0/site:0/site:1000/site.all.storage:1000/storage:2101",
    "hostAddress": "10.0.1.1",
    "portNumber": 8900,
    "sslConnection": true,
    "initializeStatus": "Ready",
    "initializeStatusDisplayName": "Ready",
    "storageProfiles": null,
    "version": "10.1.6-1530",
    "capacity": {
        "free": 103498411008,
        "total": 107372085248,
        "updateTime": 1576511904805
    },
    "activeDirectoryInfo": null,
    "demo": false,
    "maxStreams": null,
    "isReady": true
}