createNasVolumeInstance
    • PDF

    createNasVolumeInstance

    • PDF

    기사 요약

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

    개요

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

    요청

    요청 파라미터

    파라미터 명필수 여부타입제약사항설명
    volumeNameYesString- 생성할 NAS 볼륨 이름
    고객 식별을 위해 NAVER Cloud Platform 에서 부여한 NAS 식별코드 뒤에 3~20자까지 NAS 볼륨 이름 입력 가능
    volumeSizeYesLong100GB 이상, 10000GB 이하- NAS 볼륨 사이즈
    볼륨 기본 용량은 100GB ~ 10,000GB이며, 100GB 단위로 추가 가능
    volumeAllotmentProtocolTypeCodeYesStringMin : 1, Max : 5- 볼륨할당 프로토콜 유형코드
    Options : NFS | CIFS
    NFS : CentOS, Ubuntu 등 리눅스 서버에서 마운트 가능
    CIFS : Windows 서버에서 마운트 가능
    accessControlRuleList.N.serverInstanceNoConditionalString중복 불가- 서버 인스턴스 번호
    serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
    사용자가 소유하고 있는 서버의 인스턴스 번호만 입력 가능
    한 개의 Rule에 serverInstanceNo 또는 customIp 둘중 한가지만 입력
    accessControlRuleList.N.customIpConditionalString중복 불가- 커스텀 IP
    customIp는 getServerInstanceList 액션을 통해 획득 가능
    사설 IP만 설정 가능 공인 IP 설정 불가
    한 개의 Rule에 serverInstanceNo 또는 customIp 둘중 한가지만 입력
    accessControlRuleList.N.writeAccessNoBoolean- 쓰기 권한 여부
    Options : true | false
    Default : true
    cifsUserNameConditionalString- CIFS유저이름
    볼륨할당 프로토콜 유형코드(volumeAllotmentProtocolTypeCode)가 CIFS인 경우 사용자명/사용자패스워드는 필수 항목
    마운트 접속 ID는 6자리 이상 20자리 미만의 영문, 숫자의 조합으로 입력 가능
    cifsUserPasswordConditionalString- CIFS유저비밀번호
    볼륨할당 프로토콜 유형코드(volumeAllotmentProtocolTypeCode)가 CIFS인 경우 사용자명/사용자패스워드는 필수 항목
    마운트 접속 비밀번호는 8자리 이상 14자리 이하이며 영문 2자리 이상, 숫자, 특수문자의 조합으로 입력 가능
    nasVolumeDescriptionNoStringMin : 1, Max : 1000NAS 볼륨 설명
    regionNoNoStringMin : 1, Max : 5- 리전 번호
    리전 번호를 받아 조회시 해당하는 리전으로만 필터링 가능
    리전 번호는 getRegionList 액션을 통해 획득 가능
    default : 1 (KR)
    ex) regionNo=10
    zoneNoNoString- ZONE번호
    NAS볼륨을 생성할 ZONE 결정 가능
    입력 가능한 상태는 getZoneList 액션을 통해 획득 가능
    default : 해당 리전의 첫번째 ZONE을 선택
    isReturnProtectionNoBoolean- 반납 보호 여부
    반납 보호 여부 설정 가능
    Options : true | false
    Default : false
    isAsyncNoBoolean- 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리턴 코드리턴 메시지
    40024138The server information for setting up NFS is invalid.
    40024139The {0} account you entered is already a CIFS account that is in use elsewhere.
    40024140Created CIFS account and entered CIFS account do not match.
    40024141Password must consist of 8 to 14 characters, a combination of English letters, numbers, and special characters (allow only! @$ % % ^ & *).
    40024142{0} volume name entered is already another name in use.
    40024143CIFS account is already registered
    40024144CIFS account does not exist
    40024145ACL setup is not available for CIFS volumes.
    40024146The snapshot setting percentage information is invalid.
    40024147The snapshot setup time information is invalid.
    40024148Snapshot settings are already turned off.
    40024149Snapshot immediate creation is not available because snapshot is not set.
    40024150Snapshot immediate creation is not available due to a 0 % snapshot setup.
    40024151No snapshot found with {0} name.
    40024152{0} IP is already entered.
    40024153{0} IP is Loopback IP.
    40024154{0} IP is public IP.
    40024155Please check the IP {0}.

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.