changeBlockStorageVolumeSize

Prev Next

VPC 환경에서 이용 가능합니다.

블록 스토리지 볼륨 크기를 변경합니다. 서버에 할당되어 있는 블록 스토리지의 경우에는 서버 인스턴스가 정지 상태에서만 변경이 가능합니다.

구문

changeBlockStorageInstance 구문은 다음과 같습니다.

./ncloud vserver changeBlockStorageInstance \
    --blockStorageInstanceNo <block-storage-instance-no> \
    --blockStorageSize <block-storage-size> \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

changeBlockStorageInstance 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

changeBlockStorageInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--blockStorageInstanceNo String Required 블록 스토리지 인스턴스 번호
--blockStorageSize Integer Required 블록 스토리지 크기 (GB)
  • XEN: 10~2000
  • KVM: 10~16380
  • 10GB 단위 입력
  • 기존 크기 이상으로만 변경 가능
  • 변경 결과는 서버에서 파일 스토리지 크기 확장 후 적용
  • 스토리지 크기 확장 참조

공통 옵션

vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server (VPC) 옵션을 참조해 주십시오.

예시

블록 스토리지 볼륨 크기 변경 요청이 성공하면 식별 정보와 변경된 구성 및 상태 정보가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vserver changeBlockStorageInstance \
    --blockStorageInstanceNo 89012345 \
    --blockStorageSize 60 \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "changeBlockStorageInstanceResponse": {
    "totalRows": 1,
    "blockStorageInstanceList": [
      {
        "blockStorageInstanceNo": "89012345",
        "blockStorageName": "test-block-storage-01",
        "blockStorageType": {
          "code": "SVRBS",
          "codeName": "서버 BS"
        },
        "blockStorageSize": 64424509440,
        "blockStorageProductCode": "SPBSTBSTAD000006",
        "blockStorageInstanceStatus": {
          "code": "CREAT",
          "codeName": "블록스토리지 CREATED 상태"
        },
        "blockStorageInstanceOperation": {
          "code": "CHNG",
          "codeName": "블록스토리지 RESIZE OP"
        },
        "blockStorageInstanceStatusName": "changingSpec",
        "createDate": "2026-06-08T11:33:38+0900",
        "blockStorageDescription": "Test block storage",
        "blockStorageDiskType": {
          "code": "NET",
          "codeName": "네트웍 스토리지"
        },
        "blockStorageDiskDetailType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "maxIopsThroughput": 4000,
        "isEncryptedVolume": false,
        "zoneCode": "KR-1",
        "regionCode": "KR",
        "isReturnProtection": false,
        "blockStorageVolumeType": {
          "code": "SSD",
          "codeName": "SSD"
        },
        "hypervisorType": {
          "code": "XEN",
          "codeName": "XEN"
        }
      }
    ],
    "requestId": "337e7350-5cf1-4af2-a736-8327ab5bea0d",
    "returnCode": "0",
    "returnMessage": "success"
  }
}