이 문서에서는 Partnership API 를 사용하여 계정을 관리하는 방법을 설명합니다. 하위 계정의 경우 하위 계정 개체를 사용합니다.
요구 사항
이 API를 사용하기 전에 다음 사항에 유의하십시오.
- 이 API는 귀하의 조직이 New Relic 담당자로부터 사용하도록 지시받지 않는 한 사용할 수 없습니다.
- 이 특정 개체를 사용하는 데 대한 액세스 권한이 없을 수 있습니다. 사용하기 전에 먼저 요구 사항 을 읽으십시오.
계정 개체 속성
다음은 Partnership API 계정 개체의 속성입니다.
계정 API에는 하위 계정을 생성하기 위한 속성이 포함되어 있지 않습니다. 대신, 자식 계정을 만들려면 New Relic 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 패턴 |
---|---|
파트너의 모든 계정을 나열( 인덱스 )합니다. |
|
계정의 속성을 표시 합니다. |
|
계정의 속성을 업데이트 합니다. |
|
주어진 매개변수로 계정을 만듭니다 . |
|
계정을 취소 합니다. |
|
상태 정의
API 호출로 계정이 생성되거나 나열되면 계정 상태가 자동으로 포함됩니다. 이러한 상태 중 일부는 모든 가격 책정 모델에 적용되지 않습니다.
계정 상태 | 정의 |
---|---|
| 무료 계정이 생성되었지만 기본 관리자가 아직 활성화되지 않았습니다. |
| 유료 구독으로 생성된 계정이지만 기본 관리자가 아직 활성화되지 않았습니다. |
| 무료 계정, 활성 기본 관리자, 애플리케이션 데이터가 수집되지 않았습니다. |
| 유료 구독, 활성 기본 관리자, 애플리케이션 데이터가 수집되지 않았습니다. |
| 무료 구독, 애플리케이션 데이터 수신. |
| 유료 구독, 애플리케이션 데이터 수신. |
| 계정의 구독이 업그레이드되었습니다. |
| 계정의 구독이 다운그레이드되었습니다. |
| New Relic 계정 구독이 취소되었습니다. |
| 기본 관리자가 이메일 주소를 확인하지 않았기 때문에 New Relic 계정이 일시 중지되었습니다. |
JSON 예시
다음은 Partnership API 계정 개체를 사용한 JSON 요청 및 응답의 예입니다.
이는 예시일 뿐이며 일부 계정의 경우 users
및 subscriptions
속성 이 필요하지 않으며 무시됩니다.
계정 객체 API 예시
1000개 이상의 계정이 있는 파트너십은 페이지를 매긴 응답을 반환합니다. 페이지를 지정하려면 쿼리에 다음 매개변수를 추가합니다.
?page=
다음은 Partnership API 계정 개체를 사용한 호출의 예입니다. 이는 예시이며 일부 계정의 경우 users
및 subscriptions
속성 이 적용되지 않고 무시됩니다.