createNasVolumeInstance

Prev Next

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

개요

NAS 볼륨 인스턴스를 생성합니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
NAS 볼륨 인스턴스가 생성될 리전(Region) 결정 가능
regionCode는 getRegionList 액션을 통해 획득 가능
Default : getRegionList 조회 결과의 첫 번째 리전을 선택
zoneCode No String - ZONE 코드
NAS 볼륨 인스턴스가 생성될 존(zone) 결정 가능
zoneCode는 getZoneList 액션을 통해 획득 가능
Default : getZoneList 조회 결과의 첫 번째 존을 선택
volumeName No String Min : 3, Max : 20
영어, 숫자만 허용함
- 생성할 NAS 볼륨 이름
Default : NAVER CLOUD PLATFORM가 자동으로 부여함
고객 식별을 위해 이름 앞에 'n회원번호_' 가 자동으로 붙음
volumeAllotmentProtocolTypeCode Yes String - 볼륨 할당 프로토콜 유형 코드
Options : NFS (CentOS, Ubuntu 등 리눅스 서버에서 마운트 가능) | CIFS (Windows 서버에서 마운트 가능)
volumeSize Yes Integer Min : 500, Max : 10000 GB
100GB 단위 입력
볼륨 사이즈
accessControlRuleList.N.serverInstanceNo Conditional String - 접근제어로 설정할 서버 인스턴스 번호
serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
accessControlRuleList.N.writeAccess No Boolean - 쓰기 권한 여부
Options : true | false
Default : true
cifsUserName Conditional String Min : 6, Max : 19
영어, 숫자만 허용함
- CIFS 유저 이름
볼륨 할당 프로토콜 유형을 CIFS로 최초로 생성하는 경우 필수로 인증 정보를 설정해야 함
한 번 설정한 인증 정보는 변경할 수 없음
cifsUserPassword Conditional String Min : 8, Max : 14
영어, 숫자, 특수문자 (!@%^&*) 만 허용함
- CIFS 유저 비밀번호
볼륨 할당 프로토콜 유형을 CIFS로 최초로 생성하는 경우 필수로 인증 정보를 설정해야 함
isEncryptedVolume No Boolean - 볼륨 암호화 여부
볼륨별로 암호화가 적용되고 최초 생성 시에만 적용이 가능함
Options : true | false
Default : false
isReturnProtection No Boolean - 반납 보호 여부
반납 보호 여부 설정 가능
Options : true | false
Default : false
nasVolumeDescription No String Min : 0, Max : 1000 Bytes 생성할 NAS 볼륨에 대한 설명
isAsync No Boolean - Async 여부
Options : true | false
Default : false

응답

응답 데이터 타입

  • NasVolumeInstanceList 타입
NasVolumeInstanceList extends CommonResponse
private Integer totalRows;
private List<NasVolumeInstance> nasVolumeInstanceList = new ArrayList<>();
NasVolumeInstance
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;
NasVolumeInstanceCustomIp
private String customIp;

예시

요청 예시

ncloud vnas createNasVolumeInstance --regionCode KR --zoneCode KR-1 --volumeName test*** --volumeAllotmentProtocolTypeCode NFS --volumeSize 500 --isReturnProtection false

응답 예시

<createNasVolumeInstanceResponse>
  <requestId>0c607174-7674-419e-96f0-a5a0b15a4554</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <nasVolumeInstanceList>
    <nasVolumeInstance>
      <nasVolumeInstanceNo>***3901</nasVolumeInstanceNo>
      <nasVolumeInstanceStatus>
        <code>CREAT</code>
        <codeName>NAS create</codeName>
      </nasVolumeInstanceStatus>
      <nasVolumeInstanceOperation>
        <code>NULL</code>
        <codeName>NAS NULL OP</codeName>
      </nasVolumeInstanceOperation>
      <nasVolumeInstanceStatusName></nasVolumeInstanceStatusName>
      <createDate>1970-01-01T09:00:02+0900</createDate>
      <nasVolumeDescription></nasVolumeDescription>
      <mountInformation>***.***.0.20:/n***4567_test***</mountInformation>
      <volumeAllotmentProtocolType>
        <code>NFS</code>
        <codeName>NFS</codeName>
      </volumeAllotmentProtocolType>
      <volumeName>n***4567_test***</volumeName>
      <volumeTotalSize>536870912000</volumeTotalSize>
      <volumeSize>536870912000</volumeSize>
      <snapshotVolumeConfigurationRatio>0.0</snapshotVolumeConfigurationRatio>
      <snapshotVolumeSize>0</snapshotVolumeSize>
      <isSnapshotConfiguration>false</isSnapshotConfiguration>
      <isEventConfiguration>false</isEventConfiguration>
      <regionCode>KR</regionCode>
      <zoneCode>KR-1</zoneCode>
      <nasVolumeServerInstanceNoList/>
      <isEncryptedVolume>false</isEncryptedVolume>
      <nasVolumeInstanceCustomIpList/>
      <isReturnProtection>false</isReturnProtection>
    </nasVolumeInstance>
  </nasVolumeInstanceList>
</createNasVolumeInstanceResponse>