getLoadBalancerInstanceList
    • PDF

    getLoadBalancerInstanceList

    • PDF

    기사 요약

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

    개요

    로드밸런서 인스턴스 리스트를 조회합니다.

    요청

    요청 파라미터

    파라미터명필수 여부타입제약 사항설명
    regionCodeNoString- 리전 코드
    로드밸런서 인스턴스 리스트가 조회될 리전(Region) 결정
    regionCode는 getRegionList 액션을 통해서 획득
    - Default : getRegionList 조회 결과의 첫 번째 리전을 선택
    vpcNoNoString- VPC 번호
    VPC 번호로 필터링하여 검색
    vpcNo는 getVpcList 액션을 통해서 획득
    loadBalancerTypeCodeNoString- 로드밸런서 유형 코드
    로드밸런서 유형으로 필터링하여 검색
    Options : APPLICATION | NETWORK | NETWORK_PROXY
    loadBalancerNetworkTypeCodeNoString- 로드밸런서 네트워크 유형 코드
    로드밸런서 네트워크 유형으로 필터링하여 검색
    Options : PUBLIC | PRIVATE
    loadBalancerInstanceNoList.NNoList<String>- 로드밸런서 인스턴스 번호 리스트
    로드밸런서 인스턴스 번호로 필터링하여 검색
    loadBalancerInstanceNo는 getLoadBalancerInstanceList 액션을 통해서 획득
    ex) loadBalancerInstanceNoList.1=1234&loadBalancerInstanceNoList.2=2345
    pageNoNoInteger- 페이징된 결과의 페이지 번호
    결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
    pageSizeConditionalInteger- 페이징 시 보여줄 각 페이지 사이즈
    결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능
    pageNo 입력시 반드시 입력
    sortList.N.sortedByNoString- 정렬 대상
    결과값을 로드밸런서 이름으로 정렬
    Options : loadBalancerName
    ex) sortList.1.sortedBy=loadBalancerName
    sortList.N.sortingOrderNoString- 정렬 순서
    sortedBy 이용시 오름차순/내림차순 정렬 설정
    Options : ASC (오름차순) | DESC (내림차순)
    Default : ASC
    ex) sortList.1.sortingOrder=DESC
    responseFormatTypeNoString- 응답 결과의 포맷 타입
    Options : xml | json
    Default : xml

    응답

    응답 데이터 타입

    • LoadBalancerInstanceList 타입
    LoadBalancerInstanceList extends CommonResponse
    private Integer totalRows;
    private List loadBalancerInstanceList = new ArrayList<>();
    LoadBalancerInstance
    private String loadBalancerInstanceNo;
    private CommonCode loadBalancerInstanceStatus;
    private CommonCode loadBalancerInstanceOperation;
    private String loadBalancerInstanceStatusName;
    private String loadBalancerDescription;
    private Date createDate;
    private String loadBalancerName;
    private String loadBalancerDomain;
    private LoadBalancerIpList loadBalancerIpList;
    private CommonCode loadBalancerType;
    private CommonCode loadBalancerNetworkType;
    private CommonCode throughputType;
    private Integer idleTimeout;
    private String vpcNo;
    private String regionCode;
    private SubnetNoList subnetNoList;
    private List<LoadBalancerSubnet> loadBalancerSubnetList;
    private LoadBalancerListenerNoList loadBalancerListenerNoList;
    LoadBalancerIpList
    private List loadBalancerIpList = new ArrayList<>();
    SubnetNoList
    private List subnetNoList = new ArrayList<>();
    LoadBalancerSubnet
    private String zoneCode;
    private String subnetNo;
    private String publicIpInstanceNo;
    LoadBalancerListenerNoList
    private List loadBalancerListenerNoList = new ArrayList<>();

    예시

    요청 예시

    ncloud vloadbalancer getLoadBalancerInstanceList --regionCode KR --vpcNo ***04 --loadBalancerTypeCode APPLICATION --loadBalancerNetworkTypeCode PRIVATE --loadBalancerInstanceNoList ***887
    

    응답 예시

    <getLoadBalancerInstanceListResponse>
      <requestId>959a2fe5-fd1b-459a-9af3-df0e51b68e1d</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>***887</loadBalancerInstanceNo>
          <loadBalancerInstanceStatus>
            <code>USED</code>
            <codeName>LB USED state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>NULL</code>
            <codeName>LB NULL OP</codeName>
          </loadBalancerInstanceOperation>
          <loadBalancerInstanceStatusName>Running</loadBalancerInstanceStatusName>
          <loadBalancerDescription></loadBalancerDescription>
          <createDate>2020-12-20T19:21:02+0900</createDate>
          <loadBalancerName>test-***</loadBalancerName>
          <loadBalancerDomain>test-***-***887-***.com</loadBalancerDomain>
          <loadBalancerIpList>
            <loadBalancerIp>***.***.5.6</loadBalancerIp>
          </loadBalancerIpList>
          <loadBalancerType>
            <code>APPLICATION</code>
            <codeName>Application Load Balancer</codeName>
          </loadBalancerType>
          <loadBalancerNetworkType>
            <code>PRIVATE</code>
            <codeName>Private</codeName>
          </loadBalancerNetworkType>
          <throughputType>
            <code>SMALL</code>
            <codeName>Small</codeName>
          </throughputType>
          <idleTimeout>60</idleTimeout>
          <vpcNo>***04</vpcNo>
          <regionCode>KR</regionCode>
          <subnetNoList>
            <subnetNo>***43</subnetNo>
          </subnetNoList>
          <loadBalancerSubnetList>
            <loadBalancerSubnet>
              <zoneCode>KR-1</zoneCode>
              <subnetNo>***43</subnetNo>
              <publicIpInstanceNo/>
            </loadBalancerSubnet>
          </loadBalancerSubnetList>
          <loadBalancerListenerNoList>
            <loadBalancerListenerNo>***961</loadBalancerListenerNo>
          </loadBalancerListenerNoList>
        </loadBalancerInstance>
      </loadBalancerInstanceList>
    </getLoadBalancerInstanceListResponse>
    

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

    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.