Chasis

Idioma:

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