섀시 - Oracle® ZFS Storage Appliance RESTful API 설명서, 릴리스 OS8.6.x

언어:

섀시

하드웨어 명령은 어플라이언스 하드웨어 섀시 및 구성요소 목록을 가져오는 데 사용됩니다.

요청	경로 /hardware/v1.0	설명
GET	/chassis	하드웨어 섀시를 나열합니다.
GET	/chassis/<`chassis`>	지정된 하드웨어 섀시 등록 정보를 가져옵니다.
PUT	/chassis/<`chassis`>	지정된 하드웨어 섀시 등록 정보를 수정합니다.
GET	/chassis/<`chassis`>/<`fru_type`>	하드웨어 섀시 구성요소를 나열합니다.
GET	/chassis/<`chassis`>/<`fru_type`> /<`fru`>	지정된 섀시 구성요소 등록 정보를 가져옵니다.
PUT	/chassis/<`chassis`>/<`fru_type`> /<`fru`>	하드웨어 섀시 구성요소 등록 정보를 수정합니다.

섀시 나열

섀시 가져오기 명령은 인수를 사용하지 않고 시스템 섀시 객체 목록을 반환합니다. 성공한 명령에 대해 HTTP 상태 200(OK)이 반환됩니다.

유형	등록 정보	설명
string	name	섀시 이름
string	model	섀시 모델 번호
string	manufacturer	섀시 제조업체
string	serial	섀시 일련 번호
string	revision	섀시 개정 레벨
string	part	섀시 교체 부품 번호
boolean	faulted	결함 표시기
string	fru	섀시의 FMRI 표현
string	uuid	섀시 uuid 식별자

요청 예:

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

응답 예:

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

섀시 구성요소 가져오기

이 명령은 지정된 섀시 내 모든 하드웨어 구성요소를 반환합니다. 성공한 명령에 대해 HTTP 상태 200(OK)이 반환됩니다.

요청 예:

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

응답 예:

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

하드웨어 구성요소 가져오기

이 명령은 단일 하드웨어 구성요소의 등록 정보를 반환합니다. 성공한 명령에 대해 HTTP 상태 200(OK)이 반환됩니다. 응답 객체는 다음 표에 포함된 구성요소 등록 정보를 포함합니다.

유형	이름	설명
string	device	FRU 장치 ID
boolean	faulted	FRU에 결함이 있는지 여부를 나타내는 플래그
string	fru	FRU의 FMRI 표현
string	interface	FRU 인터페이스 유형
string	label	FRU 위치 레이블
boolean	locate	플래그의 찾기 표시기
string	manufacturer	FRU 제조업체
string	model	FRU 모델
string	part	FRU 부품 번호
boolean	present	FRU 존재 표시기
number	rpm	플래터 RPM(디스크 전용)
string	serial	FRU 일련 번호
number	size	FRU 크기(용량)
string	type	구성요소 유형
string	use	구성요소 사용법 열거

요청 예:

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

응답 예:

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

구성요소 등록 정보 수정

PUT 요청은 선택된 하드웨어 구성요소에 대한 등록 정보를 설정하는 데 사용할 수 있습니다. 성공한 요청은 HTTP 상태 201(Accepted)은 물론 JSON 형식의 구성요소 등록 정보도 반환합니다.

요청 예:

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}

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