---
title: "NasVolumeInstance"
slug: "common-vapidatatype-nasvolumeinstance"
updated: 2026-09-17T09:15:44Z
published: 2026-09-17T09:15:44Z
canonical: "api.ncloud-docs.com/common-vapidatatype-nasvolumeinstance"
---

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

# NasVolumeInstance

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

NAS 볼륨 인스턴스입니다.

## 구문

구문은 다음과 같습니다.

```
private String nasVolumeInstanceNo;
private CommonCode nasVolumeInstanceStatus;
private CommonCode nasVolumeInstanceOperation;
private String nasVolumeInstanceStatusName;
private Date createDate;
private String nasVolumeDescription;
private String mountInformation;
private CommonCode volumeAllotmentProtocolType;
private String volumeName;
private Long volumeTotalSize;
private Long volumeSize;
private Float snapshotVolumeConfigurationRatio;
private CommonCode snapshotVolumeConfigPeriodType;
private CommonCode snapshotVolumeConfigDayOfWeekType;
private Integer snapshotVolumeConfigTime;
private Long snapshotVolumeSize;
private Boolean isSnapshotConfiguration;
private Boolean isEventConfiguration;
private String regionCode;
private String zoneCode;
private ServerInstanceNoList nasVolumeServerInstanceNoList;
private Boolean isEncryptedVolume;
private List<NasVolumeInstanceCustomIp> nasVolumeInstanceCustomIpList;
private Boolean isReturnProtection;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `nasVolumeInstanceNo` | String | Required | NAS 볼륨 인스턴스 번호 - NAS 볼륨 인스턴스를 식별하기 위한 네이버 클라우드 플랫폼의 식별자 |
| `nasVolumeInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | NAS 볼륨 인스턴스 상태 - `CREAT` \| `TERMT` - `CREAT`: Created - `TERMT`: Terminated |
| nasVolumeInstanceOperation | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | NAS 볼륨 인스턴스 운영 상태 |
| `nasVolumeInstanceStatusName` | String | Optional | NAS 볼륨 인스턴스 상태명 - NAS 볼륨 인스턴스 상태와 NAS 볼륨 인스턴스 운영 상태를 조합하여 현재의 NAS 볼륨 인스턴스 상태명 전달 |
| `createDate` | Date | Required | 생성 일시(YYYY-MM-DDThh:mm:ssZ) |
| `nasVolumeDescription` | String | Optional | NAS 볼륨 설명 |
| `mountInformation` | String | Required | NAS 볼륨 마운트 정보 |
| `volumeAllotmentProtocolType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | 볼륨 할당 프로토콜 유형 - `NFS` \| `CIFS` - `NFS`: CentOS, Ubuntu 등 리눅스 서버에서 마운트 - `CIFS`: Windows 서버에서 마운트 |
| `volumeName` | String | Required | 볼륨 이름 |
| `volumeTotalSize` | Long | Required | 볼륨 총 사이즈 |
| `volumeSize` | Long | Required | 볼륨 사이즈 |
| `snapshotVolumeConfigurationRatio` | Float | Required | 스냅샷 볼륨 설정 비율 - isSnapshotConfiguration이 true로 설정되어 있을 경우 값이 설정됨 |
| `snapshotVolumeConfigPeriodType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | 스냅샷 볼륨 설정 기간 유형 - `DAY` \| `WEEK` - `DAY`: 매일 - `WEEK`: 매주 |
| `snapshotVolumeConfigDayOfWeekType` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | 스냅샷 자동 생성 주기 요일 - `-1` \| `0` \| `1` \| `2` \| `3` \| `4` \| `5` \| `6` - -`1`: 매일 - `0`: 일요일 - `1`: 월요일 - `2`: 화요일 - `3`: 수요일 - `4`: 목요일 - `5`: 금요일 - `6`: 토요일 |
| `snapshotVolumeConfigTime` | Integer | Optional | 스냅샷 볼륨 설정 시간 - 0~23시 |
| `snapshotVolumeSize` | Long | Required | 스냅샷 볼륨 사이즈 |
| `isSnapshotConfiguration` | Boolean | Required | 스냅샷 설정 여부 - `true` \| `false` |
| `isEventConfiguration` | Boolean | Required | 이벤트 설정 여부 - `true` \| `false` |
| `regionCode` | String | Required | 리전 코드 |
| `zoneCode` | String | Required | 존 코드 |
| `nasVolumeServerInstanceNoList` | [ServerInstanceNoList](/docs/common-vapidatatype-serverinstancenolist) | Required | NAS 볼륨 서버 인스턴스 번호 목록 |
| `isEncryptedVolume` | Boolean | Required | 볼륨 암호화 여부 - `true` \| `false` |
| `nasVolumeInstanceCustomIpList` | List<[NasVolumeInstanceCustomIp](/docs/common-vapidatatype-NasVolumeInstanceCustomIp)> | Optional | NAS 볼륨 커스텀 IP 목록 |
| i`sReturnProtection` | Boolean | Required | 반납 보호 여부 - `true` \| `false` |