REST Request Examples

The following examples show how to use REST to create, read, update, and delete RAD resources.

Example 3-4 Creating a Resource by Using REST

This example shows how to create a ZFS file system named p2 in rpool/export/home/testuser.

Sample request:

# curl -H 'Content-Type:application/json' -X PUT -b cookiejar \
https://radserver.example.com/api/com.oracle.solaris.rad.zfsmgr/1.0/ZfsDataset/rpool/_rad_method/create_filesystem \
--data '{"name":"rpool/export/home/testuser/p2"}'

Sample response:

{
        "status": "success",
        "payload": {
                "href": "/api/com.oracle.solaris.rad.zfsmgr/1.0/ZfsDataset/_rad_reference/5889"
        }
}

Example 3-5 Updating a Resource by Using REST

This example shows how to update the value of the maxbw property for the net0 interface.

Sample request:

# curl -H 'Content-Type:application/json' -X PUT -b cookiejar \
https://radserver.example.com/api/com.oracle.solaris.rad.dlmgr/1.1/Datalink/net0/_rad_method/setProperty \
--data '{"properties":"maxbw=300","flags":1}'

Sample response:

{
        "status": "success",
        "payload": null
}

Example 3-6 Querying a Resource by Using REST

This example shows how to get a list of all the ZFS file systems available in rpool.

Sample request:

# curl -H 'Content-Type:application/json' -X PUT -b cookiejar \
https://radserver.example.com/api/com.oracle.solaris.rad.zfsmgr/1.0/ZfsDataset/rpool/_rad_method/get_filesystems \
--data'{"recursive":true}'

Sample response:

{
        "status": "success",
        "payload": [
                "rpool/ROOT",
                "rpool/ROOT/solaris",
                "rpool/ROOT/solaris/var",
                "rpool/VARSHARE",
                "rpool/VARSHARE/zones",
                "rpool/VARSHARE/pkg",
                "rpool/VARSHARE/pkg/repositories",
                "rpool/export",
                "rpool/export/home",
                "rpool/export/home/testuser"
        ]
}

Example 3-7 Deleting a Resource by Using REST

This example shows how to delete a user named tuser4.

Sample request:

# curl -H 'Content-Type:application/json' -X PUT -b cookiejar \
https://radserver.example.com/api/com.oracle.solaris.rad.usermgr/1.0/UserMgr/_rad_method/deleteUser \
--data '{"username":"tuser4"}'

Sample response:

{
        "status": "success",
        "payload": null
}