iSCSI 대상 명령은 iSCSI 대상 및 iSCSI 대상 그룹을 관리하는 데 사용됩니다. 사용 가능한 명령은 아래에 나열되어 있습니다.
|
이 명령은 다음 URI 매개변수를 사용합니다.
|
모든 대상 "get" 명령은 대상 등록 정보를 반환하고 "target" "create" 및 수정 명령은 다음 등록 정보를 입력으로 사용합니다.
|
다음 등록 정보는 iSCSI 대상 그룹 정보를 가져오는 데 사용됩니다.
|
어플라이언스에서 사용할 수 있는 지정된 프로토콜의 모든 SAN 대상을 나열합니다.
요청 예:
GET /api/san/v1/iscsi/targets HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= Accept: application/json
응답 예:
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 1337 { "size": 7, "targets": [{ "alias": "tst.volumes.py.12866.target", "href": "/api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02: 72b6fa9a-96c4-e511-db19-aadb9bac2052", "iqn": "iqn.1986-03.com.sun:02:72b6fa9a-96c4- e511-db19-aadb9bac2052", ... }, { "alias": "tst.volumes.py.96238.target", "href": "/api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02: 31d26d2e-6aa0-6054-fe58-8b1fb508b008", "iqn": "iqn.1986-03.com.sun:31d26d2e-6aa0-6054-fe58-8b1fb508b008", ... } ...] }
단일 대상에서 등록 정보를 가져옵니다. "iqn" 등록 정보 또는 "alias=<alias>"를 사용하여 대상을 선택할 수 있습니다.
요청 예:
GET /api/san/v1/iscsi/targets/alias=test-target HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= Accept: application/json
응답 예:
HTTP/1.1 200 OK Content-Type: application/json Content-Length: 251 { "target": { "alias": "test-target", "auth": "none", "href": "/api/san/v1/iscsi/targets/alias=test-target", "interfaces": ["ixgbe0"], "iqn": "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "targetchapsecret": "", "targetchapuser": "" } }
새 대상을 만듭니다. 요청 본문은 새 iSCSI 대상 그룹의 이름인 단일 name 등록 정보가 있는 JSON 객체를 포함합니다.
요청 예:
POST /api/san/v1/iscsi/targets HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= Content-Type: application/json Content-Length: 23 Accept: application/json {"alias": "test-target"}
응답 예:
HTTP/1.1 201 Created Content-Type: application/json Content-Length: 233 X-Zfssa-San-Api: 1.0 Location: /api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008 { "target": { "href": "/api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "alias": "test-target", "iqn": "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "auth": "none", "targetchapuser": "", "targetchapsecret": "", "interfaces": ["ixgbe0"] } }
기존 iSCSI 대상을 수정합니다. 요청 본문은 수정되는 iSCSI 대상 등록 정보를 포함하는 JSON 객체를 포함합니다. 성공 시 HTTP 상태 202(Accepted)가 반환됩니다. 응답 본문은 JSON 객체로 인코딩된 대상에 대한 결과 iSCSI 대상 등록 정보를 포함합니다.
요청 예:
PUT /api/san/v1/iscsi/targets/alias=test-target HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE= Host: zfs-storage.example.com Content-Type: application/json Content-Length: 54 Accept: application/json {"targetchapsecret":"letmeinnowplease", "auth":"chap", "targetchapuser":"argus"}
응답 예:
HTTP/1.1 202 Accepted Content-Type: application/json Content-Length: 189 X-Zfssa-San-Api: 1.0 { "target": { "href": "/api/san/v1/iscsi/targets/alias=test-target", "auth": "chap", "targetchapsecret": "letmeinnowplease", "alias": "test-arget", "iqn": "iqn.1986-03.com.sun:02:31d26d2e-6aa0-6054-fe58-8b1fb508b008", "targetchapuser": "argus", "interfaces": ["ixgbe0"] } }
시스템에서 SAN 대상을 제거합니다.
요청 예:
DELETE /api/san/v1/iscsi/targets/iqn.1986-03.com.sun:02:e7e688b1 HTTP/1.1 Host: zfs-storage.example.com:215 Authorization: Basic abcd123MWE=
성공한 삭제는 다음과 같이 HTTP 코드 204(No Content)를 반환합니다.
HTTP/1.1 204 No-Content