---
title: "NasVolumeInstance"
slug: "common-apidatatype-nasvolumeinstance"
updated: 2026-04-23T08:55:30Z
published: 2026-04-23T09:02:14Z
---

> ## 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

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

NAS 볼륨 인스턴스입니다.

## 구문

구문은 다음과 같습니다.

```
private String nasVolumeInstanceNo;
private CommonCode nasVolumeInstanceStatus;
private CommonCode nasVolumeInstanceOperation;
private String nasVolumeInstanceStatusName;
private Date createDate;
private String nasVolumeInstanceDescription;
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 Region region;
private Zone zone;
private Boolean isReturnProtection;
private List<NasVolumeInstanceCustomIp> nasVolumeInstanceCustomIpList = new ArrayList<NasVolumeInstanceCustomIp>();
private List<ServerInstance> nasVolumeServerInstanceList = new ArrayList<ServerInstance>();
```

## 필드

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `nasVolumeInstanceNo` | String | Required | NAS 볼륨 인스턴스를 식별하기 위한 네이버클라우드 플랫폼의 식별자 |
| `nasVolumeInstanceStatus` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | NAS 볼륨 인스턴스 상태 - `CREAT` \| `TERMT` - `CREAT` (Created): 생성 - `TERMT` (Terminated): 반납 |
| `nasVolumeInstanceOperation` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | NAS 볼륨 인스턴스 운영 상태 - `NULL` \| `CHNG` - `NULL`: No Operation - `CHNG` (Changing): 설정 변경 중 |
| `nasVolumeInstanceStatusName` | String | Required | NAS 볼륨 인스턴스 상태명 |
| `createDate` | Date | Required | 생성 일시 |
| `nasVolumeInstanceDescription` | String | Optional | NAS 볼륨 인스턴스 설명 |
| `volumeName` | String | Required | 볼륨 이름 |
| `mountInformation` | String | Required | NAS 볼륨 인스턴스 마운트 정보 |
| `volumeTotalSize` | Long | Required | 볼륨 총 사이즈 |
| `volumeAllotmentProtocolType` | [CommonCode](/docs/common-apidatatype-commoncode) | Required | 볼륨 할당 프로토콜 구분 - `NFS` \| `CIFS` |
| `isSnapshotConfiguration` | Boolean | Required | 스냅샷 설정 여부 - `true` \| `false` |
| `snapshotVolumeConfigurationRatio` | float | Optional | 스냅샷 볼륨 설정 비율 - `isSnapshotConfiguration`이 설정되어 있을 경우 값이 설정됨 |
| `snapshotVolumeConfigPeriodType` | [CommonCode](/docs/common-apidatatype-commoncode) | Optional | 스냅샷 볼륨 설정 기간 구분 - `DAY` \| `WEEK` - `DAY`: 매일 - `WEEK`: 매주 |
| `snapshotVolumeConfigDayOfWeekType` | [CommonCode](/docs/common-apidatatype-commoncode) | Optional | 스냅샷 자동 생성 주기 요일 - `-1` \| `0` \| `1` \| `2` \| `3` \| `4` \| `5` \| `6` - `-1`: 매일 - `0`: 일요일 - `1`: 월요일 - `2`: 화요일 - `3`: 수요일 - `4`: 목요일 - `5`: 금요일 - `6`: 토요일 |
| `snapshotVolumeConfigTime` | Integer | Optional | 스냅샷 볼륨 설정 시간 - 0~23시 |
| `isEventConfiguration` | Boolean | Required | 이벤트 설정 여부 - `true` \| `false` |
| `volumeSize` | Long | Required | 볼륨 사이즈 |
| `snapshotVolumeSize` | Long | Optional | 스냅샷 사이즈 |
| `region` | Region | Required | NAS 볼륨 인스턴스가 위치한 리전 |
| `zone` | Zone | Required | NAS 볼륨 인스턴스가 위치한 존 |
| `isReturnProtection` | Boolean | Required | 반납 보호 여부 - `true` \| `false` |
| `nasVolumeServerInstanceList` | List<serverinstance data-tomark-pass=""></serverinstance> | Optional | NAS 볼륨 서버 인스턴스 목록 |
| `nasVolumeCustomIpList` | List<nasvolumecustomiplist data-tomark-pass=""></nasvolumecustomiplist> | Optional | NAS 볼륨 커스텀 IP 목록 |