Go to main content
Oracle® ZFS Storage Appliance RESTful API 설명서, 릴리스 OS8.6.x

인쇄 보기 종료

업데이트 날짜: 2016년 9월
 
 

개시자 그룹

iSCSI 개시자 명령은 어플라이언스에서 iSCSI 개시자 및 iSCSI 개시자 그룹을 관리하는 데 사용됩니다. 사용 가능한 명령은 아래 표에 나열되어 있습니다.

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

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

표 51  URI 매개변수
이름
설명
protocol
개시자(FC, iSCSI, SRP)에 대한 NAS 프로토콜
name
개시자 그룹의 이름입니다.

각 개시자 그룹은 개시자 그룹의 개시자 목록을 포함하는 "name" 등록 정보 및 "initiators" 등록 정보를 포함합니다.

개시자 그룹 나열

사용 가능한 모든 iSCSI 개시자 그룹을 나열합니다. 성공 시 HTTP 상태 200(OK)이 반환되고 본문은 개시자 그룹 객체 배열을 포함하는 이름이 "groups"인 등록 정보가 있는 JSON 객체를 포함합니다.

요청 예:

GET /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

응답 예:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "groups": [{
        "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-0",
        "initiators": ["iqn.1986-03.com.sun:0"],
        "name": "aktest-initiators-0"
    }, {
        "href": "/san/v1/iscsi/initiator-groups/aktest-initiators-1",
        "initiators": ["iqn.1986-03.com.sun:1"],
        "name": "aktest-initiators-1"
    }]
}

개시자 그룹 세부정보 가져오기

단일 iSCSI 개시자 그룹에서 세부정보를 가져옵니다. 개시자 그룹 나열 명령에서 반환된 href 등록 정보를 따라가면 이 그룹에 액세스할 수 있습니다.

요청 예:

GET /api/san/v1/iscsi/initiator-groups/test-group HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

응답 예:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group"
        "initiators": ["iqn.1986-03.com.sun:02:01"],
        "name": "test-group"
    }
}

개시자 그룹 만들기

구성원 없이 iSCSI 개시자 그룹을 만듭니다. 요청 본문은 그룹 이름을 포함하는 단일 "name" 매개변수가 있는 JSON 객체를 포함합니다.

표 52  개시자 그룹 만들기 등록 정보
등록 정보
유형
설명
name
string
개시자 그룹의 이름
initiators
array
기존 개시자 IQN 등록 정보의 배열

요청 예:

POST /api/san/v1/iscsi/initiator-groups HTTP/1.1
Host: zfs-storage.example.com
Content-Type: application/json
Content-Length: 64
Accept: application/json

{
   "name":"group-01",
   "initiators": ["iqn.1986-03.com.sun:02"]
}

응답 예:

HTTP/1.1 201 Created
Content-Type: application/json
Location: /api/san/v1/iscsi/initiator-groups/test-group

{
    "group": {
        "href": "/api/san/v1/iscsi/initiator-groups/test-group",
        "initiators": ["iqn.1986-03.com.sun:02"],
        "name": "group-01"
    }
}

개시자 그룹 삭제

어플라이언스에서 개시자 그룹을 제거합니다.

요청 예:

DELETE /api/san/v1.0/iscsi/initiator-groups/group-01 HTTP/1.1
Host: zfs-storage.example.com:215

성공한 삭제는 HTTP 상태 204(No Content)를 반환합니다.

HTTP/1.1 204 No-Content