createNasVolumeInstance

Prev Next

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

개요

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

요청

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
volumeName Yes String - 생성할 NAS 볼륨 이름
고객 식별을 위해 NAVER Cloud Platform 에서 부여한 NAS 식별코드 뒤에 3~20자까지 NAS 볼륨 이름 입력 가능
volumeSize Yes Long 100GB 이상, 10000GB 이하 - NAS 볼륨 사이즈
볼륨 기본 용량은 100GB ~ 10,000GB이며, 100GB 단위로 추가 가능
volumeAllotmentProtocolTypeCode Yes String Min : 1, Max : 5 - 볼륨할당 프로토콜 유형코드
Options : NFS | CIFS
NFS : CentOS, Ubuntu 등 리눅스 서버에서 마운트 가능
CIFS : Windows 서버에서 마운트 가능
accessControlRuleList.N.serverInstanceNo Conditional String 중복 불가 - 서버 인스턴스 번호
serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
사용자가 소유하고 있는 서버의 인스턴스 번호만 입력 가능
한 개의 Rule에 serverInstanceNo 또는 customIp 둘중 한가지만 입력
accessControlRuleList.N.customIp Conditional String 중복 불가 - 커스텀 IP
customIp는 getServerInstanceList 액션을 통해 획득 가능
사설 IP만 설정 가능 공인 IP 설정 불가
한 개의 Rule에 serverInstanceNo 또는 customIp 둘중 한가지만 입력
accessControlRuleList.N.writeAccess No Boolean - 쓰기 권한 여부
Options : true | false
Default : true
cifsUserName Conditional String - CIFS유저이름
볼륨할당 프로토콜 유형코드(volumeAllotmentProtocolTypeCode)가 CIFS인 경우 사용자명/사용자패스워드는 필수 항목
마운트 접속 ID는 6자리 이상 20자리 미만의 영문, 숫자의 조합으로 입력 가능
cifsUserPassword Conditional String - CIFS유저비밀번호
볼륨할당 프로토콜 유형코드(volumeAllotmentProtocolTypeCode)가 CIFS인 경우 사용자명/사용자패스워드는 필수 항목
마운트 접속 비밀번호는 8자리 이상 14자리 이하이며 영문 2자리 이상, 숫자, 특수문자의 조합으로 입력 가능
nasVolumeDescription No String Min : 1, Max : 1000 NAS 볼륨 설명
regionNo No String Min : 1, Max : 5 - 리전 번호
리전 번호를 받아 조회시 해당하는 리전으로만 필터링 가능
리전 번호는 getRegionList 액션을 통해 획득 가능
default : 1 (KR)
ex) regionNo=10
zoneNo No String - ZONE번호
NAS볼륨을 생성할 ZONE 결정 가능
입력 가능한 상태는 getZoneList 액션을 통해 획득 가능
default : 해당 리전의 첫번째 ZONE을 선택
isReturnProtection No Boolean - 반납 보호 여부
반납 보호 여부 설정 가능
Options : true | false
Default : false
isAsync No Boolean - Async 여부
Options : true | false
Default : false

응답

응답 바디

예시

요청 예시

GET {SERVER_API_URL}/createNasVolumeInstance
?volumeName=testnas&volumeSize=500
&volumeAllotmentProtocolTypeCode=NFS

응답 예시

<createNasVolumeInstanceResponse>
  <requestId>270e693b-b265-4345-8f23-0476e82f141f</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <nasVolumeInstanceList>
    <nasVolumeInstance>
      <nasVolumeInstanceNo>***4361</nasVolumeInstanceNo>
      <nasVolumeInstanceStatus>
        <code>CREAT</code>
        <codeName>NAS create</codeName>
      </nasVolumeInstanceStatus>
      <nasVolumeInstanceOperation>
        <code>NULL</code>
        <codeName>NAS NULL OP</codeName>
      </nasVolumeInstanceOperation>
      <nasVolumeInstanceStatusName>created</nasVolumeInstanceStatusName>
      <createDate>2018-11-26T19:40:14+0900</createDate>
      <nasVolumeDescription></nasVolumeDescription>
      <mountInformation>***.***.53.74:/n***2613_testnas</mountInformation>
      <volumeAllotmentProtocolType>
        <code>NFS</code>
        <codeName>NFS</codeName>
      </volumeAllotmentProtocolType>
      <volumeName>n***2613_testnas</volumeName>
      <volumeTotalSize>536870912000</volumeTotalSize>
      <volumeSize>536870912000</volumeSize>
      <snapshotVolumeConfigurationRatio>0.0</snapshotVolumeConfigurationRatio>
      <snapshotVolumeSize>0</snapshotVolumeSize>
      <isSnapshotConfiguration>false</isSnapshotConfiguration>
      <isEventConfiguration>false</isEventConfiguration>
      <region>
        <regionNo>1</regionNo>
        <regionCode>KR</regionCode>
        <regionName>KOREA</regionName>
      </region>
      <zone>
        <zoneNo>2</zoneNo>
        <zoneName>KR-1</zoneName>
        <zoneCode>KR-1</zoneCode>
        <zoneDescription>KR-1 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
      <isReturnProtection>false</isReturnProtection>
      <nasVolumeInstanceCustomIpList/>
      <nasVolumeServerInstanceList/>
    </nasVolumeInstance>
  </nasVolumeInstanceList>
</createNasVolumeInstanceResponse>

에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해 주십시오.

HTTP Response Code 리턴 코드 리턴 메시지
400 24138 The server information for setting up NFS is invalid.
400 24139 The {0} account you entered is already a CIFS account that is in use elsewhere.
400 24140 Created CIFS account and entered CIFS account do not match.
400 24141 Password must consist of 8 to 14 characters, a combination of English letters, numbers, and special characters (allow only! @$ % % ^ & *).
400 24142 {0} volume name entered is already another name in use.
400 24143 CIFS account is already registered
400 24144 CIFS account does not exist
400 24145 ACL setup is not available for CIFS volumes.
400 24146 The snapshot setting percentage information is invalid.
400 24147 The snapshot setup time information is invalid.
400 24148 Snapshot settings are already turned off.
400 24149 Snapshot immediate creation is not available because snapshot is not set.
400 24150 Snapshot immediate creation is not available due to a 0 % snapshot setup.
400 24151 No snapshot found with {0} name.
400 24152 {0} IP is already entered.
400 24153 {0} IP is Loopback IP.
400 24154 {0} IP is public IP.
400 24155 Please check the IP {0}.