Classic 환경에서 이용 가능합니다.
개요
NAS 볼륨 인스턴스 생성
설명
NAS 볼륨 인스턴스를 생성합니다.
요청 파라미터
| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| volumeName | Yes | String | - 생성할 NAS 볼륨 이름 고객 식별을 위해 이미 입력된 NAS 볼륨 이름 뒤에 3~20자까지 NAS 볼륨 이름 입력 가능 |
|
| volumeSize | Yes | String | 500GB 이상 10,000GB 이하 | - NAS 볼륨 사이즈 볼륨 기본 용량은 500GB ~ 10,000GB이며 100GB 단위로 추가 가능 |
| volumeAllotmentProtocolTypeCode | Yes | String | Min : 1, Max : 5 | - 볼륨 할당 프로토콜 유형 코드 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 유저 이름 마운트 접속 ID는 6자리 이상 20자리 미만의 영문, 숫자의 조합으로 입력 가능 |
|
| cifsUserPassword | Conditional | String | - CIFS 유저 패스워드 마운트 접속 비밀번호는 8자리 이상 14자리 이하이며 영문 2자리 이상, 숫자, 특수문자의 조합으로 입력 가능 |
|
| nasVolumeDescription | No | String | Min : 1, Max : 1,000 | NAS 볼륨 설명 |
| regionNo | No | String | Min : 1, Max : 5 | 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 default : KR리전 |
| zoneNo | No | String | NAS 볼륨이 생설될 ZONE 결정 가능 getZoneList 액션을 통해 획득 가능 default : 해당리전의 첫번째 ZONE을 선택 |
|
| isReturnProtection | No | Boolean | - 반납 보호 여부 반납 보호 여부를 설정 가능 Options : true | false Default : false |
|
| isAsync | No | Boolean | - Async 여부 Options : true | false Default : false |
응답 데이터 타입
- NasVolumeInstanceList 타입
| NasVolumeInstanceList extends CommonResponse |
|---|
| private Integer totalRows; |
| private List<NasVolumeInstance> nasVolumeInstanceList = new ArrayList<NasVolumeInstance>(); |
| NasVolumeInstance |
|---|
| private String nasVolumeInstanceNo; |
| private CommonCode nasVolumeInstanceStatus; |
| private CommonCode nasVolumeInstanceOperation; |
| private String nasVolumeInstanceStatusName; |
| private Date createDate; |
| private String nasVolumeInstanceDescription; |
| 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 Region region; |
| private Zone zone; |
| private Boolean isReturnProtection; |
| private List<NasVolumeInstanceCustomIp> nasVolumeInstanceCustomIpList = new ArrayList<NasVolumeInstanceCustomIp>(); |
| private List<ServerInstance> nasVolumeServerInstanceList = new ArrayList<ServerInstance>(); |
예시
호출
ncloud server createNasVolumeInstance --volumeName penguin --volumeSize 500 --volumeAllotmentProtocolTypeCode NFS
응답
{
"createNasVolumeInstanceResponse": {
"requestId": "015ac4b1-23b4-4cb2-beb1-b242027894fb",
"returnCode": "0",
"returnMessage": "success",
"totalRows": 1,
"nasVolumeInstanceList": [
{
"nasVolumeInstanceNo": "***7631",
"nasVolumeInstanceStatus": {
"code": "CREAT",
"codeName": "NAS create"
},
"nasVolumeInstanceOperation": {
"code": "NULL",
"codeName": "NAS NULL OP"
},
"nasVolumeInstanceStatusName": "created",
"createDate": "2018-02-26T09:13:01+0000",
"nasVolumeInstanceDescription": "",
"mountInformation": "***.***.84.81:/n***212_penguin",
"volumeAllotmentProtocolType": {
"code": "NFS",
"codeName": "NFS"
},
"volumeName": "n***212_penguin",
"volumeTotalSize": 536870912000,
"volumeSize": 536870912000,
"snapshotVolumeConfigurationRatio": 0.0,
"snapshotVolumeSize": 0,
"isSnapshotConfiguration": false,
"isEventConfiguration": false,
"region": {
"regionNo": "1",
"regionCode": "KR",
"regionName": "Korea"
},
"zone": {
"zoneNo": "2",
"zoneName": "KR-1",
"zoneDescription": "KR-1 zone"
},
"isReturnProtection": false,
"nasVolumeInstanceCustomIpList": [],
"nasVolumeServerInstanceList": []
}
]
}
}
<?xml version="1.0" encoding="UTF-8" ?>
<createNasVolumeInstanceResponse>
<requestId>015ac4b1-23b4-4cb2-beb1-b242027894fb</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<nasVolumeInstanceList>
<nasVolumeInstanceNo>***7631</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-02-26T09:13:01+0000</createDate>
<nasVolumeInstanceDescription></nasVolumeInstanceDescription>
<mountInformation>***.***.84.81:/n***212_penguin</mountInformation>
<volumeAllotmentProtocolType>
<code>NFS</code>
<codeName>NFS</codeName>
</volumeAllotmentProtocolType>
<volumeName>n***212_penguin</volumeName>
<volumeTotalSize>536870912000</volumeTotalSize>
<volumeSize>536870912000</volumeSize>
<snapshotVolumeConfigurationRatio>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>
<zoneDescription>KR-1 zone</zoneDescription>
</zone>
<isReturnProtection>false</isReturnProtection>
<nasVolumeInstanceCustomIpList/>
<nasVolumeServerInstanceList/>
</nasVolumeInstanceList>
</createNasVolumeInstanceResponse>