Problem Service Commands

Table 10-1 Problem Service Commands

Request	Append to Path /problem/v{1|2}	Description
GET	Use only /problem/v{1|2}	List the problem service commands
GET	/problems	List all current problems
GET	/problems/problem	Get detail properties for a problem with the specified uuid
PUT	/problems/problem/markrepaired	Mark the specified problem uuid as repaired
GET	/suspend_notification	Show whether notifications are suspended
PUT	/suspend_notification/enable	Suspend notifications
PUT	/suspend_notification/disable	Resume notifications

List Problems

This command lists all problems that are currently active on an Oracle ZFS Storage Appliance system. HTTP status of 200 (OK) is returned for a successful command.

Example Request:

GET /api/problem/v1/problems HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Example Result:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "problems": [{
        "code": "AK-8003-Y6",
            "description": "The device configuration for JBOD
                       '1204FMD063' is invalid.",
            "impact": "The disks contained within the enclosure
                   cannot be used as part of a storage pool.",
        "uuid": "0d30be41-b50d-4d03-ddb4-edb69ee080f8",
        "repairable": false,
        "type": "Defect",
            "timestamp": "2013-2-21 17:37:12",
            "severity": "Major",
        "components": [{
                "certainty": 100,
                    "status": "degraded",
                    "uuid": "b4fd328f-92d6-4f0e-fb86-e3967a5473e7",
                "chassis": "1204FMD063",
                "label": "hc://:chassis-mfg=SUN
                    :chassis-name=SUN-Storage-J4410
                    :chassis-part=unknown
                    :chassis-serial=1204FMD063
                                :fru-serial=1204FMD063
                    :fru-part=7041262
                                :fru-revision=3529/ses-enclosure=0",
                "revision": "3529",
                    "part": "7041262",
                    "model": "Sun Disk Shelf (SAS-2)",
                    "serial": "1204FMD063",
                    "manufacturer": "Sun Microsystems, Inc."
        }]
    }]
}

List Problem

The list problem command lists a single problem. HTTP status of 200 (OK) is returned for a successful command.

The list problem command uses the uuid input parameter, which is the UUID of a single problem.

Example Request:

GET /api/problem/v1.0/problems/0d30be41-b50d-4d03-ddb4-edb69ee080f8
    HTTP/1.1
Host: zfs-storage.example.com:215
Accept: application/json

Example Result:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "problem": {
        "uuid": "0d30be41-b50d-4d03-ddb4-edb69ee080f8",
        ...
    }
}