MENU
      QueryDataMultiple

        QueryDataMultiple


        기사 요약

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

        Cloud Insight에서 수집한 여러 개의 time-series 데이터를 조회합니다.

        요청

        요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

        메서드URI
        POST/cw_fea/real/cw/api/data/query/multiple

        요청 헤더

        Cloud Insight API에서 공통으로 사용하는 헤더에 대한 정보는 Cloud Insight 요청 헤더를 참조해 주십시오.

        요청 바디

        요청 바디에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        timeStartIntegerRequired조회 시작 일시(밀리초)
        • Unix Timestamp 형식
        timeEndIntegerRequired조회 종료 일시(밀리초)
        • Unix Timestamp 형식
        metricInfoListArrayRequired조회 조건
        • 1회 호출에 최대 20개의 조건 조회 가능
        참고

        요청 바디 입력 시 다음 내용을 참고해 주십시오.

        • 스키마 등록 시 구성한 집계 함수(aggregation)와 데이터 쿼리 요청의 집계가 일치하지 않으면 데이터를 가져올 수 없습니다.
        • 데이터 집계 주기(interval)에 따라 권장 조회 기간(timeEnd~timeStart)이 상이합니다. 자세한 내용은 데이터 집계 주기별 권장 조회 기간을 참조해 주십시오.

        요청 예시

        요청 예시는 다음과 같습니다.

        curl --location --request POST 'https://cw.apigw.ntruss.com/cw_fea/real/cw/api/data/query/multiple' \
        --header 'x-ncp-apigw-timestamp: {Timestamp}' \
        --header 'x-ncp-iam-access-key: {Access Key}' \
        --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
        --header 'Content-Type: application/json' \
        --data '{
          "metricInfoList": [
            {
              "aggregation": "AVG",
              "dimensions": {
                "instanceNo": "**********"
              },
              "interval": "Min1",
              "metric": "avg_cpu_used_rto",
              "prodKey": "**********"
            },
            {
              "aggregation": "AVG",
              "dimensions": {
                "instanceNo": "**********"
              },
              "interval": "Min1",
              "metric": "avg_read_byt_cnt",
              "prodKey": "**********"
            }
          ],
          "timeEnd": **********,
          "timeStart": **********
        }'
        Shell

        응답

        응답 형식을 설명합니다.

        응답 바디

        응답 바디에 대한 설명은 다음과 같습니다.

        필드타입필수 여부설명
        aggregationString-집계 함수
        • COUNT | SUM | MAX | MIN | AVG
        dimensionsObject-Dimension 정보
        dimensions.instanceNoString-인스턴스 번호
        dpsArray-조회 결과
        • 데이터 포인트(Unix Timestamp 형식), 데이터 값 형태로 표시
        intervalString-집계 주기
        • Min1 | Min5 | Min30 | Hour2 | Day1
        metricString-Metric 이름
        productNameString-상품 이름

        응답 상태 코드

        네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Cloud Insight API 응답 상태 코드를 참조해 주십시오.

        응답 예시

        응답 예시는 다음과 같습니다.

        [
            {
                "aggregation": "AVG",
                "dimensions": {
                    "instanceNo": "**********"
                },
                "dps": [
                    [
                        1733184480000,
                        0.3678916
                    ],
                    [
                        1733184540000,
                        0.33438668
                    ],
                    [
                        1733184600000,
                        0.32612613
                    ],
                    [
                        1733184660000,
                        0.32586497
                    ],
                    [
                        1733184720000,
                        0.30105397
                    ]
                ],
                "interval": "Min1",
                "metric": "avg_cpu_used_rto",
                "productName": "Server(VPC)"
            },
            {
                "aggregation": "AVG",
                "dimensions": {
                    "instanceNo": "**********"
                },
                "dps": [
                    [
                        1733184480000,
                        24029.867
                    ],
                    [
                        1733184540000,
                        13107.2
                    ],
                    [
                        1733184600000,
                        13721.6
                    ],
                    [
                        1733184660000,
                        13107.2
                    ],
                    [
                        1733184720000,
                        13107.2
                    ]
                ],
                "interval": "Min1",
                "metric": "avg_read_byt_cnt",
                "productName": "Server(VPC)"
            }
        ]
        JSON

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

        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.