로드밸런서 목록 조회

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

설명

로드밸런서 목록을 조회합니다.

요청

요청 URL

GET https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/getLoadBalancerInstanceList/{service-group-instance-no} [수도권]
GET https://clouddatastreamingservice.apigw.gov-ntruss.com/api/krs-v1/cluster/getLoadBalancerInstanceList/{service-group-instance-no} [남부권]

요청 헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	Access Key ID 값과 Secret Key로 암호화한 서명 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Request body content type을 application/json으로 지정 `Content-Type: application/json`

요청 파라미터

파라미터	타입	필수 여부	설명
serviceGroupInstanceNo	String	Y	로드밸런서 목록 조회할 클러스터 번호

요청 예시

GET https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/getLoadBalancerInstanceList/1714400
HOST: clouddatastreamingservice.apigw.gov-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw

curl -X GET "https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/getLoadBalancerInstanceList/1714400" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4="

응답 파라미터

public class GetLoadBalancerListsResponseVo {
    List<LoadBalancerInstance> loadBalancerInstanceList;
}

public class LoadBalancerInstance {
    String loadBalancerIp;
    String loadBalancerName;
    String loadBalancerDomain;
    Integer instanceNo;
    String permission;
}

필드

파라미터명	타입	설명
loadBalancerIp	String	로드밸런서 IP
loadBalancerName	String	로드밸런서 이름
loadBalancerDomain	String	로드밸런서 도메인
instanceNo	Integer	로드밸런스 인스턴스 번호
permission	String	로드밸런서 사용 가능 여부

응답 예시

{
	"code": 0,
	"message": "SUCCESS",
	"result": {
		"loadBalancerInstanceList": [{
			"loadBalancerIp": "1.1.1.1",
			"loadBalancerName": "cdss-pubic-endpoint",
			"loadBalancerDomain": "aa.kr.lb.naverncp.com",
			"instanceNo": 1714401,
			"permission": "allow"
		}]
	},
	"requestId": "fa1129d7-2e79-4064-bbf7-5f9155d1c142"
}