이 문서에서는 Partnership API 를 사용하여 원래 가격 모델 에서 계정에 대한 구독을 관리하는 방법을 설명합니다.
요구 사항
New Relic 담당자가 사용해야 한다고 특별히 지시하지 않는 한 Partnership API는 조직에서 사용할 수 없습니다.
원래 가격 책정 모델을 사용하는 경우에만 구독 개체를 사용할 수 있습니다. 최신 사용량 기반 가격 책정 모델 의 계정은 지원하지 않습니다. 이에 대한 자세한 내용은 파트너십 API 요구 사항 을 참조하세요.
Partnership API를 사용하면 계정에 대한 개별 제품 구독을 업그레이드하거나 다운그레이드할 수 없습니다. 대신 API를 사용하려면 계정의 모든 제품 구독에 대한 구성을 교체( 추가 )해야 합니다.
제품 구성이 포함되지 않은 경우 New Relic Partnership API는 사용 가능한 최고의 무료 제품 유형으로 계정을 프로비저닝합니다. API는 계정의 파트너십에 대한 구성 및 사용자 지정 가격을 기반으로 제품 수준을 자동으로 선택합니다.
구독 개체 속성
이것을 사용하기 전에 먼저 요구 사항 을 읽으십시오.
구독 개체의 속성은 다음과 같습니다.
product ID
속성은 이 구독에 대해 정의 중인 New Relic 제품을 식별합니다. Create 호출에 필요 합니다.
quantity
속성은 제품 수준이 무제한인 경우에도 호출 생성 에 필요 합니다. API는 New Relic APM Lite와 같은 무제한 제품 구독에 대해 입력한 수량 값을 무시합니다.
New Relic Insights, Browser 및 Synthetics를 사용하려면 사전 정의된 사용 수준 (제품 버킷) 을 식별해야 합니다. 이를 통해 API는 선택한 특정 수량에 따라 가격 할인을 적용할 수 있습니다.
식별하는 수량은 제품 및 구독 수준과 정확히 일치해야 합니다. 사용 가능한 제품 버킷 목록은 다음을 참조하세요.
이 구독에 대한 모든 관련 프로모션 코드입니다.
Partnership API의 구독 엔드포인트를 통해 아직 지원되지 않습니다. 그러나 계정 API의 Create 호출 을 사용하여 구독의 일부로 promo_code
을 전달할 수 있습니다.
Insights 이벤트 정보가 유지되는 주 수입니다.
제품 매핑(product_id)
각 계정 생성 호출과 함께 최소한 하나의 New Relic 제품 유형을 제공해야 합니다. API는 유형에 대해 숫자 product_id
만 허용합니다.
중요
구독 개체는 원래 가격 책정 모델 을 사용하는 계정에만 적용된다는 점을 기억하세요.
또한 서버리스, 로그 및 추적에 대한 구독 생성은 Partnership API에서 지원되지 않습니다. 계정에 이러한 구독이 있는 경우 변경을 시도하면 오류가 반환됩니다. 구독을 수정하려면 계정 담당자에게 문의하세요.
중요
New Relic Partnership API를 통해 더 이상 New Startup 및 Small Business 서비스 계획을 사용할 수 없습니다.
계정당 허용되는 호스트 수와 데이터 보존 기간은 New Relic APM의 가격 구조 내에서 구독 수준에 따라 다릅니다. 예를 들어 New Relic APM은 Lite 계정에 허용되는 호스트 수에 제한이 없지만 데이터 보존 기간은 24시간입니다.
또한 가격 책정 및 데이터 보존은 호스트 또는 컴퓨팅 단위(CU)를 기반으로 가격 책정 모델을 선택하는지 여부에 따라 달라집니다. 제품 ID의 정수 형식을 사용하여 구독 수준 및 계획 유형을 식별합니다.
APM 구독 수준 | 제품 ID |
---|
라이트 | 1 |
기준 | 2 |
표준 연간 | 삼 |
프로(호스트) | 4 |
프로 연간(호스트) | 5 |
기업 | 6 |
엔터프라이즈 연간 | 7 |
APM Essentials(호스트) | 8 |
APM Essentials 연간(호스트) | 9 |
계산 단위(CU)를 기반으로 가격 책정 계획을 선택하는 경우 이러한 제품 ID 정수 형식을 사용하여 구독 수준 및 계획 유형을 식별합니다.
APM CU(Compute Units) 구독 수준 | 제품 ID |
---|
프로 CU | 26 |
프로 연간 CU | 27 |
APM 에센셜 CU | 28 |
APM Essentials 연간 CU | 29 |
New Relic Mobile의 가격 구조는 Enterprise 구독 수준에서 계정당 월간 활성 사용자 100,000명을 허용합니다. 데이터 보존은 구독 수준에 따라 다릅니다. 제품 ID의 정수 형식을 사용하여 구독 수준을 식별합니다.
모바일 구독 수준 | 제품 ID |
---|
라이트 | 10 |
기업 | 13 |
엔터프라이즈 연간 | 14 |
New Relic Insights는 저장된 허용 가능한 이벤트 수와 관련 데이터 보존 정책(예: Insights Free의 데이터 보존 기간은 1일)을 기반으로 가격 책정 구조를 결정합니다. data_retention
속성 은 필수입니다.
Insights 구독 수준 | 제품 ID |
---|
무료 | 15 |
없음 | 16 |
찬성 | 18 |
프로 연간 | 19 |
New Relic Browser의 가격 구조는 구독 수준에 관계없이 앱 사용자 수에 제한이 없습니다. 단, 월간 허용 페이지뷰 수와 데이터 보유 기간은 구독 등급에 따라 상이합니다. 예를 들어:
라이트 계정에는 월간 무제한 페이지 조회수와 24시간 데이터 보존이 포함됩니다.
Pro 계정 가격은 월별 500,000페이지 뷰 및 3개월 데이터 보존부터 시작됩니다.
제품 ID의 정수 형식을 사용하여 구독 수준을 식별합니다.
브라우저 구독 수준 | 제품 ID |
---|
라이트 | 도면 1 |
찬성 | 21 |
프로 연간 | 22 |
종합 모니터링의 가격 구조에서 허용 가능한 모니터링 검사의 기본 수와 데이터 보존 기간은 구독 수준에 따라 다릅니다. 제품 ID의 정수 형식을 사용하여 구독 수준을 식별합니다.
합성 구독 수준 | 제품 ID |
---|
라이트 | 23 |
찬성 | 24 |
프로 연간 | 25 |
New Relic의 Infrastructure 가격 구조에서는 기본 인스턴스 수와 데이터 보존 기간이 구독 수준에 따라 다릅니다. 인프라 이벤트 는 Insights에서 쿼리할 수 있더라도 New Relic Insights 할당량에 포함되지 않습니다.
New Relic Infrastructure는 컴퓨팅 유닛(CU)만을 기준으로 가격 책정 계획을 제공합니다. 제품 ID의 정수 형식을 사용하여 구독 수준을 식별합니다.
인프라 구독 수준 | 제품 ID |
---|
인프라 없음 | 31 |
인프라 프로(CU) | 32 |
Infrastructure Pro 연간(CU) | 33 |
CU(인프라 필수 요소) | 34 |
CU(Infrastructure Essentials 연간) | 35 |
구독 API 호출
이것을 사용하기 전에 먼저 요구 사항 을 읽으십시오.
구독 관련 API 함수의 URL 패턴은 다음과 같습니다. 사용하는 경우 파트너 API 키 가 포함된 HTTP 헤더 및 JSON 개체와 함께 전송합니다. 예를 들어:
GET .../api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
x-api-key:PARTNER_ACCOUNT_KEY
Content-Type: application/json
부르다 | 리소스 URL 패턴 |
---|
계정의 모든 구독을 나열 (색인)합니다. | GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
|
계정에 대한 구독을 표시 합니다. | GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions/ID
|
현재 구독 수준을 새 구독으로 바꿉니다 . | POST /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
|
구독 API 예시
다음은 계정에 대한 원래 가격 모델 구독 및 JSON 응답 나열 구독을 생성하기 위한 API 호출의 예입니다.
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Mobile Enterprise",
"name": "Synthetics Lite",
"name": "Infrastructure None",
다음은 API 호출이 반환할 수 있는 몇 가지 원래 가격 모델 구독 상태 값입니다.
구독 상태 | 설명 |
---|
pending
| 고객이 New Relic 제품에 가입했지만 여전히 결제가 처리되어야 합니다. |
authorized
| 신용 카드가 승인되고 금고 키가 저장되었지만 지불이 캡처되지 않았습니다. |
free
| 이 구독은 무료 New Relic 제품에 대한 것입니다. 추가 처리가 필요하지 않습니다. |
paid
| 지불이 캡처되었고 다음 지불 날짜가 설정되었습니다. |
payment_declined
| 결제 승인을 위한 마지막 시도가 실패했습니다. |
canceled
| New Relic 계정에는 활성 구독이 없으며 활성 상태가 아닙니다. 지불이 승인되거나 캡처되어서는 안 됩니다. |
replaced
| 이 구독은 다른 New Relic 구독으로 대체되었습니다. |
API 예시(v2)
다음은 원래 가격 모델 구독을 나열, 표시, 생성 및 업데이트하기 위한 API 예제 요청 및 응답입니다. 응답의 줄 바꿈은 가독성을 위한 것입니다. 실제 응답은 연속선으로 나타납니다.
요구:
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
응답:
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Synthetics Lite",
"name": "Infrastructure None",
요구:
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions/SUBSCRIPTION_ID
응답:
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Synthetics Lite",
"name": "Infrastructure None",
다음은 Partnership API를 사용하여 계정에 대한 새 구독을 만드는 방법의 예입니다( 모든 제품에 대한 기존 구독 수준 대체 ).
요구:
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
-d '{"subscriptions":[{"product_id":"1", "quantity":1}]}' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
응답:
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Synthetics Lite",
"name": "Infrastructure None",