このドキュメントでは、 Partnership API を使ってユーザーを追加・管理する方法を説明しています。
要件 パートナーシップAPIは、New Relicの担当者から使用するように特に指示されていない限り、組織では利用できません。
ユーザオブジェクトを使用できるのは、あなたの組織が当社のオリジナルのユーザモデルのユーザを持っている場合のみです。API を使用する前に、 Partnership API requirements をお読みください。
ユーザーオブジェクトの属性 ユーザーオブジェクトは、お客様の情報を保存します。1つのアカウントに1人以上のユーザーを関連付けることができます。また、特定のユーザーが複数のアカウントに関連付けられることもあります。
これは、ユーザーオブジェクトの属性のリストです。New Relic アカウントの作成時に、 owner 属性を 1 人のユーザーに割り当てていることを確認してください。
重要 New Relic では、1 ユーザーあたり最大 1,000 アカウントまでを推奨しています。アカウント数が増えると、New Relic の一部の機能へのアクセスが制限される場合があります。
Eメール (新規ユーザーの場合は必須) この属性は、新規ユーザーには 必須 です。
ユーザーの電子メールアドレスです。このメールアドレスにすでにユーザーレコードが存在する場合は、このアカウントにリンクされます。現在のユーザーオブジェクト作成プロセスでの設定は無視されます。
特殊文字を含む電子メール名には、URL エンコードが必要です。たとえば、 +
の代わりに、URL エンコードされた置換%2B
を使用します。
パスワード (新規ユーザーの場合は必須) この属性は、新規ユーザーには 必須 です。
メールアドレスが既存のユーザレコードと一致する場合、このユーザのパスワードは無視されます。Partnership API バージョン 2 では、アカウント作成コールの一部として渡されるパスワードは、 要件 を満たす必要があります。
注意 アカウントプロビジョニングコールの一部として渡されたパスワードがこのフォーマットに準拠していない場合は、エラーが発生し、操作が失敗する原因となります。
first_name (新規ユーザーの場合は必須) この属性は、新規ユーザーには 必須 です。
このユーザーのファーストネームです。
last_name (新規ユーザーの場合は必須) この属性は、新規ユーザーには 必須 です。
このユーザーのラストネームです。
所有者 (オーナー) このユーザーがアカウントの所有者 であるかどうかを示すフラグ。 New Relicアカウントを作成するときは、1人のユーザーに所有者 の役割を割り当てる必要 があります。
role (新規ユーザーの場合は必須) この属性は、新規ユーザーには 必須 です。
役割 この人のために。
ユーザーコール ここでは、ユーザー関連のAPI機能のURLパターンをご紹介します。このURLパターンを使用する場合は、JSONリクエストボディとともに、 Partner API Key を含むHTTPヘッダを送信してください。例えば、以下のようになります。
GET .../api/v2/partners/PARTNER_ID/accounts/ID
x-api-key:PARTNER_ACCOUNT_KEY
Content-Type: application/json
電話
リソースのURLパターン
リスト (インデックス)アカウントの全ユーザー。
GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users
更新 アカウントの人の役割を変更します。
PUT /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users/ID
Create (add) a user to an account.
1回のPOST操作で作成できるユーザーは1人だけです。
POST /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users
アカウントからユーザーを削除 します。
ユーザーを削除すると、指定したアカウントからそのユーザーが削除されます。Partnership API を通じてオーナーをアカウントから削除することはできません。
DELETE /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users/ID
ユーザーオブジェクトのJSONの例 本APIを使用する前に、 要件 をお読みください。
以下は、Partnership API のユーザーオブジェクトを使用した JSON リクエストとレスポンスの例です。
ユーザーオブジェクトのJSONリクエスト "email": "jsmith@gmail.com",
"password": "testing123",
JSONレスポンス 以下は、そのアカウントのユーザーをリストアップしたJSONレスポンスの例です。
"email": "user-name1@company.com",
"email": "user-name2@company.com",
"email": "user-name3@company.com",
ユーザーオブジェクトAPIの例 以下は、Partnership API ユーザーオブジェクトを使用した API コールの例です。
リスト リストリクエスト
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/12345/users
応答:
{"users":[{"id":12345,"email":"xx@newrelic.com","role":"admin","owner":1}]}
1,000人以上のユーザーがいるアカウントでは、ページ分割されたレスポンスが返されます。
ページを指定するには、クエリに?page=
パラメータを追加します。
クリエイト 重要 POST コマンドごとに作成できる新しいusers
オブジェクトは 1 つだけです。
リクエストを作成します。
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
-d '{"users":[{"email": "foobar@newrelic.com", "password":"password1", "first_name":"John", "last_name":"Doe", "role":"admin" }]}' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/12345/users
応答(改行は読みやすさのため)。
{"users":[{"id":12345,"email":"xx@newrelic.com","role":"admin","owner":1},
{"id":23456,"email":"foobar@newrelic.com","role":"admin","owner":0}]}
アップデート アップデートの依頼。
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
-d '{"users":[{"role": "restricted"}]}' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/12345/users/23456
レスポンス(読みやすさのために改行しています)
{"users":[{"id":12345,"email":"xx@newrelic.com","role":"admin","owner":1},
{"id":23456,"email":"foobar@newrelic.com","role":"restricted","owner":0}]}
削除 リクエスト:
-H 'x-api-key:PARTNER_ACCOUNT_KEY' \
-H 'Content-Type:application/json' \
https://rpm.newrelic.com/api/v2/partners/PARTNER_ID/accounts/12345/users/23456
応答します。レスポンスボディはありません。