createNasVolumeInstance
    • PDF

    createNasVolumeInstance

    • PDF

    Article Summary

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

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

    요청

    요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

    메서드URI
    GET, POST/createNasVolumeInstance

    요청 헤더

    NAS API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 NAS 공통 헤더를 참조해 주십시오.

    요청 쿼리 파라미터

    파라미터에 대한 설명은 다음과 같습니다.

    필드타입필수 여부설명
    regionCodeStringOptionalNAS 볼륨 인스턴스가 생성될 리전 코드
    zoneCodeStringOptionalNAS 볼륨 인스턴스가 생성될 존 코드
    volumeAllotmentProtocolTypeCodeStringRequired볼륨 할당 프로토콜 유형 코드
    • NFS | CIFS
      • NFS: CentOS, Ubuntu 등 리눅스 서버에서 마운트 가능
      • CIFS: Windows 서버에서 마운트 가능
    volumeSizeIntegerRequired볼륨 크기
    • 500~ 10,000
    • 100 GB 단위로 입력
    volumeNameStringOptionalNAS 볼륨 이름
    • 3~20자로 영문자, 숫자만 입력 가능
    • 미입력 시 자동 부여
    • 고객 식별을 위해 입력한 이름 앞에 'n회원번호_'가 붙음
    accessControlRuleList.N.serverInstanceNoStringConditional접근 제어로 설정할 서버 인스턴스 번호
    accessControlRuleList.N.writeAccessBooleanOptional쓰기 권한 설정
    • true (기본값) | false
      • true: 설정
      • false: 설정 안 함
    cifsUserNameStringConditionalCIFS 사용자 이름
    • CIFS 유형의 볼륨을 최초로 생성하는 경우 필수
    • 설정 후 변경 불가
    • 6~19자로 영문자, 숫자를 조합하여 입력
    cifsUserPasswordStringConditionalCIFS 사용자 비밀번호
    • CIFS 유형의 볼륨을 최초로 생성하는 경우 필수
    • 8~14자로 영문자, 숫자, 특수 문자(!@^&*)를 조합하여 입력
    • CIFS 사용자 이름과 유사한 비밀번호 사용 불가
    isEncryptedVolumeBooleanOptionalNAS 볼륨 암호화 설정
    • NAS 볼륨별로 암호화 적용
    • NAS 볼륨 최초 생성 시에만 적용 가능
    • true | false (기본값)
      • true: 설정
      • false: 설정 안 함
    isReturnProtectionBooleanOptional반납 보호 설정
    • true | false (기본값)
      • true: 설정
      • false: 설정 안 함
    nasVolumeDescriptionStringOptional볼륨에 대한 설명 (Byte)
    • 0~1,000
    isAsyncBooleanOptionalAsync 설정
    • true | false (기본값)
      • true: 설정
      • false: 설정 안 함
    responseFormatTypeStringOptional응답 결과의 포맷 유형
    • xml(기본값) | json

    요청 예시

    요청 예시는 다음과 같습니다.

    curl --location --request GET 'https://ncloud.apigw.ntruss.com/vnas/v2/createNasVolumeInstance?regionCode=KR&zoneCode=KR-2&volumeName=volume00&volumeAllotmentProtocolTypeCode=CIFS&volumeSize=500&accessControlRuleList.1.serverInstanceNo=23430000&accessControlRuleList.1.writeAccess=true&cifsUserName=user******&cifsUserPassword=************&isEncryptedVolume=true&isReturnProtection=true&nasVolumeDescription=test&isAsync=true&responseFormatType=json' \
    --header 'x-ncp-apigw-timestamp: {Timestamp}' \
    --header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
    

    응답

    응답 형식을 설명합니다.

    응답 바디

    응답 바디는 NasVolumeInstanceList를 참조해 주십시오.

    응답 상태 코드

    네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Ncloud API 응답 상태 코드를 참조해 주십시오.

    응답 예시

    응답 예시는 다음과 같습니다.

    {
        "createNasVolumeInstanceResponse": {
            "totalRows": 1,
            "nasVolumeInstanceList": [
                {
                    "nasVolumeInstanceNo": "23490000",
                    "nasVolumeInstanceStatus": {
                        "code": "INIT",
                        "codeName": "NAS INIT state"
                    },
                    "nasVolumeInstanceOperation": {
                        "code": "CREAT",
                        "codeName": "NAS CREAT OP"
                    },
                    "nasVolumeInstanceStatusName": "creating",
                    "createDate": "2024-04-08T09:04:28+0900",
                    "nasVolumeDescription": "test",
                    "mountInformation": "\\\\169.254.00.00\\n2768364_volume00",
                    "volumeAllotmentProtocolType": {
                        "code": "CIFS",
                        "codeName": "CIFS"
                    },
                    "volumeName": "n2768364_volume00",
                    "volumeTotalSize": 536870912000,
                    "volumeSize": 536870912000,
                    "snapshotVolumeConfigurationRatio": 0.0,
                    "snapshotVolumeSize": 0,
                    "isSnapshotConfiguration": false,
                    "isEventConfiguration": false,
                    "regionCode": "KR",
                    "zoneCode": "KR-2",
                    "nasVolumeServerInstanceNoList": [
                        "23430000"
                    ],
                    "isEncryptedVolume": true,
                    "nasVolumeInstanceCustomIpList": [],
                    "isReturnProtection": true
                }
            ],
            "requestId": "",
            "returnCode": "0",
            "returnMessage": "success"
        }
    }
    

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

    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.