본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

ModifyVolume(수정 볼륨)

기여자

ModifyVolume(수정 볼륨) 방법을 사용하여 기존 볼륨의 설정을 수정할 수 있습니다. 한 번에 하나의 볼륨을 수정할 수 있으며 변경 사항이 즉시 적용됩니다.

볼륨을 수정할 때 QoS 값을 지정하지 않으면 수정 이전과 동일하게 유지됩니다. GetDefaultQoS 메서드를 실행하여 새로 생성된 볼륨의 기본 QoS 값을 검색할 수 있습니다.

복제 중인 볼륨의 크기를 늘려야 하는 경우 복제 오류를 방지하기 위해 다음 순서로 크기를 늘리십시오.

  1. ReplicationTarget 액세스를 사용하여 볼륨의 크기를 늘립니다.

  2. ReadWrite 액세스를 사용하여 소스 또는 볼륨의 크기를 늘립니다.

타겟 볼륨과 소스 볼륨의 크기가 동일한지 확인합니다.

참고 액세스 상태를 잠금 또는 복제 대상으로 변경하면 기존의 모든 iSCSI 연결이 종료됩니다.

매개 변수

이 메서드에는 다음과 같은 입력 매개 변수가 있습니다.

이름 설명 유형 기본값 필수 요소입니다

볼륨 ID

수정할 볼륨의 볼륨 ID입니다.

정수

없음

액세스

볼륨에 대한 액세스가 허용됩니다. 가능한 값:

  • "읽기 전용": 읽기 작업만 허용됩니다.

  • 다시 쓰기: 읽기와 쓰기가 허용됩니다.

  • 잠금: 읽기 또는 쓰기가 허용되지 않습니다. 지정하지 않으면 액세스 값이 변경되지 않습니다.

  • replicationTarget: 볼륨을 페어링된 볼륨 세트의 타겟 볼륨으로 식별합니다. 볼륨이 페어링되지 않은 경우 액세스 상태가 잠깁니다. 값을 지정하지 않으면 액세스 값이 변경되지 않습니다.

  • 'SnapMirror 타겟': SnapMirror 복제의 타겟 볼륨으로 볼륨을 식별합니다.

문자열

없음

아니요

계정 ID입니다

볼륨이 재할당된 계정 ID입니다. 지정하지 않으면 이전 계정 이름이 사용됩니다.

정수

없음

아니요

associateWithQoSPolicy를 참조하십시오

볼륨을 지정된 QoS 정책에 연결합니다. 가능한 값:

  • "true": QoSPolicyID 매개 변수에 지정된 QoS 정책과 볼륨을 연결합니다.

  • "false": QoSPolicyID 매개 변수에 지정된 QoS 정책과 볼륨을 연결하지 마십시오. false 이면 QoSPolicy 매개 변수에 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 스냅샷 수와 충돌하도록 수정할 수 없습니다.

정수

없음

아니요

모드를 선택합니다

볼륨 복제 모드입니다. 가능한 값:

  • asynch: 데이터가 소스에 저장되었음을 시스템이 인지할 때까지 기다린 후 대상에 씁니다.

  • '동기화': 소스의 데이터 전송 확인 메시지가 타겟에 데이터를 쓰기 시작하는 것을 기다리지 않습니다.

문자열

없음

아니요

QoS를 참조하십시오

이 볼륨에 대한 새로운 서비스 품질 설정. 지정하지 않으면 QoS 설정이 변경되지 않습니다. 가능한 값:

  • minIOPS

  • 'maxIOPS’입니다

  • 버스트IOPS

없음

아니요

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

자세한 내용을 확인하십시오