getServerImageList
    • PDF

    getServerImageList

    • PDF

    기사 요약

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

    개요

    서버 이미지 리스트를 조회합니다.

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    regionCodeNoString- 리전 코드
    서버 이미지 리스트가 조회될 리전(Region) 결정 가능
    regionCode는 getRegionList 액션을 통해 획득 가능
    Default : getRegionList 조회 결과의 첫 번째 리전을 선택
    serverImageNoList.NNoList<String>- 서버 이미지 번호 리스트
    서버 이미지 번호로 필터링하여 검색 가능
    serverImageNo는 getServerImageList 액션을 통해 획득 가능
    ex) serverImageNoList.1=1234&serverImageNoList.2=2345
    serverImageNameNoString- 서버 이미지 이름
    서버 이미지 이름으로 필터링하여 검색 가능
    serverImageStatusCodeNoString- 서버 이미지 상태 코드
    서버 이미지 상태 코드로 필터링하여 검색 가능
    Options : INIT | CREAT
    serverImageTypeCodeList.NNoList<String>- 서버 이미지 타입 코드 리스트
    서버 이미지 타입 코드로 필터링하여 검색 가능
    Options : SELF | NCP
    ex) serverImageTypeCodeList.1=NCP
    hypervisorTypeCodeList.NNoList<String>- 하이퍼바이저 타입 코드 리스트
    하이퍼바이저 타입 코드로 필터링하여 검색 가능
    Options: XEN | RHV | KVM
    ex) hypervisorTypeCodeList.1=XEN&hypervisorTypeCodeList.2=KVM
    osTypeCodeList.NNoList<String>- OS 타입 코드 리스트
    OS 타입 코드로 필터링하여 검색 가능
    Options : CENTOS | UBUNTU | WINDOWS
    ex) osTypeCodeList.1=CENTOS&osTypeCodeList.2=UBUNTU
    platformCategoryCodeList.NNoList<String>- 플랫폼 카테고리 코드 리스트
    플랫폼 카테고리 코드로 필터링하여 검색 가능
    Options : OS | APP | DBMS | GPU
    ex) platformCategoryCodeList.1=OS&platformCategoryCodeList.2=GPU
    pageNoNoInteger- 페이징된 결과의 페이지 번호
    결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
    pageSizeConditionalInteger- 페이징 시 보여줄 각 페이지 사이즈
    결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
    pageNo 입력시 반드시 입력 필요
    sortedByNoString- 정렬 대상
    결과값을 서버 이미지 이름으로 정렬 가능
    Options : serverImageName
    sortingOrderNoString- 정렬 순서
    sortedBy 이용시 오름차순/내림차순 정렬을 설정
    Options : ASC (오름차순) | DESC (내림차순)
    Default : ASC
    responseFormatTypeNoString- 응답 결과의 포맷 타입
    Options : xml | json
    Default : xml

    응답

    응답 바디

    예시

    요청 예시

    GET {API_URL}/getServerImageList
    ?regionCode=KR
    &serverImageNoList.1=***5847
    &serverImageName=test-***
    &serverImageStatusCode=CREAT
    &osTypeCodeList.1=CENTOS
    

    응답 예시

    
    <getServerImageListResponse>
        <requestId></requestId>
        <returnCode>0</returnCode>
        <returnMessage>success</returnMessage>
        <totalRows>1</totalRows>
        <serverImageList>
            <serverImage>
                <serverImageNo>***5847</serverImageNo>
                <serverImageName>test-***</serverImageName>
                <serverImageDescription></serverImageDescription>
                <serverImageType>
                    <code>NCP</code>
                    <codeName>NCP Server Image</codeName>
                </serverImageType>
                <serverImageLifeCyclePhase>
                    <code>IN_SERVICE</code>
                    <codeName>In Service</codeName>
                </serverImageLifeCyclePhase>
                <hypervisorType>
                    <code>XEN</code>
                    <codeName>XEN</codeName>
                </hypervisorType>
                <cpuArchitectureType>
                    <code>X86_64</code>
                    <codeName>x86 64bit</codeName>
                </cpuArchitectureType>
                <osCategoryType>
                    <code>LINUX</code>
                    <codeName>LINUX</codeName>
                </osCategoryType>
                <osType>
                    <code>CENTOS</code>
                    <codeName>CENTOS</codeName>
                </osType>
                <productCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</productCode>
                <serverImageStatus>
                    <code>CREAT</code>
                    <codeName>Server created state</codeName>
                </serverImageStatus>
                <serverImageOperation>
                    <code>NULL</code>
                    <codeName>NULL OP</codeName>
                </serverImageOperation>
                <serverImageStatusName>created</serverImageStatusName>
                <createDate>2020-08-24T10:34:27+0900</createDate>
                <blockStorageMappingList>
                    <blockStorageMapping>
                        <order>0</order>
                        <blockStorageSize>53687091200</blockStorageSize>
                        <blockStorageVolumeType>
                            <code>HDD</code>
                            <codeName>HDD</codeName>
                        </blockStorageVolumeType>
                        <isEncryptedVolume>false</isEncryptedVolume>
                    </blockStorageMapping>
                </blockStorageMappingList>
                <shareStatus>
                    <code>NULL</code>
                    <codeName>NSI Share NULL State</codeName>
                </shareStatus>
                <sharedLoginIdList/>
            </serverImage>
        </serverImageList>
    </getServerImageListResponse>
    

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

    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.