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

언어:

섀시

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

표 14 하드웨어 명령

요청	경로 /hardware/v{1\|2}에 추가	설명
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)이 반환됩니다.

등록 정보	유형	설명
`name`	string	섀시 이름
`model`	string	섀시 모델 번호
`manufacturer`	string	섀시 제조업체
`serial`	string	섀시 일련 번호
`revision`	string	섀시 개정 레벨
`part`	string	섀시 교체 부품 번호
`type`	string	섀시 스토리지 유형
`faulted`	boolean	결함 표시기
`uuid`	string	섀시 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-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"
    }]
}

섀시 구성요소 가져오기

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

요청 예:

GET /api/hardware/v1/chassis/chassis-001 HTTP/1.1
Host: zfs-storage.example.com:215
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,
            "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",
        }],
    }
}

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

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

offline, readytoremove 및 use 등록 정보는 풀의 디스크에만 적용됩니다.

등록 정보	유형	설명
`device`	string	FRU 장치 ID
`faulted`	boolean	FRU에 결함이 발생했는지 여부
`interface`	string	FRU 인터페이스 유형
`label`	string	FRU 위치 레이블
`locate`	boolean	FRU 위치 LED가 켜져 있는지 여부
`manufacturer`	string	FRU 제조업체
`model`	string	FRU 모델
`offline`	boolean	디스크가 오프라인인지 여부
`pathcount`	integer	Disk Shelf에 대한 총 I/O 경로 수입니다
`present`	boolean	FRU 존재 표시기
`readytoremove`	boolean	결함 후 디스크 드라이브의 분리가 준비되었는지 여부
`revision`	string	FRU의 펌웨어 또는 하드웨어 개정
`rpm`	number	플래터 RPM(디스크 전용)
`serial`	string	FRU 일련 번호
`size`	number	FRU 크기(용량)
`type`	string	구성요소 유형
`use`	string	구성요소 사용법 열거

요청 예:

GET /api/hardware/v1/chassis/chassis-001/disk/disk-011 HTTP/1.1
Host: zfs-storage.example.com:215
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,
        "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"
    }
}

구성요소 등록 정보 수정

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

요청 예:

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}

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