createNasVolumeInstance

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 <FKR>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createNasVolumeInstance의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--volumeAllotmentProtocolTypeCode`	String	Required	볼륨 할당 프로토콜 유형 코드 `NFS` \| `CIFS` `NFS`: CentOS, Ubuntu 등 리눅스 서버에서 마운트 가능 `CIFS`: Windows 서버에서 마운트 가능
`--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` (Conditional): 접근 제어로 설정할 서버 인스턴스 번호. `writeAccess` 입력 시 필수 입력. getServerInstanceList 참조 `writeAccess` (Optional): 쓰기 권한. `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 옵션을 참조해 주십시오.

예시

NAS 볼륨 인스턴스 생성 요청이 성공하면 인스턴스의 구성 정보와 생성 상태가 반환됩니다.

명령

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

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

출력

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

{
  "createNasVolumeInstanceResponse": {
    "totalRows": 1,
    "nasVolumeInstanceList": [
      {
        "nasVolumeInstanceNo": "34567890",
        "nasVolumeInstanceStatus": {
          "code": "CREAT",
          "codeName": "NAS 생성 상태"
        },
        "nasVolumeInstanceOperation": {
          "code": "NULL",
          "codeName": "NAS NULL OP"
        },
        "nasVolumeInstanceStatusName": "created",
        "createDate": "2026-08-26T10:57:57+0900",
        "nasVolumeDescription": "Test NAS volume",
        "mountInformation": "169.254.0.20:/n123456_testnas01",
        "volumeAllotmentProtocolType": {
          "code": "NFS",
          "codeName": "NFS"
        },
        "volumeName": "n123456_testnas01",
        "volumeTotalSize": 536870912000,
        "volumeSize": 536870912000,
        "snapshotVolumeConfigurationRatio": 0.0,
        "snapshotVolumeSize": 0,
        "isSnapshotConfiguration": false,
        "isEventConfiguration": false,
        "regionCode": "FKR",
        "zoneCode": "FKR-1",
        "nasVolumeServerInstanceNoList": [],
        "isEncryptedVolume": false,
        "nasVolumeInstanceCustomIpList": [],
        "isReturnProtection": false
      }
    ],
    "requestId": "",
    "returnCode": "0",
    "returnMessage": "success"
  }
}