• EnglishEspañol日本語한국어Português
  • ログイン今すぐ開始

この機械翻訳は参考用に提供されます。

英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、 を参照してください。

問題を作成する

Partnership APIリファレンス

このドキュメントでは、Partnership API の使用に関する技術的な詳細を説明します。導入および要件については、まず Partnership API の導入 をお読みください。

要件

パートナーシップAPIは、New Relicの担当者から使用するように特に指示されていない限り、組織では利用できません。

要件については、 Intro to Partnership API を参照してください。

Partnership API キーの検索

Partnership API では、 REST API キー で認証する必要があります。これは、お客様の パートナーシップオーナーアカウント に固有のものです(他の REST API キー は使用できません)。

パートナーシップ API キーを REST API (v2) のエンドポイントへの呼び出しで使用する場合は、 管理者ユーザーの API キー管理者ユーザーの API キーとパートナーシップ を参照してください。

パートナーIDの検索

パートナーシップ API では、パートナーシップに固有の Partner ID を提供して認証することも必要です。これは、パートナーシップオーナーアカウントの アカウントID とは異なります。

パートナーIDを取得するには、 パートナー管理コンソール にアクセスして、お客様のURLに記載されているパートナーID番号を取得してください。

https://partner-admin-console.newrelic.com/accounts/​$ACCOUNT_ID/admin_console/partnerships/$PARTNER_ID

パートナーAPIのベースURLの一部にパートナーIDを含める必要があります。

URLコンポーネント

URLパターン

パートナーAPIエンドポイント

https://rpm.newrelic.com/api/v2/partners/PARTNER_ID

リソースのURLパターン

/accounts
/accounts/ACCOUNT_ID
/accounts/ACCOUNT_ID/users
/accounts/ACCOUNT_ID/users/USER_ID
/accounts/ACCOUNT_ID/subscriptions
/accounts/ACCOUNT_ID/subscriptions/SUBSCRIPTION_ID

https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID

APIコールの認証を行う

APIコールを行う際にPartner APIを認証するため。

  1. x-api-key というラベルのついたリクエストヘッダーを追加し、その値に Partner API key を設定します。
  2. パートナーID をリクエストURIの指定された箇所に含めてください。

New Relicのアカウントを管理するパートナー様への注意事項

顧客の New Relic アカウントを管理するパートナーの場合、すべてのアカウント レベルのやり取りに対する最初の API 呼び出しは「アカウントの作成」です。この呼び出しは、新しく作成されたアカウントの xml レコードを返します。このレコードの一部はaccount_idです。Partnership API の他のすべての呼び出しでは、パラメーターとしてaccount_idが必要です。パートナーは、返された xml 抽出を解析し、 account_idを保存して、それをユーザーのパートナー アカウント レコードに関連付ける準備を行う必要があります。

エラー

New Relic は従来の HTTP レスポンス コードを使用して、API リクエストの成功または失敗を示します。通常、 2xx範囲のコードは成功を示し、 4xx範囲のコードは提供された情報に起因するエラー (たとえば、必要なパラメーターが欠落していた) を示します。

エラー

確たる理由

400 Bad Request

ほとんどの場合、コールに必要なパラメータが不足しています。

401 認証されていない

有効なAPIキーが提供されていませんでした。

402 リクエストの失敗

パラメータは有効でしたが、何らかの理由でリクエストが失敗しました。

404 Not Found

リクエストされたアイテムは存在しません。

422 未処理のエンティティー

お客様のアカウントには特別な条件があり、変更することはできません。

Copyright © 2024 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.