Guide RESTful API des systèmes Oracle^® ZFS Storage Appliance, version OS8.8.x

Châssis

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

Table 14  Commandes matérielles

Demande Ajouter au chemin /hardware/v{1|2} 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

Liste des châssis

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.

Propriété Type Description name string Nom du châssis model string Numéro de modèle du châssis manufacturer string Fabricant du châssis serial string Numéro de série du châssis revision string Niveau de révision du châssis part string Numéro de pièce de remplacement du châssis type string Type de stockage sur châssis faulted boolean Indicateur de panne uuid string 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é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"
    }]
}

Obtention des composants d'un châssis

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",
        }],
    }
}

Obtention d'un composant matériel

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.

Propriété Type Description device string ID de périphérique de la FRU faulted boolean Indicateur de panne de la FRU interface string Type d'interface de la FRU label string Etiquette d'emplacement de la FRU locate boolean Indicateur d'allumage de la LED de localisation de la FRU manufacturer string Fabricant de la FRU model string Modèle de FRU offline boolean Indicateur de l'état hors ligne du disque. pathcount integer Nombre total de chemins d'E/S vers l'étagère de disques present boolean Indicateur de présence de la FRU readytoremove boolean Indique si le disque est prêt à être retiré après une panne revision string Révision de microprogramme ou de matériel de la FRU rpm number Tr/mn du plateau (disque uniquement) serial string Numéro de série de la FRU size number Taille de la FRU (capacité) type string Type de composant use string 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: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"
    }
}

Modification des propriétés d'un composant

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
    }
}