다음 명령은 SAN 개시자를 관리하는 데 사용됩니다.
|
이러한 명령은 다음 URI 매개변수를 사용합니다.
|
개시자 명령 중 상당수가 아래에 나열된 등록 정보를 반환 값으로 사용합니다. 만들기 및 수정 명령도 해당 등록 정보를 입력 값으로 사용합니다.
|
지정된 프로토콜 유형의 어플라이언스에 대해 구성된 모든 개시자를 나열합니다. 응답 본문은 이름이 "initiators"인 개시자 등록 정보의 배열(JSON 형식)을 포함합니다.
iSCSI 개시자를 나열하는 요청의 예:
GET /api/san/v1/iscsi/initiators HTTP/1.1 Host: zfs-storage.example.com Accept: application/json
응답 예:
HTTP/1.1 200 OK
Content-Type: application/json
{
"initiators": [{
"alias": "init-02",
"href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02",
"initiator": "iqn.1986-03.com.sun:02:02",
"chapsecret": "",
"chapuser": ""
},{
"alias": "init-01",
"initiator": "iqn.1986-03.com.sun:02:01",
"href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01",
"chapsecret": "",
"chapuser": ""
}]
}
단일 iSCSI 개시자의 세부정보를 나열합니다. 응답 본문은 iSCSI 개시자 등록 정보를 이름이 "initiator"인 객체(JSON 형식)로 포함합니다.
요청 예:
GET /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01 HTTP/1.1 Host: zfs-storage.example.com Accept: application/json
응답 예:
HTTP/1.1 200 OK
Content-Type: application/json
{
"initiator": {
"alias": "init-01",
"href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:01"
"initiator": "iqn.1986-03.com.sun:02:01",
"chapsecret": "",
"chapuser": ""
}
}
새 iSCSI 개시자를 만듭니다. IQN(iSCSI Qualified Name)을 제공해야 합니다. 요청 본문은 iSCSI 개시자 등록 정보(JSON 형식)를 포함합니다. 응답은 성공 시 HTTP 헤더 및 상태 코드 201(Created)의 새 iSCSI 개시자의 위치 URI를 포함합니다. 응답 본문은 iSCSI 개시자 등록 정보를 이름이 "initiator"인 객체(JSON 형식)로 포함합니다.
요청 예:
POST /api/san/v1.0/iscsi/initiators HTTP/1.1
Host: zfs-storage.example.com
Content-Type: application/json
Accept: application/json
{
"initiator": "iqn.1986-03.com.sun:02:02",
"alias":"init-02"
}
응답 예:
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 181
X-Zfssa-San-Api: 1.0
Location: /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02
{
"initiator": {
"alias": "init-02",
"href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:02:02",
"initiator": "iqn.1986-03.com.sun:02:02",
"chapsecret": "",
"chapuser": ""
}
}
이 명령은 기존 개시자를 수정합니다. 요청 본문은 JSON 형식으로 수정되어야 할 개시자 등록 정보를 포함합니다. 개시자에 대한 IQN은 URI에 제공됩니다. 성공 시 HTTP 상태 202(Accepted)가 반환됩니다. 응답 본문은 새 iSCSI 개시자 등록 정보를 이름이 "initiator"인 객체(JSON 형식)로 포함합니다.
요청 예:
PUT /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01 /HTTP/1.1
Host: zfs-storage.example.com
Content-Type: application/json
Accept: application/json
{
"alias":"init-01-secure",
"chapuser":"chuck",
"chapsecret":"igottheintersect"
}
응답 예:
HTTP/1.1 202 Accepted
Content-Length: 167
Content-Type: application/json
X-Zfs-Sa-Nas-Api: 1.0
{
"initiator": {
"alias": "init-01-secure",
"href": "/api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01",
"iqn": "iqn.1986-03.com.sun:1",
"chapsecret": "igottheintersect",
"chapuser": "chuck"
}
}
어플라이언스에서 개시자를 제거합니다.
요청 예:
DELETE /api/san/v1/iscsi/initiators/iqn.1986-03.com.sun:01 HTTP/1.1 Host: zfs-storage.example.com:215
성공한 삭제는 다음과 같이 HTTP 코드 204(No Content)를 반환합니다.
HTTP/1.1 204 No-Content