Go to main content
Oracle® ZFS Storage Appliance RESTful API Guide, Release OS8.7.0

Exit Print View

Updated: July 2017
 
 

Remove Storage from a Pool

This command is similar to add storage to a pool. Remove storage removes cache and log storage devices from an existing pool. Send href <pool>/remove with the body containing the desired type, chassis number, and number of storage devices to remove from the pool.

Example Request:

    PUT /api/storage/v1/pools/p1/remove HTTP/1.1
    Host: zfs-storage.example.com
    Authorization: Basic abhadbfsMWE=
    Content-Type: application/json
    Accept: application/json
    {
      "0-cache" : 2
    }
  

Example Response:

    HTTP/1.1 202 Accepted
  

To display the number of devices that can be removed, set the query parameter props to true.

Example Request:

    PUT /api/storage/v1/pools/p1/remove?props=true
        HTTP/1.1
    Host: zfs-storage.example.com
    Authorization: Basic abhadbfsMWE=
    Content-Type: application/json
    Accept: application/json
  

Example Response:

    HTTP/1.1 200 OK
    Content-Type: application/json
    {
          "props": [
              {
                  "choices": [
                      "0",
                      "1",
                      "2"
                  ],
                  "type": "ChooseOne",
                  "name": "0-cache",
                  "label": "Chassis 0 cache"
              },
              {
                  "choices": [
                      "0",
                      "1",
                      "2"
                  ],
                  "type": "ChooseOne",
                  "name": "1-log",
                  "label": "Chassis 1 log"
              }
          ]
    }