ユーザーの更新
put
/iam/governance/selfservice/api/v1/users
リクエスト・ペイロードで指定されたユーザー属性のリストで1つ以上のユーザーを更新します。ユーザーは、変更ユーザー・アクションの実行に必要な権限を持っている必要があります。
リクエスト
サポートされているメディア・タイプ
- application/json
更新するユーザーの属性リスト。"id"は必須フィールドです。"id"フィールドはユーザーのusr_key属性にマップされます。
レスポンス
サポートされているメディア・タイプ
- application/json
200レスポンス
成功
ヘッダー
- ResponseTime: string
リクエストの処理にかかった時間(ミリ秒)を取得します。
401レスポンス
未認可
403レスポンス
禁止
404レスポンス
リソースが見つからない
500レスポンス
内部サーバー・エラー
例
ここでは、1つのリクエストで複数のユーザーを更新する機能を示します。成功と失敗の両方を示しています。ここで表示された情報は疑似システムに対するものであり、プロトタイプとして使用します。
cURLの例
curl -H "Content-Type: application/json" -X PUT -u username:password -d @put.json https://pseudo.com/iam/governance/selfservice/api/v1/users
PUTリクエスト本文の例
次の例に、JSON形式のリクエスト本文のコンテンツを示します。
{
"users": [
{
"requestId": "123",
"id": "5025",
"fields": [
{
"name": "First Name",
"value": "UpdatedFN"
}
]
},
{
"requestId": "123",
"id": "505",
"fields": [
{
"name": "First Name",
"value": "UpdatedFN1"
}
]
}
]
}
PUTレスポンス本文の例
JSON形式のレスポンス本文のコンテンツの例を次に示します。
{
"users": [
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/5025"
}
],
"requestId": "123",
"status": " SUCCESS",
"id": "5025",
"fields": [
{
"name": "name",
"value": "FName LName"
},
{
"name": "iam_requestId",
"value": "5050"
}
]
},
{
"links": [
{
"rel": "self",
"href": "http://pseudo.com/iam/governance/selfservice/api/v1/users/505"
}
],
"requestId": "123",
"status": " FAIL",
"reason": "IAM-2040028:User does not exists:",
"id": "505",
"fields": [
]
}
]
}