ModifyVolume(수정 볼륨)
변경 제안
PDF
ModifyVolume(수정 볼륨) 방법을 사용하여 기존 볼륨의 설정을 수정할 수 있습니다. 한 번에 하나의 볼륨을 수정할 수 있으며 변경 사항이 즉시 적용됩니다.
볼륨을 수정할 때 QoS 값을 지정하지 않으면 수정 이전과 동일하게 유지됩니다. GetDefaultQoS 메서드를 실행하여 새로 생성된 볼륨의 기본 QoS 값을 검색할 수 있습니다.
복제 중인 볼륨의 크기를 늘려야 하는 경우 복제 오류를 방지하기 위해 다음 순서로 크기를 늘리십시오.
-
ReplicationTarget 액세스를 사용하여 볼륨의 크기를 늘립니다.
-
ReadWrite 액세스를 사용하여 소스 또는 볼륨의 크기를 늘립니다.
타겟 볼륨과 소스 볼륨의 크기가 동일한지 확인합니다.
|
액세스 상태를 잠금 또는 복제 대상으로 변경하면 기존의 모든 iSCSI 연결이 종료됩니다. |
매개 변수
이 메서드에는 다음과 같은 입력 매개 변수가 있습니다.
| 이름 | 설명 | 유형 | 기본값 | 필수 요소입니다 |
|---|---|---|---|---|
볼륨 ID |
수정할 볼륨의 볼륨 ID입니다. |
정수 |
없음 |
예 |
액세스 |
볼륨에 대한 액세스가 허용됩니다. 가능한 값:
|
문자열 |
없음 |
아니요 |
계정 ID입니다 |
볼륨이 재할당된 계정 ID입니다. 지정하지 않으면 이전 계정 이름이 사용됩니다. |
정수 |
없음 |
아니요 |
associateWithQoSPolicy를 참조하십시오 |
볼륨을 지정된 QoS 정책에 연결합니다. 가능한 값:
|
부울 |
없음 |
아니요 |
속성 |
JSON 개체 형식의 이름-값 쌍 목록입니다. |
JSON 개체 |
없음 |
아니요 |
createTime(createTime) |
새 볼륨 생성 날짜로 설정할 ISO 8601 날짜 문자열. setCreateTime 이 true 로 설정된 경우 필요합니다. |
ISO 8601 문자열 |
없음 |
아니요 |
enableSnapMirrorReplication |
SnapMirror 엔드포인트에서 복제를 위해 볼륨을 사용할 수 있는지 여부를 결정합니다. 가능한 값:
|
부울 |
거짓 |
아니요 |
50 크기 |
볼륨이 지원하는 FIFO(First In First Out) 스냅샷의 최대 수를 지정합니다. FIFO 및 FIFO 외 스냅샷은 모두 볼륨에서 사용 가능한 스냅샷 슬롯의 동일한 풀을 사용합니다. 이 옵션을 사용하여 사용 가능한 스냅샷 슬롯의 FIFO 스냅샷 소비를 제한할 수 있습니다. 이 값은 현재 FIFO 스냅샷 수보다 적게 수정할 수 없습니다. |
정수 |
없음 |
아니요 |
미니 크기 |
FIFO(First-In-First-Out) 스냅샷에만 예약된 스냅샷 슬롯의 수를 지정합니다. FIFO 및 FIFO 이외 스냅숏은 동일한 풀을 공유하기 때문에 min다섯포크기 매개변수는 FIFO가 아닌 스냅숏의 총 수를 같은 양으로 줄입니다. 이 값은 현재 FIFO 스냅샷 수와 충돌하도록 수정할 수 없습니다. |
정수 |
없음 |
아니요 |
모드를 선택합니다 |
볼륨 복제 모드입니다. 가능한 값:
|
문자열 |
없음 |
아니요 |
QoS를 참조하십시오 |
이 볼륨에 대한 새로운 서비스 품질 설정. 지정하지 않으면 QoS 설정이 변경되지 않습니다. 가능한 값:
|
없음 |
아니요 |
|
qosPolicyID입니다 |
QoS 설정을 지정된 볼륨에 적용해야 하는 정책의 ID입니다. 이 매개 변수는 QoS 매개 변수와 함께 사용할 수 없습니다. |
정수 |
없음 |
아니요 |
setCreateTime(설정 생성 시간) |
기록된 볼륨 생성 날짜를 변경하려면 true로 설정합니다. |
부울 |
없음 |
아니요 |
총 크기 |
볼륨의 새 크기(바이트)입니다. 1000000000은 1GB입니다. 크기는 가장 가까운 메가바이트 크기로 반올림됩니다. 이 매개 변수는 볼륨의 크기를 늘리는 데만 사용할 수 있습니다. |
정수 |
없음 |
아니요 |
반환 값
이 메서드의 반환 값은 다음과 같습니다.
이름 |
설명 |
유형 |
볼륨 |
새로 수정된 볼륨에 대한 정보가 포함된 개체입니다. |
요청 예
이 메서드에 대한 요청은 다음 예제와 비슷합니다.
{
"method": "ModifyVolume",
"params": {
"volumeID": 5,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"qos": {
"minIOPS": 60,
"maxIOPS": 100,
"burstIOPS": 150,
"burstTime": 60
},
"access" :"readWrite"
},
"totalSize": 20000000000,
"id": 1
}
응답 예
이 메서드는 다음 예제와 유사한 응답을 반환합니다.
{
"id": 1,
"result": {
"volume": {
"access": "readWrite",
"accountID": 1,
"attributes": {
"name1": "value1",
"name2": "value2",
"name3": "value3"
},
"blockSize": 4096,
"createTime": "2016-03-28T16:16:13Z",
"deleteTime": "",
"enable512e": true,
"iqn": "iqn.2010-01.com.solidfire:jyay.1459181777648.5",
"name": "1459181777648",
"purgeTime": "",
"qos": {
"burstIOPS": 150,
"burstTime": 60,
"curve": {
"4096": 100,
"8192": 160,
"16384": 270,
"32768": 500,
"65536": 1000,
"131072": 1950,
"262144": 3900,
"524288": 7600,
"1048576": 15000
},
"maxIOPS": 100,
"minIOPS": 60
},
"scsiEUIDeviceID": "6a79617900000005f47acc0100000000",
"scsiNAADeviceID": "6f47acc1000000006a79617900000005",
"sliceCount": 1,
"status": "active",
"totalSize": 1000341504,
"virtualVolumeID": null,
"volumeAccessGroups": [
1
],
"volumeID": 5,
"volumePairs": []
}
}
}
버전 이후 새로운 기능
9.6