이 문서에서는 Partnership API 를 사용하여 계정을 관리하는 방법을 설명합니다. 하위 계정의 경우 하위 계정 개체를 사용합니다.
요구 사항
이 API를 사용하기 전에 다음 사항에 유의하십시오.
- 이 API는 귀하의 조직이 New Relic 담당자로부터 사용하도록 지시받지 않는 한 사용할 수 없습니다.
- 이 특정 개체를 사용하는 데 대한 액세스 권한이 없을 수 있습니다. 사용하기 전에 먼저 요구 사항 을 읽으십시오.
계정 개체 속성
다음은 Partnership API 계정 개체의 속성입니다.
계정 API에는 하위 계정을 생성하는 속성이 포함되어 있지 않습니다. 대신 하위 계정을 만들려면 Account settings 뉴렐릭 UI 에서 상위 계정의 페이지를 사용하세요.
계정 API 호출
다음은 계정 API 기능에 대한 URL 패턴입니다. 이 URL 패턴을 사용하는 경우 JSON 요청 본문과 함께 파트너 API 키 가 포함된 HTTP 헤더를 보냅니다. 예를 들어:
GET .../api/v2/partners/:PARTNER_ID/accounts/:IDx-api-key: :PARTNER_ACCOUNT_KEYContent-Type: application/json
{ JSON data }
부르다 | 리소스 URL 패턴 |
---|---|
파트너의 모든 계정을 나열합니다(index). |
|
Show 계정의 속성. |
|
Update 계정의 속성. |
|
Create 해당 계정을 사용하여 활동합니다. |
|
Cancel 계좌. |
|
상태 정의
API 호출로 계정이 생성되거나 나열되면 계정 상태가 자동으로 포함됩니다. 이러한 상태 중 일부는 모든 가격 책정 모델에 적용되지 않습니다.
계정 상태 | 정의 |
---|---|
| 무료 계정이 생성되었지만 기본 관리자가 아직 활성화되지 않았습니다. |
| 유료 구독으로 생성된 계정이지만 기본 관리자가 아직 활성화되지 않았습니다. |
| 무료 계정, 활성 기본 관리자, 애플리케이션 데이터가 수집되지 않았습니다. |
| 유료 구독, 활성 기본 관리자, 애플리케이션 데이터가 수집되지 않았습니다. |
| 무료 구독, 애플리케이션 데이터 수신. |
| 유료 구독, 애플리케이션 데이터 수신. |
| 계정의 구독이 업그레이드되었습니다. |
| 계정의 구독이 다운그레이드되었습니다. |
| New Relic 계정 구독이 취소되었습니다. |
| 기본 관리자가 이메일 주소를 확인하지 않았기 때문에 New Relic 계정이 일시 중지되었습니다. |
JSON 예시
다음은 Partnership API 계정 개체를 사용한 JSON 요청 및 응답의 예입니다.
이는 예시일 뿐이며 일부 계정의 경우 users
및 subscriptions
속성 이 필요하지 않으며 무시됩니다.
계정 객체 API 예시
1000개 이상의 계정이 있는 파트너십은 페이지를 매긴 응답을 반환합니다. 페이지를 지정하려면 쿼리에 다음 매개변수를 추가합니다.
?page=
다음은 Partnership API 계정 개체를 사용한 호출의 예입니다. Note that these are examples, and that for some accounts, the users
and subscriptions
attributes don't apply and will be ignored.