New Relic の Partnership API には、パートナー様がお客様の既存のサブスクリプションを新しいものに置き換えたり、New Relic のパートナーアカウントの請求書情報を更新したりするための機能が含まれています。この機能は、New Relic アカウントの再販業者やマネージドサービスプロバイダーとして活動するパートナー様にとって特に便利です。
たとえば、New Relic のリセラーパートナーのお客様が、New Relic のセールスチームからより高いサブスクリプションレベルを購入すると、New Relic は古いサブスクリプションを新しいサブスクリプションに置き換えます。そして、New Relic はこの情報をパートナーに伝えるために API を使用します。
パートナーシップ API は、New Relic の担当者から使用するように特別に指示されない限り、あなたの組織では利用できません。
このオブジェクトを使用する前に、 Partnership API requirements を読んでください。
パートナーは、パートナーの URL と PARTNER_ID を識別する請求書通信エンドポイントを実装する必要があります。New Relic はこのエンドポイントを使用して、New Relic がパートナーアカウントのサブスクリプションまたは請求書の情報に変更を加えたことをパートナーに通知します。エンドポイントは HTTPS に対応している必要があります。
URL のパートナー指定部分は、New Relic の Partner Portal の Settings タブから特定されます。 PARTNER_ID は、このアカウントのパートナーの外部IDです。この値は、 partner_external_identifier パラメータを使用してアカウントを作成する際に渡される必要があります。Partnership billing APIでサポートされている機能は以下の通りです。
カスタマーサブスクリプション通知API 顧客のサブスクリプションに関する変更をパートナーに伝えるために、New Relic はこの URI で POST メソッドを使用します。
https://partner-specified /partner-specified /PARTNER_ID .json認証は、パートナーの REST API キーまたは Admin ユーザーの API キー を含むヘッダーによって行われます。Partnership API は、結果を JSON として返します。
パラメータ。
名前
タイプ
説明
id
文字列
お客様のNew RelicアカウントID
subscription_id
整数
サブスクリプションの数字的なID
subscription_string
文字列
ディスプレイ用サブスクリプションの説明
価格
整数
サブスクリプションの月額価格（単位：セント
ホストの数
整数
ホストの数
スタート
日付
サブスクリプションの開始日（yyyymmdd）
期限切れ
日付
サブスクリプションの終了日(yyyymmdd)
リターンコードです。
200: アップデートに成功しました。 404:アカウントが見つかりません。 422：パラメータがない、または無効です。 認証に失敗しました。 インボイス通知API New Relic はこのエンドポイントを使用して、パートナーアカウントのサブスクリプションレベルや請求書情報の変更をパートナーに通知します。New Relic は、この URI で PUT メソッドを使用します。
https://partner-specified /partner-specified /PARTNER_ID .jsonまたは
https://partner-specified /partner-specified /PARTNER_ID .xmlPartnership API は、JSON または XML として結果を返します。
パラメータ。
名前
タイプ
説明
id
文字列
お客様のNew RelicアカウントID
subscription_id
整数
サブスクリプションの数字的なID
subscription_string
文字列
ディスプレイ用サブスクリプションの説明
価格
整数
サブスクリプションの月額価格（単位：セント
リターンコードです。
200: アップデートに成功しました。 404:アカウントが見つかりません。 422：パラメータがない、または無効です。 認証に失敗しました。