MENU
      getServerImageList

        getServerImageList


        기사 요약

        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 | 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
        HTTP

        응답 예시

        <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>
        XML

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

        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.