• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

NRQL 조회 API

NRQL 조회 API를 사용하여 조회 테이블을 생성하고 관리합니다.

시작하기 전에

NRQL 조회 API는 프로그래밍 방식으로 조회 테이블을 관리할 수 있는 REST API입니다. 또 다른 옵션으로 UI를 통해 조회 테이블을 관리 할 수도 있습니다.

HTTP 엔드포인트

기본 URL

API 호출에서 New Relic 계정에 적용 가능한 기본 URL을 사용하세요.

미국(US) 엔드포인트:

https://nrql-lookup.service.newrelic.com

유럽 연합 (EU) 끝점:

https://nrql-lookup.service.eu.newrelic.com

끝점

방법

끝점

설명

create

POST /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

새 테이블을 업로드합니다.

update

PUT /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

기존 테이블을 교체합니다.

read

GET /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

이전에 업로드한 테이블을 다운로드합니다.

delete

DELETE /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

해당 테이블을 삭제합니다.

list

GET /v1/accounts/YOUR_ACCOUNT_ID

이 계정에 대해 이전에 업데이트된 테이블을 나열합니다.

위의 NRQL 조회 API 엔드포인트에 필요한 변수는 아래에 정의되어 있습니다.

변하기 쉬운

유형

설명

YOUR_ACCOUNT_ID

number

테이블이 속한 계정

TABLE_NAME

string

저장된 테이블의 이름입니다. 테이블 이름은 사용자 정의 이벤트 유형 표준을 준수해야 합니다.

  • 최대 길이: 255
  • 영숫자, 밑줄, 콜론을 조합하여 사용할 수 있습니다.

입증

당신의 NRQL Lookups API에 대한 요청을 인증하는 데 사용되며 HTTP 헤더로 전달되어야 합니다.

머리글

지원되는 값

Api-Key

New Relic .

테이블 생성/업데이트

HTTP 엔드포인트

만들다

POST /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

새 테이블을 업로드하는 데 사용됩니다. 테이블이 이미 존재할 수 없습니다. 그렇다면 이 호출로 인해 400 Bad Request 응답이 발생합니다.

업데이트

PUT /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

기존 테이블을 바꾸는 데 사용됩니다. 테이블이 존재하지 않으면 이 호출로 인해 404 Not Found 응답이 발생합니다.

요청 쿼리 매개변수

이름

유형

기본값

설명

includeTable

boolean

false

응답에 테이블 값을 포함할지 여부를 나타냅니다.

HTTP 헤더

HTTP 헤더를 생성할 때 다음 지침을 사용하십시오.

머리글

지원되는 값

Content-Type

  • multipart/form-data
  • application/json

Accept

  • application/json

요청 본문

요청 본문으로 보내는 데이터는 multipart/form-data 또는 application/json 일 수 있습니다.

응답 본문

요청이 성공하면 응답 JSON 페이로드에 다음 필드가 포함될 수 있습니다.

값 유형

설명

accountId

number

테이블이 속한 계정입니다. 이는 경로의 계정 값과 일치합니다.

name

string

저장된 테이블의 이름입니다. 이는 경로의 이름 값과 일치합니다.

description

string

테이블에 대한 자세한 설명

guid

string

테이블 생성 시 테이블에 할당된 GUID입니다.

size

number

CSV 문자열 형식의 테이블 크기입니다.

rows

number

테이블의 행 수(머리글 행 제외)

updatedBy

string

이 테이블을 생성하거나 마지막으로 업데이트한 마지막 사용자의 사용자 이름/이메일 주소입니다.

updatedAt

string

테이블이 생성되거나 마지막으로 업데이트된 타임스탬프입니다. 이는 S3 객체의 마지막 업데이트 타임스탬프를 반영합니다. 값은 표준 ISO 8601 날짜 시간 문자열(예: 2023-02-13T19:49:28.023Z)

table

JSON 객체 리터럴

headers

테이블의 열 이름을 나타내는 string 값의 배열

rows

테이블의 값을 나타내는 배열의 배열입니다.

예제 응답 JSON 페이로드

{
"accountId": YOUR_ACCOUNT_ID,
"name": "sample",
"guid": "eac37270-7c02-4ca9-b178-8be5748b5b09",
"size": 120
"rows": 3
"updatedBy": "jondoe@example.com"
"updatedAt": "2023-02-13T19:49:28.023Z",
"table": {
"headers": [
"id", "name", "description", "intvalue", "floatvalue", "boolvalue"
],
"rows": [
[1, "abc", 27, 2.7, true],
[2, "def", 2622, 26.22, false],
["2a", "d,ef", 1234, 43.21, false]
]
}
}

예시 요청

표 읽기

HTTP 엔드포인트

GET /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

이전에 업로드된 테이블을 다운로드하는 데 사용됩니다. 테이블이 존재하지 않으면 이 호출로 인해 404 Not Found 응답이 발생합니다. 이 엔드포인트에는 요청 페이로드가 없습니다.

요청 쿼리 매개변수

이름

유형

기본값

설명

includeTable

boolean

false

응답에 테이블 값을 포함할지 여부를 나타냅니다. 콘텐츠 유형이 text/csv 인 경우 무시됩니다.

HTTP 헤더

HTTP 헤더를 생성할 때 다음 지침을 사용하십시오.

머리글

지원되는 값

Accept

  • application/json
  • text/csv

응답 본문

요청이 성공하면 응답은 application/json 또는 text/csv 유형일 수 있습니다.

application/json 유형의 응답

응답은 생성/업데이트 응답 페이로드 와 동일합니다.

text/csv 유형의 응답

응답에는 CSV 형식의 테이블이 포함됩니다.

예시 요청

테이블 삭제

HTTP 엔드포인트

DELETE /v1/accounts/YOUR_ACCOUNT_ID/TABLE_NAME

해당 테이블을 삭제하는 데 사용됩니다. 테이블이 존재하지 않으면 이 호출로 인해 404 Not Found 응답이 발생합니다. 이 엔드포인트에는 요청 페이로드가 없습니다.

중요

삭제된 테이블은 복구할 수 없습니다.

요청 쿼리 매개변수

이름

유형

기본값

설명

includeTable

boolean

false

응답에 테이블 값을 포함할지 여부를 나타냅니다.

HTTP 헤더

HTTP 헤더를 생성할 때 다음 지침을 사용하십시오.

머리글

지원되는 값

Accept

  • application/json

응답 본문

요청이 성공하고 Accept 헤더가 application/json 로 설정된 경우 응답 본문은 생성/업데이트 응답 페이로드 와 동일합니다.

예시 요청

테이블 나열

HTTP 엔드포인트

GET /v1/accounts/YOUR_ACCOUNT_ID

이 계정에 대해 이전에 업데이트된 테이블을 나열합니다. 이 엔드포인트에는 요청 페이로드가 없습니다.

HTTP 헤더

HTTP 헤더를 생성할 때 다음 지침을 사용하십시오.

머리글

지원되는 값

Accept

  • application/json

응답 본문

요청이 성공하면 응답 JSON 페이로드는 테이블 요약 배열로 구성됩니다. 각 테이블 요약에는 아래 필드가 포함될 수 있습니다.

값 유형

설명

accountId

number

테이블이 속한 계정입니다. 이는 경로의 계정 값과 일치합니다.

name

string

저장된 테이블의 이름입니다. 이는 경로의 이름 값과 일치합니다.

description

string

테이블에 대한 자세한 설명

guid

string

테이블 생성 시 테이블에 할당된 GUID입니다.

size

number

CSV 문자열 형식의 테이블 크기입니다.

rows

number

테이블의 행 수(머리글 행 제외)

updateBy

string

이 테이블을 업데이트한 마지막 사용자의 사용자 이름/이메일 주소입니다.

updatedAt

string

테이블이 생성되거나 마지막으로 업데이트된 타임스탬프입니다. 이는 S3 객체의 마지막 업데이트 타임스탬프를 반영합니다. 값은 표준 ISO 8601 날짜 시간 문자열(예: 2023-02-13T19:49:28.023Z)

예시 요청

오류 메시지

요청이 실패하면 오류 응답 페이로드는 아래 형식이 됩니다.

{
"code": HTTP_STATUS_CODE(same as status header),
"message": ERROR_MESSAGE
}
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.