Skip to content

ユーザーの更新

説明

指定した ID のユーザーを更新します。

必要権限

システム管理

URL

PUT /system/users/{userIds}

パスパラメーター

名前 必須か 説明
userIds string ユーザーID

リクエストボディ

名前 必須か 説明
name string × ユーザー名
englishName string × ユーザーの英語名
code string × ユーザーのコード
description string × ユーザーの説明
loginName string × ユーザーのログイン名
ldapLoginName string × LDAPログイン名
email string × Eメールアドレス
language string × 言語

ja-JP:日本語
en-US:英語
timeZone TimeZone × タイムゾーン
unitCost double × ユーザーのコスト単価
unitCostAppliedStartDate Date × コスト単価の適用開始日

unitCost が指定されていなかった場合、このフィールドは無視されます。
timeEntryLockedDate Date × 実績工数のロック期間

指定日以前の実績入力をロックします。
2013-03-01 の場合、2013-03-01 までの実績入力はロックされ入力できず、2013-03-02 以降は入力できます。
organizationId string × ユーザーが所属する組織ID
organization string × ユーザーが所属する組織

組織の「コード」、「名前」に完全一致する組織のIDを組織IDとして更新処理を行います。
systemRoleId string × システムロールID
systemRole string × システムロール

システムロールの「コード」、「名前」に完全一致するシステムロールのIDをシステムロールIDとして更新処理を行う。
password string × 現在のパスワード

password、newPassword のいずれかが指定されなかった場合、パスワードのチェック、更新を行いません。
newPassword string × 新しいパスワード
newPasswordConfirm string × 新しいパスワード(確認用)
restore boolean × ユーザーを復元するか

trueを指定すると、他のパラメータは無視されます。
metadata <string, string> × キーと値のコレクション
- 追加時 : 値が null の項目を除いて設定する
- 更新時 : キーが指定されなかった項目は変更しない。値が null に指定された項目は削除する

レスポンス

名前 説明
なし

エラーケース

  • 指定した組織IDが存在しない
  • 指定した組織が存在しない
  • 指定したユーザーグループIDが存在しない
  • 指定したユーザーグループが存在しない
  • 指定したシステムロールIDが存在しない
  • 指定したシステムロールが存在しない
  • ログイン名が重複している
  • ログイン名に不正な値が入力された
  • 現在のパスワードが誤っている
  • 新しいパスワードと新しいパスワード(確認用)が一致しない
  • システム管理権限を持つユーザーが一人も存在しない

特記事項

  • 有効なLDAPログイン名であるかの検証は行いません。
  • パスワードの強度チェックは行いません。
  • 有効ライセンス数に依存しません。

サンプル

ユーザーIDを指定してコスト単価・組織・システムロールを更新する

リクエスト
PUT /system/users/21
{
  "unitCost":8000.0,
  "organizationId":"7",
  "systemRoleId":"1"
}
レスポンス
200 OK

型定義

TimeZone(列挙型)

名前 説明
Etc/GMT+12 (UTC-12:00) 国際日付変更線 西側
Etc/GMT+11 (UTC-11:00) 協定世界時-11
America/Adak (UTC-10:00) ハワイ・アリューシャン
Pacific/Honolulu (UTC-10:00) ハワイ
Pacific/Marquesas (UTC-9:30) マルキーズ
America/Anchorage (UTC-09:00) アラスカ
Etc/GMT+9 (UTC-9:00) 協定世界時-9
America/Santa_Isabel (UTC-08:00) バハカリフォルニア
Etc/GMT+8 (UTC-9:00) 協定世界時-8
America/Los_Angeles (UTC-08:00) 太平洋標準時(米国およびカナダ)
America/Phoenix (UTC-07:00) アリゾナ
America/Chihuahua (UTC-07:00) チワワ、ラパス、マサトラン
America/Denver (UTC-07:00) 山地標準時(米国およびカナダ)
Pacific/Easter (UTC-06:00) イースター島
America/Mexico_City (UTC-06:00) グアダラハラ、メキシコシティ、モンテレー
America/Regina (UTC-06:00) サスカチュワン
America/Guatemala (UTC-06:00) 中央アメリカ
America/Chicago (UTC-06:00) 中部標準時(米国およびカナダ)
America/Indiana/Indianapolis (UTC-05:00) インディアナ東部
America/Cancun (UTC-05:00) 東部時間(メキシコ)
America/Port-au-Prince (UTC-05:00) アメリカ東部時間(ハイチ)
America/Havana (UTC-05:00) アメリカ中部時間(キューバ)
America/Bogota (UTC-05:00) ボゴタ、リマ、キト
America/New_York (UTC-05:00) 東部標準時(米国およびカナダ)
America/Asuncion (UTC-04:00) アスンシオン
America/Caracas (UTC-04:30) カラカス
America/Cuiaba (UTC-04:00) クイアバ
America/Santiago (UTC-04:00) サンチアゴ
America/La_Paz (UTC-04:00) ジョージタウン、ラパス、マナウス、サンフアン
America/Grand_Turk (UTC-04:00) 大西洋時間(タークス・カイコス諸島)
America/Halifax (UTC-04:00) 大西洋標準時(カナダ)
America/St_Johns (UTC-03:30) ニューファンドランド
America/Araguaina (UTC-03:00) ブラジル(アラグアイーナ)
America/Cayenne (UTC-03:00) カイエンヌ、フォルタレザ
America/Godthab (UTC-03:00) グリーンランド
America/Bahia (UTC-03:00) ブラジル(バイーア)
America/Miquelon (UTC-03:00) ピエール・ミクロン
America/Buenos_Aires (UTC-03:00) ブエノスアイレス
America/Sao_Paulo (UTC-03:00) ブラジル(サンパウロ)
America/Montevideo (UTC-03:00) モンテビデオ
Etc/GMT+2 (UTC-02:00) 協定世界時-2
Atlantic/Azores (UTC-01:00) アゾレス
Atlantic/Cape_Verde (UTC-01:00) カーボベルデ諸島
Etc/GMT (UTC+00:00) 協定世界時
Africa/Casablanca (UTC+00:00) カサブランカ
Europe/London (UTC+00:00) ダブリン、エジンバラ、リスボン、ロンドン
Atlantic/Reykjavik (UTC+00:00) モンロビア、レイキャビク
Europe/Berlin (UTC+01:00) アムステルダム、ベルリン、ベルン、ローマ、ストックホルム、ウィーン
Africa/Windhoek (UTC+01:00) ウィントフック
Europe/Warsaw (UTC+01:00) サラエボ、スコピエ、ワルシャワ、ザグレブ
Europe/Paris (UTC+01:00) ブリュッセル、コペンハーゲン、マドリード、パリ
Europe/Budapest (UTC+01:00) ベオグラード、ブラチスラバ、ブダペスト、リュブリャナ、プラハ
Africa/Lagos (UTC+01:00) 西中央アフリカ
Europe/Athens (UTC+02:00) アテネ
Asia/Amman (UTC+02:00) アンマン
Asia/Jerusalem (UTC+02:00) エルサレム
Africa/Cairo (UTC+02:00) カイロ
Asia/Gaza (UTC+02:00) ガザ
Europe/Kaliningrad (UTC+02:00) カリーニングラード
Europe/Chisinau (UTC+02:00) キシナウ
Asia/Damascus (UTC+02:00) ダマスカス
Africa/Tripoli (UTC+02:00) トリポリ
Africa/Johannesburg (UTC+02:00) ハラーレ、プレトリア
Asia/Beirut (UTC+02:00) ベイルート
Europe/Kiev (UTC+02:00) ヘルシンキ、キエフ、リガ、ソフィア、タリン、ビリニュス
Europe/Istanbul (UTC+02:00) アテネ、ブカレスト、イスタンブール
Asia/Kuwait (UTC+03:00) クウェート
Africa/Nairobi (UTC+03:00) ナイロビ
Asia/Baghdad (UTC+03:00) バグダッド
Europe/Minsk (UTC+03:00) ミンスク
Europe/Moscow (UTC+04:00) モスクワ、サンクトペテルブルグ、ボルゴグラード
Asia/Tehran (UTC+03:30) テヘラン
Europe/Astrakhan (UTC+04:00) アストラハン
Asia/Dubai (UTC+04:00) アブダビ、マスカット
Europe/Samara (UTC+04:00) サマーラ
Asia/Yerevan (UTC+04:00) エレバン
Asia/Tbilisi (UTC+04:00) トビリシ
Asia/Baku (UTC+04:00) バクー
Indian/Mauritius (UTC+04:00) ポートルイス
Asia/Kabul (UTC+04:30) カブール
Asia/Ashgabat (UTC+05:00) アシガバート
Asia/Karachi (UTC+05:00) イスラマバード、カラチ
Asia/Yekaterinburg (UTC+06:00) エカテリンブルグ
Asia/Colombo (UTC+05:30) スリジャヤワルダナプラコッテ
Asia/Kolkata (UTC+05:30) チェンナイ、コルカタ、ムンバイ、ニューデリー
Asia/Kathmandu (UTC+05:45) カトマンズ
Asia/Almaty (UTC+06:00) アスタナ
Asia/Omsk (UTC+06:00) オムスク
Asia/Dhaka (UTC+06:00) ダッカ
Asia/Rangoon (UTC+06:30) ラングーン
Asia/Krasnoyarsk (UTC+08:00) クラスノヤルスク
Asia/Tomsk (UTC+07:00) トムスク
Asia/Novosibirsk (UTC+07:00) ノヴォシビルスク
Asia/Barnaul (UTC+07:00) バルナウル
Asia/Bangkok (UTC+07:00) バンコク、ハノイ、ジャカルタ
Asia/Hovd (UTC+07:00) ホブド
Asia/Irkutsk (UTC+09:00) イルクーツク
Asia/Ulaanbaatar (UTC+08:00) ウランバートル
Asia/Singapore (UTC+08:00) クアラルンプール、シンガポール
Australia/Perth (UTC+08:00) パース
Asia/Taipei (UTC+08:00) 台北
Asia/Shanghai (UTC+08:00) 北京、重慶、香港特別行政区、ウルムチ
Asia/Pyongyang (UTC+08:30) 平壌
Australia/Eucla (UTC+08:45) オーストラリア中西部
Asia/Seoul (UTC+09:00) ソウル
Asia/Chita (UTC+09:00) チッタ
Asia/Yakutsk (UTC+10:00) ヤクーツク
Asia/Tokyo (UTC+09:00) 大阪、札幌、東京
Australia/Adelaide (UTC+09:30) アデレード
Australia/Darwin (UTC+09:30) ダーウィン
Asia/Vladivostok (UTC+11:00) ウラジオストク
Australia/Sydney (UTC+10:00) キャンベラ、メルボルン、シドニー
Pacific/Port_Moresby (UTC+10:00) グアム、ポートモレスビー
Australia/Brisbane (UTC+10:00) ブリスベン
Australia/Hobart (UTC+10:00) ホバート
Australia/Lord_Howe (UTC+10:30) ロード・ハウ
Asia/Sakhalin (UTC+11:00) サハリン
Pacific/Guadalcanal (UTC+11:00) ソロモン諸島、ニューカレドニア
Asia/Srednekolymsk (UTC+11:00) スレドネコリムスク
Pacific/Norfolk (UTC+11:00) ノーフォーク
Pacific/Bougainville (UTC+11:00) ブーゲンビル
Asia/Magadan (UTC+12:00) マガダン
Asia/Anadyr (UTC+12:00) アナディー
Pacific/Auckland (UTC+12:00) オークランド、ウェリントン
Pacific/Fiji (UTC+12:00) フィジー、マーシャル諸島
Etc/GMT-12 (UTC+12:00) 協定世界時+12
Pacific/Chatham (UTC+12:45) チャタム
Pacific/Apia (UTC+13:00) サモア
Pacific/Tongatapu (UTC+13:00) ヌクアロファ
Pacific/Kiritimati (UTC+14:00) ライン諸島