NerdGraph API のサブスクリプションプロビジョニング機能は、 New Relic パートナー として、お客様のアカウントにサブスクリプションを作成することができます。また、 Partner API よりも広範囲の New Relic 製品にアクセスすることができます。
要件
- New Relicの担当者から特に指示がない限り、サブスクリプションのプロビジョニングを調整するためにNerdGraphを使用しない必要があります。
- パートナーアカウント で、弊社の オリジナル価格モデル をご利用の方に限ります。
NerdGraphのプロビジョニング機能と、 Partnership API は、両者がサポートする製品(APM、Mobile、Insights、Browser、Synthetics、Infrastructure)に関しては互換性があります。NerdGraphを使用して新しい製品のサブスクリプションを作成した場合、Partnership APIを使用してアカウントを更新することはできなくなります。
はじめに:エンドポイントとAPIキー
NerdGraphの基礎知識については、 Introduction to NerdGraph をご覧ください。
NerdGraphプロビジョニング機能は、 organizationProvisioningUpdatePartnerSubscription
と呼ばれるミューテーションを使用します。特定のアカウントにサブスクリプションを変更するリクエストの例を次に示します。
curl -v -d'{"query": "mutation { organizationProvisioningUpdatePartnerSubscription(accountId: PARTNER_ACCOUNT_ID, affectedAccountId: ACCOUNT_ID, products: [{id: 9200, name: \"Traces\", unitsOfMeasure: [{unit: SPANS_IN_MILLIONS, quantity: 40}]}]) {enqueued errors {message path } } }"}' -H'Content-type: application/json' -H'Api-key: YOUR_USER_KEY' https://api.newrelic.com/graphql
あるアカウントの製品サブスクリプション
NerdGraphでは、アカウントの個々の製品サブスクリプションをアップグレードまたはダウングレードすることはできません。代わりに、APIでは、アカウントのすべての製品サブスクリプションの構成を置き換える(add )必要があります。
ヒント
製品構成が含まれていない場合、NerdGraphは自動的に無料の製品(利用可能な場合)をアカウントにプロビジョニングします。
製品のマッピング(productId)
アカウント作成の呼び出しごとに、少なくとも1つのNewRelic製品タイプを提供する必要があります。ミューテーションクエリは、タイプの数値productId
のみを受け入れます。
GraphQLの種類
NerdGraphのプロビジョニング機能は、以下のGraphQLタイプを使用する。
例
ここでは、サブスクリプションを作成するためのAPIコールと、そのJSONレスポンスの例を示します。
Partnership APIのバリエーション
これらは、NerdGraphのプロビジョニング機能とPartner APIとの主な違いであり、Partner APIを頻繁に使用する方には知っておいていただきたいものです。
機能 | 説明 |
---|---|
APIキー | NerdGraph は . Partner API は、 Partnership API key を使用しています。 |
| NerdGraphのプロダクトIDは、 Partnership API で使用されているものとは異なります。 |
Curlリクエストフォーマット | NerdGraph に curl リクエストを行う場合、そのフォーマットは Partnership API とは異なります。
|
サーバーレス |
|
インサイトとモバイルは2つの単位が必要 | インサイトには |
ログのデータ保持の単位がproductIDで決まる | これは製品名で指定されています。
|