Chasis

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

Solicitud Ruta /hardware/v1.0 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.

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

Ejemplo de solicitud:

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

Ejemplo de respuesta:

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

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

Ejemplo de respuesta:

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

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 contenidas en la tabla siguiente.

Tipo Nombre Descripción string device El ID del dispositivo FRU boolean faulted Indicador que muestra si el FRU es defectuoso string fru FMRI representación de un FRU string interface Tipo de interfaz de FRU string label Etiqueta de ubicación de FRU boolean locate Indicador de ubicación en indicador string manufacturer Fabricante del FRU string model Modelo del FRU string part Número de pieza de FRU boolean present Indicador de presencia de FRU number rpm RPM de Platter (solo disco) string serial Número de serie de FRU number size Tamaño del FRU (capacidad) string type Tipo de componente string use 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
Accept: application/json

Ejemplo de respuesta:

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

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: zfssa.example.com:215
X-Auth-User: root
X-Auth-Key: letmein
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
    }
}