createNasVolumeInstance

Prev Next

개요

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 No String - 접근제어에 추가할 서버 인스턴스 번호
serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
한 개의 Rule에 serverInstanceNo 또는 customIp 둘중 한가지만 입력
accessControlRuleList.N.customIp No String 중복 불가 - 접근제어에 추가할 커스텀 IP
서버의 IP 주소를 등록하여 접근제어 설정 가능
사설 IP만 설정 가능하며 공인 IP는 설정 불가
Neurocloud 환경에서만 이용 가능
한 개의 Rule에 serverInstanceNo 또는 customIp 둘중 한가지만 입력
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 FKR --zoneCode FKR-1 --volumeName test*** --volumeAllotmentProtocolTypeCode NFS --volumeSize 500 --accessControlRuleList "customIp='10.0.0.1', writeAccess=true" --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>FKR</regionCode>
      <zoneCode>FKR-1</zoneCode>
      <nasVolumeServerInstanceNoList/>
      <isEncryptedVolume>false</isEncryptedVolume>
      <nasVolumeInstanceCustomIpList>
        <nasVolumeInstanceCustomIp>
          <customIp>10.0.0.1</customIp>
        </nasVolumeInstanceCustomIp>
      </nasVolumeInstanceCustomIpList>
      <isReturnProtection>false</isReturnProtection>
    </nasVolumeInstance>
  </nasVolumeInstanceList>
</createNasVolumeInstanceResponse>