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 문자열 |
없음 |
아니요 |
dontMoveforIops재조정 을 참조하십시오 |
실제 IOPS를 통한 로드 밸런싱 시 볼륨 이동을 방지합니다. 이 설정은 Element 12.8부터 사용할 수 있으며 가 활성화된 경우에만 "VolumeLoadBalanceOnActualIOPS"적용됩니다. 가능한 값:
|
부울 |
거짓 |
아니요 |
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": 319,
"access": "readWrite",
"dontMoveForIopsRebalance": false
},
"id": 1
}
응답 예
이 메서드는 다음 예제와 유사한 응답을 반환합니다.
{
"id": 1,
"result": {
"volume": {
"access": "readWrite",
"accountID":22,
"attributes": {},
"blockSize": 4096,
"createTime": "2024-04-01T19:39:40Z",
"currentProtectionScheme": "doubleHelix",
"deleteTime": "",
"dontMoveForIopsRebalance": false,
"enable512e": false,
"enableSnapMirrorReplication": false,
"fifoSize": 24,
"iqn": "iqn.2010-01.com.solidfire:3eeu.suite40.319",
"lastAccessTime": "2024-04-02T12:41:34Z",
"lastAccessTimeIO": "2024-04-01T20:41:19Z",
"minFifoSize": 0,
"name": "suite40",
"previousProtectionScheme": null,
"purgeTime": "",
"qos": {
"burstIOPS": 27000,
"burstTime": 60,
"curve": {
"1048576": 15000,
"131072": 1950,
"16384": 270,
"262144": 3900,
"32768": 500, "4096": 100,
"524288": 7600,
"65536": 1000,
"8192": 160
},
"maxIOPS": 27000,
"minIOPS": 500
},
"qosPolicyID": null,
"scsiEUIDeviceID": "336565750000013ff47acc0100000000",
"scsiNAADeviceID": "6f47acc100000000336565750000013f",
"sliceCount": 1,
"status": "active",
"totalSize": 1000000716800,
"virtualVolumeID": null,
"volumeAccessGroups": [
22
],
"volumeConsistencyGroupUUID": "3003109e-6e75-444c-8cee-470d641a09c3",
"volumeID": 319,
"volumePairs": [],
"volumeUUID": "78203136-b0eb-454b-9f67-2c867ec7d7bb"
}
}
}
버전 이후 새로운 기능
9.6