このドキュメントでは、 Partnership API を使用して、 元の料金モデル でアカウントのサブスクリプションを管理する方法について説明します。
要件 The Partnership API is not available to your organization unless you're specifically instructed by your New Relic representative that you should use it.
サブスクリプションオブジェクトは、元の料金モデルを使用している場合にのみ使用できます。新しい使用量ベースの料金モデルの アカウントはサポートされていません。詳細については、 PartnershipAPIの要件 をご覧ください。
パートナーシップ API では、アカウントの個々の製品サブスクリプションをアップグレードまたはダウングレードすることはできません。 代わりに、 API 、アカウントの all 製品サブスクリプションの設定を置き換える (追加する ) 必要があります。
製品構成が含まれていない場合、New Relic Partnership APIは、利用可能な最高の無料製品タイプでアカウントをプロビジョニングします。 APIは、アカウントのパートナーシップの構成とカスタム価格に基づいて製品レベルを自動的に選択します。
サブスクリプションオブジェクトの属性 これを使用する前に、まず要件 をお読みください。
サブスクリプションオブジェクトの属性は次のとおりです。
product_id(新規サブスクリプションに必要) product ID
属性は、このサブスクリプションに対して定義されている New Relic 製品を識別します。 Create の呼び出しでrequired です。
数量(新規サブスクリプションに必要) 製品レベルが無制限の場合でも、 Create 呼び出しのquantity
属性はrequired です。 API は、New Relic APM Lite などの無制限の製品サブスクリプションに入力された数量の値を無視します。
New Relic Insights、Browser、およびSyntheticsでは、事前定義された使用レベル(製品バケット) を特定する必要があります。これにより、APIは、選択した特定の数量に基づいて価格割引を適用できます。
識別する数量は、製品およびサブスクリプションレベルと完全に一致する必要があります。使用可能な製品バケットのリストについては、以下を参照してください。
このサブスクリプションに関連するプロモーションコード。
パートナーシップ API のサブスクリプション エンドポイントではまだサポートされていません。 ただし、アカウント API のCreate 呼び出し を使用して、サブスクリプションの一部としてpromo_code
を渡すことができます。
data_retention(Insightsサブスクリプションにのみ必要) 製品のマッピング(product_id) アカウント作成の呼び出しごとに、少なくとも1つのNewRelic製品タイプを提供する必要があります。 APIは、タイプの数値product_id
のみを受け入れます。
重要 サブスクリプションオブジェクトは、 元の料金モデル を使用しているアカウントにのみ適用されることに注意してください。
また、サーバーレス、ログ、トレースのサブスクリプションの作成は、PartnershipAPIではサポートされていません。アカウントにこれらのサブスクリプションがある場合、変更を行おうとするとエラーが返されます。サブスクリプションを変更するには、アカウントエグゼクティブにお問い合わせください。
重要 新しいStartup およびSmall Business サービス プランは、New Relic Partnership API を通じて利用できなくなりました。
APM アカウントごとに許可されるホストの数とデータ保持期間は、NewRelicAPMの料金体系内のサブスクリプションレベルによって異なります。たとえば、New Relic APMでは、Liteアカウントに許可されるホストの数に制限はありませんが、データ保持期間は24時間のみです。
また、料金とデータ保持期間は、ホストベースの料金モデルを選択するか、コンピュートユニット (CU) ベースの料金モデルを選択するかによって異なります。 サブスクリプション レベルとプランの種類を識別するには、製品 ID のinteger 形式を使用します。
APM subscription level
Product ID
Lite
1
標準
2
標準年次
3
プロ(ホスト)
4
プロアニュアル(ホスト)
5
企業
6
エンタープライズアニュアル
7
APM Essentials(ホスト)
8
APM Essentials Annual(ホスト)
9
コンピュートユニット (CU) に基づいて料金プランを選択する場合は、これらの製品 ID integer 形式を使用して、サブスクリプション レベルとプランの種類を識別します。
APM Compute Units (CU) subscription level
Product ID
プロCU
26
プロアニュアルCU
27
APM Essentials CU
28
APM Essentials Annual CU
29
モバイル New Relic Mobileの価格体系では、エンタープライズ サブスクリプション レベルでアカウントあたり月間 100,000 人のアクティブ ユーザーが許可されます。 データ保持期間はサブスクリプションレベルによって異なります。 サブスクリプションレベルを識別するには、製品 ID のinteger 形式を使用します。
Mobile subscription level
Product ID
Lite
10
企業
13
エンタープライズアニュアル
14
インサイト New Relic Insightsは、保存される許容可能なイベントの数と関連するデータ保持ポリシーに基づいて料金体系を決定します(たとえば、Insights Freeのデータ保持は1日です)。 data_retention
属性 が必要であることに注意してください。
Insights subscription level
Product ID
無料
15
なし
16
プロ
18
プロアニュアル
19
ブラウザ New Relic Browserの料金体系では、サブスクリプションレベルに関係なく、無制限の数のアプリユーザーが許可されます。ただし、1か月あたりの許容ページビュー数とデータ保持期間は、サブスクリプションレベルによって異なります。例えば:
Liteアカウントには、1か月あたりのページビュー数に制限がなく、24時間のデータ保持が含まれます。
プロアカウントの価格は、月額500,000ページビューと3か月のデータ保持から始まります。
サブスクリプションレベルを識別するには、製品 ID のinteger 形式を使用します。
Browser subscription level
Product ID
Lite
20
プロ
21
プロアニュアル
22
シンセティックス 外形監視の料金体系では、サブスクリプションレベルによって、許可される監視チェックのデフォルトの回数とデータ保持期間が異なります。 サブスクリプションレベルを識別するには、製品 ID のinteger 形式を使用します。
Synthetics subscription level
Product ID
Lite
23
プロ
24
プロアニュアル
25
ヒント 以前に非推奨のPartnership可用性監視APIを使用していた場合は、合成監視API を使用してチェックをプロビジョニングし、 REST APIを使用 してアラートをプロビジョニングし、顧客へのアラート通知を作成できます。
インフラストラクチャー New Relicのインフラストラクチャの料金体系では、デフォルトのインスタンス数とデータ保持期間はサブスクリプションレベルによって異なります。 インフラストラクチャイベント は、Insightsでクエリを実行できますが、NewRelicInsightsのクォータにはカウントされません。
New Relic Infrastructureコンピュートユニット (CU) のみに基づいた料金プランを提供します。 サブスクリプションレベルを識別するには、製品 ID のinteger 形式を使用します。
Infrastructure subscription level
Product ID
インフラストラクチャなし
31
インフラストラクチャプロ(CU)
32
インフラストラクチャプロアニュアル(CU)
33
インフラストラクチャエッセンシャル(CU)
34
インフラストラクチャエッセンシャルアニュアル(CU)
35
サブスクリプションAPI呼び出し これを使用する前に、まず要件 をお読みください。
サブスクリプション関連のAPI関数のURLパターンは次のとおりです。使用する場合は、JSONオブジェクトとPartnerAPIキー を含むHTTPヘッダーと一緒に送信します。例えば:
GET .../api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
x-api-key:PARTNER_ACCOUNT_KEY
Content-Type: application/json
電話
リソースのURLパターン
List (インデックス) アカウントのすべてのサブスクリプション。
GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
Show アカウントのサブスクリプション。
GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions/ID
Replace 現在の サブスクリプション レベルを新しい サブスクリプション に変更します。
POST /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/subscriptions
サブスクリプションAPIの例 アカウントの元の価格設定モデル サブスクリプションとJSON応答リストサブスクリプションを作成するためのAPI呼び出しの例を次に示します。
JSON応答の例 "starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Mobile Enterprise",
"name": "Synthetics Lite",
"name": "Infrastructure None",
サブスクリプションステータス API呼び出しが返す可能性のある元の価格設定モデル のサブスクリプションステータス値を次に示します。
Subscription status
Description
pending
顧客はNewRelic製品にサインアップしましたが、支払いを処理する必要があります。
authorized
クレジットカードが承認され、ボールトキーが保存されましたが、支払いは取得されていません。
free
このサブスクリプションは、無料のNewRelic製品用です。それ以上の処理は必要ありません。
paid
支払いが取得され、次の支払い日が設定されました。
payment_declined
支払いを承認する最後の試みは失敗しました。
canceled
New Relicアカウントにはアクティブなサブスクリプションがなく、アクティブではありません。支払いは承認または取得されるべきではありません。
replaced
このサブスクリプションは、別のNewRelicサブスクリプションに置き換えられました。
APIの例(v2) これは、 元の価格設定モデルの サブスクリプションを一覧表示、表示、作成、および更新するためのAPIサンプルリクエストとレスポンスです。応答の改行は読みやすさのためです。実際の応答は実線で表示されます。
リスト Request:
-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
Response:
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Synthetics Lite",
"name": "Infrastructure None",
公演 Request:
-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
Response:
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Synthetics Lite",
"name": "Infrastructure None",
新規作成(既存のサブスクリプションを置き換える) これは、Partnership APIを使用して、アカウントの新しいサブスクリプションを作成する(すべての製品の既存のサブスクリプションレベルを置き換える )方法の例です。
Request:
-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
Response:
"starts_on": "2016-05-16",
"annual_renewal_on": null,
"name": "Synthetics Lite",
"name": "Infrastructure None",