---
title: "createServerImage"
slug: "createserverimage"
updated: 2026-09-17T10:11:00Z
published: 2026-09-17T10:11:00Z
canonical: "cli.ncloud-docs.com/createserverimage"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createServerImage

VPC環境で利用できます。

マイサーバイメージを作成します。

## 構文

`createServerImage`構文は次の通りです。

```
./ncloud vserver createServerImage \
    --serverInstanceNo <server-instance-no> \
    --serverImageName <server-image-name> \
    [--blockStorageList <block-storage-config>] \
    [--serverImageDescription <description>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## オプション

`createServerImage`の実行時に指定できるオプションについて説明します。

### 必須オプション

`createServerImage`の必須オプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--serverInstanceNo` | String | Required | 元のサーバのインスタンス番号 - [getServerInstanceList](/docs/ja/cli-vserver-server-getserverinstancelist)を参照 |
| `--serverImageName` | String | Required | サーバイメージ名 - 英数字、記号の`-`、`_`を組み合わせて3~30文字以内で入力 - 文字列の先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 |

### 任意オプション

`createServerImage`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--blockStorageList` | List | Optional | サーバイメージに追加するブロックストレージリスト - 各ストレージは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 - `order` (必須): ストレージの順番。`1`~`20`. 基本ストレージ(`order=0`)は元のサーバに自動割り当てられ、最大20個まで追加可能 (基本ストレージを含めて最大21個) - `snapshotInstanceNo` (条件付き): ストレージスナップショットインスタンス番号。既存のスナップショットに追加ストレージを割り当てる際に必ず入力。`snapshotInstanceNo`または`blockStorageVolumeTypeCode`のいずれかは必ず入力。[getBlockStorageSnapshotInstanceList](/docs/ja/cli-vserver-snapshot-getblockstoragesnapshotinstancelist)を参照 - `blockStorageSize` (条件付き): ストレージ容量 (GB)。新規ストレージの追加時、必ず入力。`snapshotInstanceNo`の使用時、既存のスナップショットサイズ以上に設定。ストレージのタイプごとの制限事項は、[ストレージスペック](https://guide.ncloud-docs.com/docs/ja/server-spec-vpc#%EC%8A%A4%ED%86%A0%EB%A6%AC%EC%A7%80-%EC%82%AC%EC%96%91)を参照 - `blockStorageVolumeTypeCode` (条件付き): ストレージタイプ。`CB1` \| `CB2` \| `FB1` \| `FB2`. 新規ストレージの追加時、必ず入力。既存のスナップショットの使用時、タイプを変更可能。`snapshotInstanceNo`または`blockStorageVolumeTypeCode`のいずれかは必ず入力。 - `noBlockStorage` (条件付き): ストレージを除外するか。`true` (除外) \| `false` (除外しない、`snapshotInstanceNo`は必ず入力) - `emptyBlockStorage` (条件付き): 新規ストレージを作成するか。`true` (作成) \| `false` (作成しない、`snapshotInstanceNo`は必ず入力) - KVMのみ使用可能 - 入力がない場合、サーバのすべてのブロックストレージを含めて、マイサーバイメージを作成 |
| `--serverImageDescription` | String | Optional | サーバイメージの説明(Byte) - 0~1,000 |

### 共通オプション

`vserver`コマンドで共通して使用するオプションについては、[Server (VPC)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)をご参照ください。

## 例

サーバイメージの作成リクエストが成功すると、サーバイメージの識別情報と初期状態が返されます。

### コマンド

コマンドの例は次の通りです。

```
./ncloud vserver createServerImage \
    --serverInstanceNo 34567890 \
    --serverImageName test-server-image-01 \
    --serverImageDescription "Test server image" \
    --regionCode KR \
    --output json
```

### 出力

出力の例は次の通りです。

```
{
  "createServerImageResponse": {
    "totalRows": 1,
    "serverImageList": [
      {
        "serverImageNo": "45678901",
        "serverImageName": "test-server-image-01",
        "serverImageDescription": "Test server image",
        "serverImageType": {
          "code": "SELF",
          "codeName": "SELFサーバイメージ"
        },
        "serverImageLifeCyclePhase": {
          "code": "IN_SERVICE",
          "codeName": "In Service"
        },
        "hypervisorType": {
          "code": "KVM",
          "codeName": "KVM"
        },
        "cpuArchitectureType": {
          "code": "X86_64",
          "codeName": "x86 64bit"
        },
        "osCategoryType": {
          "code": "LINUX",
          "codeName": "LINUX"
        },
        "osType": {
          "code": "NAVIX",
          "codeName": "NAVIX"
        },
        "serverImageStatus": {
          "code": "INIT",
          "codeName": "NSI INIT state"
        },
        "serverImageOperation": {
          "code": "CREAT",
          "codeName": "NSI CREAT OP"
        },
        "serverImageStatusName": "creating",
        "shareStatus": {
          "code": "NULL",
          "codeName": "NSI Share NULL State"
        },
        "blockStorageMappingList": [
          {
            "order": 0,
            "blockStorageSnapshotInstanceNo": 90123456,
            "blockStorageSnapshotName": "n01234567890abcd",
            "blockStorageSize": 10737418240,
            "blockStorageVolumeType": {
              "code": "CB1",
              "codeName": "Common BlockStorage 1"
            },
            "iops": 100,
            "throughput": 104857600,
            "isEncryptedVolume": false
          }
        ],
        "sharedLoginIdList": [],
        "serverImageProductCode": "SW.VSVR.OS.LNX64.NAVIX.09.G003",
        "createDate": "2026-05-14T16:25:00+0900",
        "platformCategoryCode": "OS"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```