createNasVolumeInstance

VPC環境で利用できます。

NASボリュームインスタンスを作成します。

構文

createNasVolumeInstance構文は次の通りです。

./ncloud vnas createNasVolumeInstance \
    --volumeAllotmentProtocolTypeCode <NFS|CIFS> \
    --volumeSize <volume-size> \
    [--zoneCode <zone-code>] \
    [--volumeName <volume-name>] \
    [--nasVolumeDescription <nas-volume-description>] \
    [--accessControlRuleList <access-control-rule-config>] \
    [--cifsUserName <cifs-user-name>] \
    [--cifsUserPassword <cifs-user-password>] \
    [--isEncryptedVolume <true|false>] \
    [--isReturnProtection <true|false>] \
    [--isAsync <true|false>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

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

必須オプション

createNasVolumeInstanceの必須オプションです。

オプション	タイプ	必須の有無	説明
`--volumeAllotmentProtocolTypeCode`	String	Required	ボリューム割り当てプロトコルタイプコード `NFS` \| `CIFS` `NFS`: CentOS、Ubuntuなど Linuxサーバでマウント可能 `CIFS`: Windows Serverでマウント可能
`--volumeSize`	Integer	Required	ボリュームサイズ (GB) `500`~`20000` 100GB単位で入力
`--cifsUserName`	String	Conditional	CIFSユーザー名英字、数字を組み合わせて6~19文字以内で入力 CIFSタイプのボリュームを初回作成する場合、必ず入力設定後は変更不可
`--cifsUserPassword`	String	Conditional	CIFSユーザーのパスワード英字、数字、記号の!``@``^``&``*を組み合わせて8~14文字以内で入力 CIFSタイプのボリュームを初回作成する場合、必ず入力 CIFSユーザー名と類似したパスワードは使用不可

任意オプション

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

オプション	タイプ	必須の有無	説明
`--zoneCode`	String	Optional	NASボリュームインスタンスが作成されるゾーンコードデフォルト: `KR-2` getZoneListを参照
`--volumeName`	String	Optional	NASボリューム名英字、数字を組み合わせて3~20文字以内で入力未入力時は自動付与顧客識別のため、入力した名前の先頭に`nMemberNo_`が付く
`--nasVolumeDescription`	String	Optional	ボリュームの説明(Byte) 0~1,000
`--accessControlRuleList`	List	Optional	アクセス制御ルールリスト各ルールは、二重引用符の中に{フィールド=‘値’}のペアをコンマで区切って入力 `serverInstanceNo` (条件付き): アクセス制御として設定するサーバインスタンス番号。`writeAccess`入力時、必ず入力。getServerInstanceListを参照 `writeAccess` (任意): 書き込み権限。`true` (デフォルト) \| `false`
`--isEncryptedVolume`	Boolean	Optional	NASボリューム暗号化設定 `true` \| `false` (デフォルト) `true`: 設定 `false`: 設定しない NASボリュームごとに暗号化を適用 NASボリュームの初回作成時のみ適用可能
`--isReturnProtection`	Boolean	Optional	返却保護を設定 `true` \| `false` (デフォルト) `true`: 設定 `false`: 設定しない
`--isAsync`	Boolean	Optional	Asyncを設定 `true` \| `false` (デフォルト) `true`: 設定 `false`: 設定しない

共通オプション

vnasコマンドで共通して使用するオプションについては、NAS (VPC)のオプションをご参照ください。

例

NASボリュームインスタンスの作成リクエストが成功すると、インスタンスの構成情報と作成状態が返されます。

コマンド

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

./ncloud vnas createNasVolumeInstance \
    --volumeAllotmentProtocolTypeCode NFS \
    --volumeSize 500 \
    --volumeName testnas01 \
    --nasVolumeDescription "Test NAS volume" \
    --isEncryptedVolume false \
    --isReturnProtection false \
    --regionCode KR \
    --output json

出力

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

{
  "createNasVolumeInstanceResponse": {
    "totalRows": 1,
    "nasVolumeInstanceList": [
      {
        "nasVolumeInstanceNo": "10234567",
        "nasVolumeInstanceStatus": {
          "code": "CREAT",
          "codeName": "NAS作成状態"
        },
        "nasVolumeInstanceOperation": {
          "code": "NULL",
          "codeName": "NAS NULL OP"
        },
        "nasVolumeInstanceStatusName": "created",
        "createDate": "2026-08-19T11:32:32+0900",
        "nasVolumeDescription": "Test NAS volume",
        "mountInformation": "192.0.2.10:/n123456_testnas01",
        "volumeAllotmentProtocolType": {
          "code": "NFS",
          "codeName": "NFS"
        },
        "volumeName": "n123456_testnas01",
        "volumeTotalSize": 536870912000,
        "volumeSize": 536870912000,
        "snapshotVolumeConfigurationRatio": 0.0,
        "snapshotVolumeSize": 0,
        "isSnapshotConfiguration": false,
        "isEventConfiguration": false,
        "regionCode": "KR",
        "zoneCode": "KR-2",
        "nasVolumeServerInstanceNoList": [],
        "isEncryptedVolume": false,
        "nasVolumeInstanceCustomIpList": [],
        "isReturnProtection": false
      }
    ],
    "requestId": "",
    "returnCode": "0",
    "returnMessage": "success"
  }
}