VPC 환경에서 이용 가능합니다.
블록 스토리지 스냅샷 인스턴스를 생성합니다.
구문
createBlockStorageSnapshotInstance 구문은 다음과 같습니다.
./ncloud vserver createBlockStorageSnapshotInstance \
--originalBlockStorageInstanceNo <original-block-storage-instance-no> \
[--blockStorageSnapshotName <block-storage-snapshot-name>] \
[--blockStorageSnapshotDescription <block-storage-snapshot-description>] \
[--snapshotTypeCode <FULL|INCREMENTAL>] \
[--regionCode <KR|SGN|JPN>] \
[--output <json|xml>]
옵션
createBlockStorageSnapshotInstance 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createBlockStorageSnapshotInstance의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--originalBlockStorageInstanceNo |
String | Required | 원본 스토리지 인스턴스 번호 |
선택 옵션
createBlockStorageSnapshotInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--blockStorageSnapshotName |
String | Optional | 스냅샷 이름
|
--blockStorageSnapshotDescription |
String | Optional | 스냅샷 설명 (Byte)
|
--snapshotTypeCode |
String | Optional | 스냅샷 유형 코드
|
공통 옵션
vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server (VPC) 옵션을 참조해 주십시오.
예시
블록 스토리지 스냅샷 인스턴스 생성 요청이 성공하면 생성된 스냅샷의 식별 및 구성 정보가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vserver createBlockStorageSnapshotInstance \
--originalBlockStorageInstanceNo 89012345 \
--blockStorageSnapshotName test-snapshot-01 \
--blockStorageSnapshotDescription "Test snapshot" \
--snapshotTypeCode FULL \
--regionCode KR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"createBlockStorageSnapshotInstanceResponse": {
"totalRows": 1,
"blockStorageSnapshotInstanceList": [
{
"blockStorageSnapshotInstanceNo": "90123456",
"blockStorageSnapshotName": "test-snapshot-01",
"blockStorageSnapshotVolumeSize": 10737418240,
"originalBlockStorageInstanceNo": "89012345",
"blockStorageSnapshotInstanceStatus": {
"code": "INIT",
"codeName": "블록스토리지 INIT 상태"
},
"blockStorageSnapshotInstanceOperation": {
"code": "CREAT",
"codeName": "블록스토리지 CREAT OP"
},
"blockStorageSnapshotInstanceStatusName": "creating",
"createDate": "2026-05-14T20:40:11+0900",
"isEncryptedOriginalBlockStorageVolume": false,
"blockStorageSnapshotDescription": "Test snapshot",
"snapshotType": {
"code": "FULL",
"codeName": "Full Storage Snapshot"
},
"snapshotChainDepth": 0,
"isBootable": true,
"hypervisorType": {
"code": "KVM",
"codeName": "KVM"
},
"blockStorageVolumeType": {
"code": "CB1",
"codeName": "Common BlockStorage 1"
}
}
],
"requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"returnCode": "0",
"returnMessage": "success"
}
}