このドキュメントでは、 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.
ユーザオブジェクトを使用できるのは、あなたの組織が当社のオリジナルのユーザモデルのユーザを持っている場合のみです。API を使用する前に、 Partnership API requirements をお読みください。
ユーザーオブジェクトの属性 ユーザーオブジェクトは、お客様の情報を保存します。1つのアカウントに1人以上のユーザーを関連付けることができます。また、特定のユーザーが複数のアカウントに関連付けられることもあります。
これは、ユーザー オブジェクト内の属性のリストです。 New Relic アカウントを作成するときは、必ず 1 人のユーザーにowner 属性を割り当ててください。
重要 New Relic では、1 ユーザーあたり最大 1,000 アカウントまでを推奨しています。アカウント数が増えると、New Relic の一部の機能へのアクセスが制限される場合があります。
Eメール (新規ユーザーの場合は必須) この属性は新規ユーザーの場合required です。
ユーザーの電子メールアドレスです。このメールアドレスにすでにユーザーレコードが存在する場合は、このアカウントにリンクされます。現在のユーザーオブジェクト作成プロセスでの設定は無視されます。
特殊文字を含む電子メール名には、URL エンコードが必要です。たとえば、 +
の代わりに、URL エンコードされた置換%2B
を使用します。
パスワード (新規ユーザーの場合は必須) この属性は新規ユーザーの場合required です。
メールアドレスが既存のユーザレコードと一致する場合、このユーザのパスワードは無視されます。Partnership API バージョン 2 では、アカウント作成コールの一部として渡されるパスワードは、 要件 を満たす必要があります。
注意 アカウントプロビジョニングコールの一部として渡されたパスワードがこのフォーマットに準拠していない場合は、エラーが発生し、操作が失敗する原因となります。
first_name (新規ユーザーの場合は必須) この属性は新規ユーザーの場合required です。
このユーザーのファーストネームです。
last_name (新規ユーザーの場合は必須) この属性は新規ユーザーの場合required です。
このユーザーのラストネームです。
所有者 (オーナー) このユーザーがアカウントの所有者 であるかどうかを示すフラグ。 New Relic アカウントを作成するときに、1 人のユーザーにowner ロールを割り当てmust 。
role (新規ユーザーの場合は必須) この属性は新規ユーザーの場合required です。
役割 この人のために。
ユーザーコール ここでは、ユーザー関連の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パターン
List (インデックス) アカウントのすべてのユーザー。
GET /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users
Update アカウント内の人物の役割。
PUT /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users/ID
Create アカウントにユーザーを追加します。
1回のPOST操作で作成できるユーザーは1人だけです。
POST /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users
Delete アカウントからのユーザー。
ユーザーを削除すると、指定したアカウントからそのユーザーが削除されます。Partnership API を通じてオーナーをアカウントから削除することはできません。
DELETE /api/v2/partners/PARTNER_ID/accounts/ACCOUNT_ID/users/ID
ユーザーオブジェクトのJSONの例 Before using this API, read the requirements .
以下は、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
応答します。レスポンスボディはありません。