CreateVolume(생성 볼륨)
변경 제안
PDF
"CreateVolume" 방법을 사용하여 클러스터에 빈 새 볼륨을 생성할 수 있습니다. 볼륨이 생성되는 즉시 iSCSI를 통해 볼륨을 연결할 수 있습니다.
지정된 QoS 값 없이 생성된 볼륨은 기본값을 사용합니다. 'GetDefaultQoS' 메서드를 사용하여 볼륨의 기본값을 볼 수 있습니다.
매개 변수
이 메서드에는 다음과 같은 입력 매개 변수가 있습니다.
| 이름 | 설명 | 유형 | 기본값 | 필수 요소입니다 |
|---|---|---|---|---|
"접근" |
볼륨에 대한 액세스 모드입니다. 이 매개 변수가 포함되면 지원되는 유일한 값은 'napMirrorTarget'입니다. |
문자열 |
없음 |
아니요 |
계정 ID |
이 볼륨을 소유한 계정의 ID입니다. |
정수 |
없음 |
예 |
'associateWithQoSPolicy' |
볼륨을 지정된 QoS 정책에 연결합니다. 가능한 값:
|
부울 |
참 |
아니요 |
'속성' |
JSON 개체 형식의 이름-값 쌍 목록입니다. JSON 형식 문자를 포함하여 총 속성 크기는 1000B 또는 1KB 미만이어야 합니다. |
JSON 개체 |
없음 |
아니요 |
enable512e |
512바이트 섹터 에뮬레이션을 활성화합니다. 가능한 값:
|
부울 |
없음 |
예 |
"enableSnapMirrorReplication"을 참조하십시오 |
SnapMirror 엔드포인트에서 복제를 위해 볼륨을 사용할 수 있는지 여부를 결정합니다. 가능한 값:
|
부울 |
거짓 |
아니요 |
'fifoSize'입니다 |
볼륨이 지원하는 FIFO(First In First Out) 스냅샷의 최대 수를 지정합니다. FIFO 및 FIFO 외 스냅샷은 모두 볼륨에서 사용 가능한 스냅샷 슬롯의 동일한 풀을 사용합니다. 이 옵션을 사용하여 사용 가능한 스냅샷 슬롯의 FIFO 스냅샷 소비를 제한할 수 있습니다. 이 인수를 생략하면 기본적으로 24가 사용됩니다. |
정수 |
24 |
아니요 |
'민차피오사이즈' |
볼륨이 예약한 FIFO(First In First Out) 스냅샷 슬롯의 최소 수를 지정합니다. 이렇게 하면 FIFO 스냅샷이 아닌 볼륨에서 FIFO 스냅샷과 FIFO 외 스냅샷을 모두 사용할 경우 FIFO 슬롯이 너무 많이 사용되지 않습니다. 또한 적어도 여러 FIFO 스냅샷을 항상 사용할 수 있도록 합니다. FIFO와 FIFO 이외 스냅샷은 동일한 풀을 공유하기 때문에, 'min다섯obsize'는 FIFO가 아닌 스냅샷의 총 수를 동일한 양으로 줄입니다. 이 인수를 생략하면 기본적으로 0이 됩니다. |
정수 |
0 |
아니요 |
이름 |
볼륨 액세스 그룹의 이름입니다(사용자가 지정할 수 있음). 고유하지 않아도 되지만 권장됨. 길이는 1-64자여야 합니다. |
문자열 |
없음 |
예 |
QoS |
이 볼륨에 대한 초기 서비스 품질 설정. 기본값이 지정되지 않은 경우 사용됩니다. 가능한 값:
|
QoS 개체 |
없음 |
아니요 |
"qosPolicyID"입니다 |
QoS 설정을 지정된 볼륨에 적용해야 하는 정책의 ID입니다. QoS 파라미터와 함께 사용할 수 없는 파라미터이다. |
정수 |
없음 |
아니요 |
"TotalSize"입니다 |
볼륨의 총 크기(바이트)입니다. 크기는 가장 가까운 메가바이트 단위로 반올림됩니다. |
정수 |
없음 |
예 |
반환 값
이 메서드의 반환 값은 다음과 같습니다.
이름 |
설명 |
유형 |
볼륨 |
새로 생성된 볼륨에 대한 정보가 포함된 객체입니다. |
|
볼륨 ID |
새로 생성된 볼륨의 볼륨 ID입니다. |
정수 |
곡선 |
곡선은 키 값 쌍의 집합입니다. 키는 입출력 크기(바이트)입니다. 이 값은 특정 입출력 크기에서 IOP를 수행하는 비용을 나타냅니다. 곡선은 100 IOPS로 설정된 4096바이트 작업을 기준으로 계산됩니다. |
JSON 개체 |
요청 예
이 메서드에 대한 요청은 다음 예제와 비슷합니다.
{
"method": "CreateVolume",
"params": {
"name": "mysqldata",
"accountID": 1,
"totalSize": 107374182400,
"enable512e": false,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"qos": {
"minIOPS": 50,
"maxIOPS": 500,
"burstIOPS": 1500,
"burstTime": 60
}
},
"id": 1
}
응답 예
이 메서드는 다음 예제와 유사한 응답을 반환합니다.
{
"id": 1,
"result": {
"curve": {
"4096": 100,
"8192": 160,
"16384": 270,
"32768": 500,
"65536": 1000,
"131072": 1950,
"262144": 3900,
"524288": 7600,
"1048576": 15000
},
"volume": {
"access": "readWrite",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-03-31T22:20:22Z",
"deleteTime": "",
"enable512e": false,
"iqn": "iqn.2010-01.com.solidfire:mysqldata.677",
"name": "mysqldata",
"purgeTime": "",
"qos": {
"burstIOPS": 1500,
"burstTime": 60,
"curve": {
"4096": 100,
"8192": 160,
"16384": 270,
"32768": 500,
"65536": 1000,
"131072": 1950,
"262144": 3900,
"524288": 7600,
"1048576": 15000
},
"maxIOPS": 500,
"minIOPS": 50
},
"scsiEUIDeviceID": "6a796179000002a5f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a796179000002a5",
"sliceCount": 0,
"status": "active",
"totalSize": 107374182400,
"virtualVolumeID": null,
"volumeAccessGroups": [],
"volumeID": 677,
"volumePairs": []
},
"volumeID": 677
}
}
버전 이후 새로운 기능
9.6