getServerInstanceList
    • PDF

    getServerInstanceList

    • PDF

    기사 요약

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

    서버 인스턴스(VM) 리스트를 조회합니다.

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    regionCodeNoString- 리전 코드
    서버 인스턴스 리스트가 조회될 리전(Region) 결정 가능
    regionCode는 getRegionList 액션을 통해 획득 가능
    Default : getRegionList 조회 결과의 첫 번째 리전을 선택
    vpcNoNoString- VPC 번호
    VPC 번호로 필터링하여 검색 가능
    vpcNo는 getVpcList 액션을 통해 획득 가능
    serverInstanceNoList.NNoList<String>- 서버 인스턴스 번호 리스트
    서버 인스턴스 번호로 필터링하여 검색 가능
    serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능
    ex) serverInstanceNoList.1=1234&serverInstanceNoList.2=2345
    serverNameNoString- 서버 이름
    서버 이름으로 필터링하여 검색 가능
    serverInstanceStatusCodeNoString서버 인스턴스 상태 코드
    서버 인스턴스 상태 코드로 필터링하여 검색 가능
    Options : INIT | CREAT | RUN | NSTOP
    baseBlockStorageDiskTypeCodeNoString- 기본 블록 스토리지 디스크 유형 코드
    서버 인스턴스의 기본 블록 스토리지 유형으로 필터링하여 검색 가능
    Options : NET (NETWORK DISK)
    baseBlockStorageDiskDetailTypeCodeNoString- 기본 블록 스토리지 디스크 상세 유형 코드
    서버 인스턴스의 기본 블록 스트리지 상세 유형으로 필터링하여 검색 가능
    Options : HDD | SSD
    ipNoString- IP 주소
    서버 인스턴스의 IP 주소로 필터링하여 검색 가능
    비공인 IP와 공인 IP 모두 필터링 대상이 됨
    placementGroupNoList.NNoList<String>- 물리 배치 그룹 번호 리스트
    서버 인스턴스가 소속되는 물리 배치 그룹 번호로 필터링하여 검색 가능
    placementGroupNo는 getPlacementGroupList 액션을 통해 획득 가능
    ex) placementGroupNoList.1=1234&placementGroupNoList.2=2345
    hypervisorTypeCodeList.NNoList<String>- 하이퍼바이저 타입 코드 리스트
    하이퍼바이저 타입으로 필터링하여 검색 가능
    Options : XEN | KVM
    ex) hypervisorTypeCodeList.1=KVM&hypervisorTypeCodeList.2=XEN
    pageNoNoInteger- 페이징된 결과의 페이지 번호
    결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
    pageSizeConditionalInteger- 페이징 시 보여줄 각 페이지 사이즈
    결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
    pageNo 입력시 반드시 입력 필요
    sortedByNoString- 정렬 대상
    결과값을 서버 이름, 서버 인스턴스 번호로 정렬 가능
    Options : serverName | serverInstanceNo
    sortingOrderNoString- 정렬 순서
    sortedBy 이용시 오름차순/내림차순 정렬을 설정함
    Options : ASC (오름차순) | DESC (내림차순)
    Default : ASC
    responseFormatTypeNoString- 응답 결과의 포맷 타입
    Options : xml | json
    Default : xml

    응답

    응답 바디

    예시

    요청 예시

    GET {API_URL}/getServerInstanceList
    ?regionCode=KR
    &vpcNo=***04
    &serverInstanceNoList.1=***4299
    &serverName=test-***
    &serverInstanceStatusCode=RUN
    &baseBlockStorageDiskTypeCode=NET
    &baseBlockStorageDiskDetailTypeCode=SSD
    &ip=***.***.111.215
    &placementGroupNoList.1=***61
    

    응답 예시

    <getServerInstanceListResponse>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>***4299</serverInstanceNo>
          <serverName>test-***</serverName>
          <serverDescription></serverDescription>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <platformType>
            <code>LNX64</code>
            <codeName>Linux 64 Bit</codeName>
          </platformType>
          <loginKeyName>test-***</loginKeyName>
          <publicIpInstanceNo>***7551</publicIpInstanceNo>
          <publicIp>***.***.111.215</publicIp>
          <serverInstanceStatus>
            <code>RUN</code>
            <codeName>Server run state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>NULL</code>
            <codeName>Server NULL OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>running</serverInstanceStatusName>
          <createDate>2020-08-19T15:05:07+0900</createDate>
          <uptime>2020-08-19T15:08:09+0900</uptime>
          <serverImageProductCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</serverImageProductCode>
          <serverProductCode>SVR.VSVR.STAND.C002.M004.NET.SSD.B050.G001</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <zoneCode>KR-1</zoneCode>
          <regionCode>KR</regionCode>
          <vpcNo>***04</vpcNo>
          <subnetNo>***43</subnetNo>
          <networkInterfaceNoList>
            <networkInterfaceNo>***87</networkInterfaceNo>
          </networkInterfaceNoList>
          <initScriptNo></initScriptNo>
          <serverInstanceType>
            <code>STAND</code>
            <codeName>Standard</codeName>
          </serverInstanceType>
          <baseBlockStorageDiskType>
            <code>NET</code>
            <codeName>Network Storage</codeName>
          </baseBlockStorageDiskType>
          <baseBlockStorageDiskDetailType>
            <code>SSD</code>
            <codeName>SSD</codeName>
          </baseBlockStorageDiskDetailType>
          <placementGroupNo>***61</placementGroupNo>
          <placementGroupName>test-***</placementGroupName>
          <hypervisorType>
            <code>KVM</code>
            <codeName>KVM</codeName>
          </hypervisorType>
          <serverImageNo>61</serverImageNo>
          <serverSpecCode>mi2-g3i</serverSpecCode>
        </serverInstance>
      </serverInstanceList>
    </getServerInstanceListResponse>
    

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

    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.