changeNasVolumeSnapshotConfiguration

NAS 볼륨 인스턴스의 스냅샷 설정을 변경합니다.

구문

changeNasVolumeSnapshotConfiguration 구문은 다음과 같습니다.

./ncloud vnas changeNasVolumeSnapshotConfiguration \
    --nasVolumeInstanceNo <nas-volume-instance-no> \
    --snapshotVolumeConfigurationRatio <snapshot-volume-configuration-ratio> \
    [--snapshotVolumeConfigDayOfWeekTypeCode <-1|0|1|2|3|4|5|6>] \
    [--snapshotVolumeConfigTime <snapshot-volume-config-time>] \
    [--regionCode <FKR>] \
    [--output <json|xml>]

옵션

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

필수 옵션

changeNasVolumeSnapshotConfiguration의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--nasVolumeInstanceNo`	String	Required	NAS 볼륨 인스턴스 번호 getNasVolumeInstanceList 참조
`--snapshotVolumeConfigurationRatio`	Integer	Required	볼륨 내 스냅샷 할당 비율 (%) `0`~`99` `0`으로 설정하면 스냅샷 설정 해제 스냅샷 용량이 설정한 비율의 용량을 초과하면 과거 스냅샷부터 삭제
`--snapshotVolumeConfigTime`	Integer	Conditional	스냅샷 자동 생성의 실행 시간 (시) `0`~`23` `snapshotVolumeConfigDayOfWeekTypeCode` 입력 시 필수 입력

선택 옵션

changeNasVolumeSnapshotConfiguration의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--snapshotVolumeConfigDayOfWeekTypeCode`	String	Optional	스냅샷 자동 생성 활성화 및 주기 설정 `-1` (매일) \| `0` (일요일) \| `1` (월요일) \| `2` (화요일) \| `3` (수요일) \| `4` (목요일) \| `5` (금요일) \| `6` (토요일) 스냅샷 할당 비율이 `0`인 경우, 무효 스냅샷 용량 한도 내에서 설정한 요일별로 자동 생성

공통 옵션

vnas 명령에서 공통으로 사용하는 옵션에 대한 정보는 NAS 옵션을 참조해 주십시오.

예시

스냅샷 설정 변경 요청이 성공하면 NAS 볼륨 인스턴스의 구성 정보와 스냅샷 설정 정보가 반환됩니다.

명령

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

./ncloud vnas changeNasVolumeSnapshotConfiguration \
    --nasVolumeInstanceNo 34567890 \
    --snapshotVolumeConfigurationRatio 10 \
    --snapshotVolumeConfigDayOfWeekTypeCode -1 \
    --snapshotVolumeConfigTime 1 \
    --regionCode FKR \
    --output json

출력

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

{
  "changeNasVolumeSnapshotConfigurationResponse": {
    "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": 644245094400,
        "volumeSize": 579820584960,
        "snapshotVolumeConfigurationRatio": 10.0,
        "snapshotVolumeConfigPeriodType": {
          "code": "DAY",
          "codeName": "매일"
        },
        "snapshotVolumeConfigDayOfWeekType": {
          "code": "-1",
          "codeName": "Everyday"
        },
        "snapshotVolumeConfigTime": 1,
        "snapshotVolumeSize": 64424509440,
        "isSnapshotConfiguration": true,
        "isEventConfiguration": false,
        "regionCode": "FKR",
        "zoneCode": "FKR-1",
        "nasVolumeServerInstanceNoList": [
          "31112224"
        ],
        "isEncryptedVolume": false,
        "nasVolumeInstanceCustomIpList": [],
        "isReturnProtection": true
      }
    ],
    "requestId": "",
    "returnCode": "0",
    "returnMessage": "success"
  }
}