Guía de la API de RESTful de Oracle^® ZFS Storage Appliance (versión OS8.8.x)

Chasis de

Los comandos del hardware se usan para obtener una lista del chasis y de los componentes del hardware del dispositivo.

Tabla 14  Comandos de hardware

Solicitud Anexar a la ruta de acceso /hardware/v{1|2} Descripción GET /chassis Mostrar chasis de hardware. GET /chassis/chassis Obtener las propiedades del chasis de hardware especificado. PUT /chassis/chassis Modificar las propiedades del chasis de hardware especificado. GET /chassis/chassis/fru_type Mostrar componentes del chasis del hardware. GET /chassis/chassis/fru_type/fru Obtener las propiedades del componente del chasis especificado. PUT /chassis/chassis/fru_type/fru Modificar las propiedades de componente del chasis del hardware.

Mostrar chasis

El comando get chasis no toma ningún argumento y devuelve una lista de objetos del chasis del sistema. Se devuelve HTTP Status 200 (OK) (estado HTTP 200 [correcto]) cuando un comando se ejecuta correctamente.

Propiedad Tipo Descripción name string Nombre del chasis model string Número de modelo del chasis manufacturer string Fabricante del chasis serial string Número de serie del chasis revision string Nivel de revisión del chasis part string Número de pieza de reemplazo del chasis type string Tipo de almacenamiento del chasis faulted boolean Indicador de fallo uuid string Identificador uuid del chasis

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

Obtener componentes del chasis

Este comando devuelve todos los componentes del hardware dentro del chasis especificado. Se devuelve HTTP Status 200 (OK) (estado HTTP 200 [correcto]) cuando un comando se ejecuta correctamente.

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

Obtener componente de hardware

Este comando devuelve las propiedades de un solo componente de hardware. Se devuelve HTTP Status 200 (OK) (estado HTTP 200 [correcto]) cuando un comando se ejecuta correctamente. El objeto de la respuesta contiene las propiedades del componente que se muestran en la tabla siguiente.

Las propiedades offline, readytoremove y use se aplican solo a los discos de un pool.

Propiedad Tipo Descripción device string El ID del dispositivo FRU faulted boolean Si la FRU contiene fallas interface string Tipo de interfaz de FRU label string Etiqueta de ubicación de FRU locate boolean Si el LED de localización de FRU está encendido manufacturer string Fabricante del FRU model string Modelo del FRU offline boolean Si el disco está fuera de línea pathcount integer Número total de rutas de E/S del estante de discos present boolean Indicador de presencia de FRU readytoremove boolean Si la unidad de disco está lista para quitar después del fallo revision string Revisión de firmware o hardware de FRU rpm number RPM de Platter (solo disco) serial string Número de serie de FRU size number Tamaño del FRU (capacidad) type string Tipo de componente use string Enumeración de uso de componente

Ejemplo de solicitud:

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

Resultado de ejemplo:

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

Modificar propiedad del componente

Se puede usar una solicitud PUT para configurar propiedades en un componente de hardware seleccionado. Una respuesta satisfactoria devuelve el estado HTTP 201 (Accepted), además de las propiedades de los componentes en formato JSON.

Ejemplo de solicitud:

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}

Ejemplo de respuesta 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
    }
}