createNasVolumeInstance
- 인쇄
- PDF
createNasVolumeInstance
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
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}. |
이 문서가 도움이 되었습니까?