SendData

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

JSON 데이터를 Cloud Insight Collector로 전송합니다.

요청

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

메서드	URI
POST	/cw_collector/real/data

요청 헤더

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

참고

싱가포르 리전(SGN)인 경우, 요청 헤더에 X-NCP-REGION_NO=7를 반드시 추가해야 데이터 집계 및 Event가 정상적으로 동작합니다.

요청 바디

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

필드	타입	필수 여부	설명
`cw_key`	String	Required	상품 키(cw_key) Cloud Insight 지표 참조
`data`	Object \| Array	Required	JSON 데이터 미리 정의한 데이터 입력 데이터는 `{key}:{value}` 형태로 입력

참고

요청 입력 시 다음 사항을 참고해 주십시오.

cw_key가 없는 레코드는 무시되고 폐기됩니다.
레코드가 있는 데이터 요소에는 정의된 하나 이상의 Metric 필드 또는 Dimension 필드가 포함될 수 있습니다.

요청 예시

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

curl --location --request POST 'https://cw.apigw.gov-ntruss.com/cw_collector/real/data' \
--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 '{
  "cw_key": "**********",
  "data": {
      "cpu": 1.5,
      "sessionCount": 1290,
      "trafficIn": 12984721,
      "instanceId": "**********"
  }
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`result`	String	-	응답 결과 메시지
`dataId`	Integer	-	전송 데이터 아이디
`message`	String	-	전송 데이터 설명

응답 상태 코드

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

응답 예시

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

{
    "result":"success",
    "dataId":-1,
    "message":""
}