Les commandes du matériel permettent d'obtenir une liste des châssis et composants matériels de l'appareil
|
Cette commande n'utilise pas d'arguments et renvoie une liste d'objets de châssis du système. Le code de statut HTTP 200 (OK) est renvoyé lorsqu'une commande aboutit.
|
Exemple de demande :
GET /api/hardware/v1/chassis HTTP/1.1 Host: zfs-storage.example.com:215 Accept: application/json
Exemple de résultat :
HTTP/1.1 200 OK Content-Length: 788 Content-Type: application/json X-Zfssa-Appliance-Api: 1.0 { "hardware": [{ "faulted": false, "href": "/api/hardware/v1/chassis/chassis-000", "manufacturer": "Oracle", "model": "Oracle ZFS Storage ZS3-2", "name": "hostname", "rpm": "--", "serial": "1211FM200C", "type": "system" }, { "faulted": false, "href": "/api/hardware/v1/chassis/chassis-001", "locate": false, "manufacturer": "Oracle", "model": "Oracle Storage DE2-24C", "name": "1235FM4002", "part": "7046842", "path": 2, "revision": "0010", "rpm": 7200, "serial": "1235FM4002", "type": "storage" }, { "faulted": false, "href": "/api/hardware/v1/chassis/chassis-002", "locate": false, "manufacturer": "Oracle", "model": "Oracle Storage DE2-24P", "name": "50050cc10c206b96", "part": "7046836", "path": 2, "revision": "0010", "rpm": 10000, "serial": "50050cc10c206b96", "type": "storage" }] }
Cette commande renvoie tous les composants matériels dans le châssis spécifié. Le code de statut HTTP 200 (OK) est renvoyé lorsqu'une commande aboutit.
Exemple de demande :
GET /api/hardware/v1/chassis/chassis-001 HTTP/1.1 Host: zfs-storage.example.com:215 Accept: application/json
Exemple de résultat :
HTTP/1.1 200 OK Content-Type: application/json { "chassis": { "type": "storage" "faulted": false, "href": "/api/hardware/v1/chassis/chassis-001", "locate": false, "manufacturer": "Oracle", "model": "Oracle Storage DE2-24C", "name": "1235FM4002", "part": "7046842", "path": 2, "revision": "0010", "rpm": 7200, "serial": "1235FM4002", "disk": [{ "device": "c0t5000CCA01A76A2B8d0", "faulted": false, "href": "/api/hardware/v1/chassis/chassis-001/disk/disk-000", "interface": "SAS", "label": "HDD 0", "locate": false, "offline": false, "readytoremove": false, "manufacturer": "HITACHI", "model": "H7230AS60SUN3.0T", "pathcount": 2, "present": true, "revision": "A310", "rpm": 7200, "serial": "001210R37LVD--------YHJ37LVD", "size": 3000592982016, "type": "data", "use": "peer" }, { "href": "/api/hardware/v1/chassis/chassis-001/disk/disk-001", ... }, { "href": "/api/hardware/v1/chassis/chassis-001/disk/disk-002", ... }, ... { "href": "/api/hardware/v1/chassis/chassis-001/disk/disk-023", ... }], "fan": [ { "href": "/api/hardware/v1/chassis/chassis-001/fan/fan-000", ... }, ... { "href": "/api/hardware/v1/chassis/chassis-001/fan/fan-007", }], "psu": [ { "href": "/api/hardware/v1/chassis/chassis-001/psu/psu-000", ... }, { "href": "/api/hardware/v1/chassis/chassis-001/psu/psu-001", }, { "href": "/api/hardware/v1/chassis/chassis-001/psu/psu-002", }, { "href": "/api/hardware/v1/chassis/chassis-001/psu/psu-003", }], "slot": [{ "href": "/api/hardware/v1/chassis/chassis-001/slot/slot-000", }, { "href": "/api/hardware/v1/chassis/chassis-001/slot/slot-001", }], } }
Cette commande renvoie les propriétés d'un composant matériel unique. Le code de statut HTTP 200 (OK) est renvoyé lorsqu'une commande aboutit. L'objet réponse contient les propriétés des composants présentées dans le tableau suivant.
Les propriétés offline, readytoremove et use ne s'appliquent qu'aux disques d'un pool.
|
Exemple de demande :
GET /api/hardware/v1/chassis/chassis-001/disk/disk-011 HTTP/1.1 Host: zfs-storage.example.com:215 Accept: application/json
Exemple de résultat :
HTTP/1.1 200 OK Content-Type: application/json { "disk": { "device": "c0t5000CCA01A764FB0d0", "faulted": false, "href": "/api/hardware/v1/chassis/chassis-001/disk/disk-011", "interface": "SAS", "label": "HDD 11", "locate": false, "offline": false, "readytoremove": false, "manufacturer": "HITACHI", "model": "H7230AS60SUN3.0T", "pathcount": 2, "present": true, "revision": "A310", "rpm": 7200, "serial": "001210R322ED--------YHJ322ED", "size": 3000592982016, "type": "data", "use": "peer" } }
Vous pouvez utiliser une demande PUT pour définir les propriétés d'un composant matériel sélectionné. Une demande traitée avec succès renvoie un code de statut HTTP 201 (Accepted) ainsi que les propriétés du composant au format JSON.
Exemple de demande :
PUT /api/hardware/v1/chassis/chassis-001/disk/disk-011 HTTP/1.1 Host: zfs-storage.example.com:215 X-Auth-User: root X-Auth-Key: password Accept: application/json Content-Type: application/json Content-Length: 16 {"locate": true}
Exemple de réponse au format JSON :
HTTP/1.1 202 Accepted X-Zfssa-Appliance-Api: 1.0 Content-Length: 403 Content-Type: application/json { "disk": { "href": "/api/hardware/v1/chassis/chassis-001/disk/disk-011", ..., "locate": true } }