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

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

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

문제 신고

파트너십 API 참조

이 문서는 Partnership API 사용에 대한 기술적인 세부 사항을 설명합니다. 소개 및 요구 사항은 먼저 Intro to Partnership API 를 읽으십시오.

요구 사항

New Relic 담당자가 사용해야 한다고 특별히 지시하지 않는 한 Partnership API는 조직에서 사용할 수 없습니다.

요구 사항은 파트너십 API 소개를 참조하세요.

파트너십 API 키 찾기

Partnership API를 사용하려면 파트너 관계 소유자 계정 과 관련된 REST API 키로 인증해야 합니다(다른 REST API 키 를 사용할 수 없음).

관리 사용자의 API 키 를 사용해야 하는 REST API(v2) 엔드포인트에 대한 호출과 함께 파트너십 API 키를 사용하는 경우 관리자 의 API 키 및 파트너십 을 참조하십시오.

파트너 ID 찾기

또한 Partnership API를 사용하려면 파트너 관계와 관련된 파트너 ID를 제공하여 인증해야 합니다. 이것은 파트너 관계 소유자 계정의 계정 ID 와 고유합니다.

파트너 ID를 얻으려면 파트너 관리 콘솔 로 이동하여 URL에 나열된 파트너 ID 번호를 검색하십시오.

https://partner-admin-console.newrelic.com/accounts/​$ACCOUNT_ID/admin_console/partnerships/$PARTNER_ID

파트너 API에 대한 기본 URL의 일부로 파트너 ID를 포함해야 합니다.

URL 구성요소

URL 패턴

파트너 API 엔드포인트

https://rpm.newrelic.com/api/v2/partners/PARTNER_ID

리소스 URL 패턴

/accounts
/accounts/ACCOUNT_ID
/accounts/ACCOUNT_ID/users
/accounts/ACCOUNT_ID/users/USER_ID
/accounts/ACCOUNT_ID/subscriptions
/accounts/ACCOUNT_ID/subscriptions/SUBSCRIPTION_ID

예시

https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID

API 호출 인증

API를 호출할 때 파트너 API에 인증하려면 다음 단계를 따르세요.

  1. x-api-key 라는 레이블이 지정된 요청 헤더를 추가하고 해당 값을 파트너 API 키로 설정합니다.
  2. 요청 URI의 지정된 지점에 파트너 ID 를 포함합니다.

New Relic 계정을 관리하는 파트너를 위한 참고 사항

고객을 위해 New Relic 계정을 관리하는 파트너의 경우 모든 계정 수준 상호 작용에 대한 초기 API 호출은 "계정 생성"입니다. 이 호출은 새로 생성된 계정의 xml 레코드를 반환합니다. 이 레코드의 일부는 account_id 입니다. Partnership API의 다른 모든 호출에는 account_id 이 매개변수로 필요합니다. 반환된 xml 추출을 구문 분석하고 account_id 를 저장하고 이를 사용자의 파트너 계정 레코드와 연결하려면 파트너가 프로비저닝해야 합니다.

오류

New Relic은 기존 HTTP 응답 코드를 사용하여 API 요청의 성공 또는 실패를 나타냅니다. 일반적으로 2xx 범위의 코드는 성공을 나타내고 4xx 범위의 코드는 제공된 정보로 인해 발생한 오류를 나타냅니다(예: 필수 매개변수가 누락됨).

오류

가능한 원인

400 잘못된 요청

가장 일반적으로 호출에 필수 매개변수가 누락되었습니다.

401 권한 없음

유효한 API 키가 제공되지 않았습니다.

402 요청 실패

매개변수는 유효하지만 어떤 이유로 요청이 실패했습니다.

404 찾을 수 없음

요청하신 항목이 존재하지 않습니다.

422 처리할 수 없는 개체

귀하의 계정에는 특별 약관이 있으며 변경할 수 없습니다.

Copyright © 2024 New Relic Inc.

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