Châssis

Langue :

Les commandes du matériel permettent d'obtenir une liste des châssis et composants matériels de l'appareil

Demande	Chemin /hardware/v1.0	Description
GET	/chassis	Liste des châssis du matériel
GET	/chassis/<`chassis`>	Obtention des propriétés de châssis du matériel spécifié
PUT	/chassis/<`chassis`>	Modification des propriétés de châssis du matériel spécifié
GET	/chassis/<`chassis`>/<`fru_type`>	Liste des composants du châssis du matériel
GET	/chassis/<`chassis`>/<`fru_type`> /<`fru`>	Obtention des propriétés des composants du châssis spécifié
PUT	/chassis/<`chassis`>/<`fru_type`> /<`fru`>	Modification des propriétés des composants du châssis du matériel

List Chassis

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.

Type	Propriété	Description
string	name	Nom du châssis
string	model	Numéro de modèle du châssis
string	manufacturer	Fabricant du châssis
string	serial	Numéro de série du châssis
string	revision	Niveau de révision du châssis
string	part	Numéro de pièce de remplacement du châssis
boolean	faulted	Indicateur de panne
string	fru	Représentation FMRI du châssis
string	uuid	Identificateur UUID du châssis

Exemple de demande :

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

Exemple de réponse :

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-1",
        "name": "cairo",
        "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"
    }]
}

Get Chassis Components

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/nas/v1/chassis/chassis-001 HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Exemple de réponse :

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,
            "manufacturer": "HITACHI",
            "model": "H7230AS60SUN3.0T",
            "pathcount": 4,
            "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",
        }],
    }
}

Get Hardware Component

Cette commande renvoie les propriétés à partir 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 contenues dans le tableau suivant.

Type	Nom	Description
string	device	ID de périphérique de la FRU
boolean	faulted	Indicateur de panne de la FRU
string	fru	Représentation FMRI d'une FRU
string	interface	Type d'interface de la FRU
string	label	Etiquette d'emplacement de la FRU
boolean	locate	Indicateur de localisation sur l'indicateur
string	manufacturer	Fabricant de la FRU
string	model	Modèle de FRU
string	part	Numéro de référence de la FRU
boolean	present	Indicateur de présence de la FRU
number	rpm	Tr/mn du plateau (disque uniquement)
string	serial	Numéro de série de la FRU
number	size	Taille de la FRU (capacité)
string	type	Type de composant
string	use	Enumération de l'utilisation des composants

Exemple de demande :

GET /api/hardware/v1/chassis/chassis-001/disk/disk-011 HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Exemple de réponse :

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,
        "manufacturer": "HITACHI",
        "model": "H7230AS60SUN3.0T",
        "pathcount": 4,
        "present": true,
        "revision": "A310",
        "rpm": 7200,
        "serial": "001210R322ED        YHJ322ED",
        "size": 3000592982016,
        "type": "data",
        "use": "peer"
    }
}

Modify Component Property

Vous pouvez utiliser une demande PUT pour définir des propriétés sur 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: zfssa.example.com:215
X-Auth-User: root
X-Auth-Key: letmein
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
    }
}