SAN 개시자

다음 명령은 SAN 개시자를 관리하는 데 사용됩니다.

표 47  개시자 명령

요청 경로 /san/v1.0 설명 GET /<protocol>/initiators 지정된 프로토콜(FC, iSCSI, SRP) 객체에 대한 모든 SAN 개시자를 나열합니다. GET /<protocol>/initiators /<initiator> 지정된 프로토콜(FC, iSCSI, SRP) 등록 정보에 대한 지정된 SAN 개시자를 가져옵니다. POST /<protocol>/initiators 지정된 프로토콜(FC, iSCSI, SRP)에 대한 새 SAN 개시자를 만듭니다. PUT /<protocol>/initiators /<initiator> 지정된 프로토콜(FC, iSCSI, SRP) 객체에 대한 지정된 SAN 개시자를 수정합니다. DELETE /<protocol>/initiators /<initiator> 지정된 개시자 객체를 삭제합니다.

이러한 명령은 다음 URI 매개변수를 사용합니다.

표 48  URI 매개변수

이름 설명 protocol 개시자(FC, iSCSI, SRP)에 대한 NAS 프로토콜 개시자 개시자의 iqn, wwn 또는 eui

개시자 명령 중 상당수가 아래에 나열된 등록 정보를 반환 값으로 사용합니다. 만들기 및 수정 명령도 해당 등록 정보를 입력 값으로 사용합니다.

표 49  개시자 등록 정보

이름 프로토콜 설명 alias all 이 개시자에 대한 별칭 개시자 fc 이 개시자에 대한 포트 WWN(World Wide Name) iqn iscsi 이 개시자에 대한 iSCSI 정규화된 이름 chapuser iscsi CHAP(Challenge Handshake Authentication Protocol) 사용자 이름 chapsecret iscsi CHAP(Challenge Handshake Authentication Protocol) 암호 개시자 srp EUI(Extended Unique Identifier)

개시자 나열

지정된 프로토콜 유형의 어플라이언스에 대해 구성된 모든 개시자를 나열합니다. 응답 본문은 이름이 "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