ユーザーの更新

IDまたはユーザー名によって、Oktaユーザーのシステム情報およびプロファイルプロパティを更新します。

注意: デフォルトでは、このカードには資格情報の関連フィールドがすべて含まれます。カードを保存する前に、更新するフィールドのみが選択されていることを確認してください。

注:

このアクションは、アプリケーションユーザーについての情報を更新しません。ユーザーのタイプが無効または正しくないとき、この操作を試みると、404エラーが返されます。アプリケーションユーザーに関する詳細を取得するには、Custom API Actionカードを使用します。アプリケーション用に割り当てられているユーザーに関する情報の参照の詳細については、「アプリケーションユーザーの処理」を参照してください。

スコープ

このカードで必要なOAuthスコープのリストは「アクションカード」を参照してください。

オプション

フィールド定義タイプ必須

フィールド	定義	タイプ	必須
セマンティクスの更新（Update Semantics）	`Partial`：部分的な更新セマンティクスを使用してユーザーのプロファイルまたは資格情報を更新します。指定されないすべてのプロパティーは無視され、現在の値を維持します。 `Strict`：厳格な更新セマンティクスを使用してユーザーのプロファイルおよび資格情報を更新します。重要（IMPORTANT）：ユーザーのプロファイルを更新する際、すべてのプロファイルを指定する必要があります。リクエストで指定されないすべてのプロパティーは`null`に設定されます。	ドロップダウン	FALSE

セマンティクスの更新（Update Semantics）

Partial：部分的な更新セマンティクスを使用してユーザーのプロファイルまたは資格情報を更新します。指定されないすべてのプロパティーは無視され、現在の値を維持します。

Strict：厳格な更新セマンティクスを使用してユーザーのプロファイルおよび資格情報を更新します。重要（IMPORTANT）：ユーザーのプロファイルを更新する際、すべてのプロファイルを指定する必要があります。リクエストで指定されないすべてのプロパティーはnullに設定されます。

ドロップダウン

FALSE

入力

フィールド	定義	タイプ	必須
ユーザー（User）
ID (ID)	OktaユーザーのID（通常はメール形式）。	テキスト	FALSE
オプション（Option）
Pass Empty Values? (空の値の受け渡し？)	セマンティクスの更新（Update Semantics）が`Partial`に設定される場合にのみ表示されます。何も選択しない場合のデフォルト値は`Yes`です。 `Yes`の場合、選択されて有効な値が入力されているすべてのフィールドが更新されます。選択されているが空白のままのすべてのフィールドは、特殊なフィールドを除きクリアされます。下記の注を参照してください。選択されていないすべてのフィールドは変更されずに残ります。 `No`の場合、選択されて有効な値が入力されているすべてのフィールドが更新されます。選択されていないか空白のままのすべてのフィールドは変更されずに残ります。 1. 基本情報フィールドも参照してください。	ドロップダウン	FALSE
プロファイル（Profile）
市区町村（City）	ユーザーの住所の市部分。	テキスト	FALSE
コストセンター（Cost center）	ユーザーに割り当てられているコストセンターの名前。	テキスト	FALSE
国番号（Country code）	国の省略形。	テキスト	FALSE
部門（Department）	ユーザーの所属部署の名前。	テキスト	FALSE
表示名（Display name）	ユーザーの名前。エンドユーザーへの表示に適しています。	テキスト	FALSE
事業部（Division）	ユーザーの事業部の名前。	テキスト	FALSE
プライマリメールアドレス（Primary email）	ユーザーのプライマリーメールアドレス。	テキスト	FALSE
従業員番号（Employee number）	Organizationまたは企業からユーザーに割り当てられている一意の識別子。	テキスト	FALSE
名（First name）	ユーザーの名。	テキスト	FALSE
敬称接頭辞（Honorific prefix）	ユーザーの敬称接頭辞。ほとんどの西洋言語では称号としても知られています。	テキスト	FALSE
敬称接尾辞（Honorific suffix）	ユーザーの敬称接尾辞。ほとんどの西洋言語では称号としても知られています。	テキスト	FALSE
姓（Last name）	ユーザーの姓つまり名字。	テキスト	FALSE
地域（Locale）	通貨、日時の形式、数値の表示形式などの項目をローカライズするための、ユーザーのデフォルトの場所。	テキスト	FALSE
ユーザー名（Username）	ユーザーのログインユーザー名（通常、メールアドレスの形式）。	テキスト	FALSE
マネージャー（Manager）	ユーザーのマネージャーの表示名。	テキスト	FALSE
マネージャーID（ManagerId）	ユーザーのマネージャーのID。	テキスト	FALSE
ミドルネーム（Middle name）	ユーザーのミドルネーム。	テキスト	FALSE
携帯電話（Mobile phone）	ユーザーの携帯電話番号。	テキスト	FALSE
ニックネーム（Nickname）	ユーザーが選定するニックネーム（該当する場合）。	テキスト	FALSE
組織（Organization）	ユーザーの組織の名前。	テキスト	FALSE
郵便物送付先（Postal Address）	ユーザーの住所の郵便物送付先部分。	テキスト	FALSE
優先言語（Preferred language）	ユーザーの優先する書き言葉または話し言葉の言語。	テキスト	FALSE
メインの電話番号（Primary phone）	ユーザーのメインの電話番号（自宅の番号など）。	テキスト	FALSE
プロファイルURL（Profile Url）	ユーザーのオンラインプロファイル（Webページ）のURL。	テキスト	FALSE
セカンダリメールアドレス（Secondary email）	ユーザーのセカンダリメールアドレス（一般にアカウント復旧に使用）。	テキスト	FALSE
状態（State）	ユーザーの住所の州または地域部分。	テキスト	FALSE
番地（Street address）	ユーザーの住所の完全な番地部分。	テキスト	FALSE
タイムゾーン（Time zone）	ユーザーのタイムゾーン。	テキスト	FALSE
タイトル（Title）	ユーザーの役職名。	テキスト	FALSE
ユーザータイプ（User type）	組織に対するユーザーの関係（従業員または請負業者など）。	テキスト	FALSE
郵便番号（Zip code）	ユーザーの住所のZIPコードまたは郵便番号部分。	テキスト	FALSE
カスタムプロファイルプロパティー（Custom Profile Properties）	このカードの設定時に生成される追加のカスタムユーザープロファイルプロパティー。	動的生成	FALSE
資格情報（Credentials）
パスワード（Password）	ユーザーの新規パスワードの文字列値。	テキスト	FALSE
復旧質問（Recovery Question）	ユーザーのパスワード復旧を可能にするための質問。	テキスト	FALSE
復旧回答（Recovery Answer）	パスワード復旧質問に対する回答。	テキスト	FALSE
2. 資格情報も参照してください。

出力

フィールド	定義	タイプ
システムプロパティ（System Properties）
ID (ID)	OktaユーザーのID。	テキスト
ステータス（Status）	ユーザーの現在のステータス（`STAGED`、`PROVISIONED`、`ACTIVE`、`RECOVERY`、`LOCKED_OUT`、`PASSWORD_EXPIRED`、`SUSPENDED`、または`DEPROVISIONED`)。	テキスト
作成日時（Created）	オブジェクトが作成された日時。	日時
アクティブ化（Activated）	`ACTIVE`ステータスへの遷移が完了した時点のタイムスタンプ。	True/False
ステータス変更日時（Status Changed）	ユーザーのステータスが最後に変更された日。	日時
前回のログイン（Last Login）	ユーザーの最終ログイン日時のタイムスタンプ。	日時
最終アップデート日（Last Updated）	ユーザーの最終更新日時のタイムスタンプ。	日時
パスワード変更日時（Password Changed）	ユーザーの最終パスワード変更日時のタイムスタンプ。	True/False
資格情報（Credentials）
メール（Emails）	ユーザーに関連付けられたメールのリスト。	リスト
パスワード（Password）	ユーザーが有効なパスワードを持っているかハッシュパスワードをインポートした場合は`true`。それ以外の場合は`false`。警告: 次のいずれかの条件が満たされると、このフィールドは空の文字列に更新されます。セマンティクスの更新（Update Semantics）が部分更新（Partial）に設定され、パスワード（Password）が空の文字列に設定され、空の値の受け渡し（Pass Empty Values）が選択されていないか空の値に設定されている。セマンティクスの更新（Update Semantics）が部分更新（Partial）に設定され、パスワード（Password）が空の文字列に設定され、空の値の受け渡し（Pass Empty Values）がはい（Yes）に設定されている。セマンティクスの更新（Update Semantics）が厳密（Strict）に設定され、パスワード（Password）が空の文字列に設定されている。	True/False
復旧質問（Recovery Question）	ユーザーがパスワードを忘れた場合の復旧質問。	テキスト
プロバイダー（Provider）
名前（Name）	認証プロバイダーの名前。	テキスト
タイプ（Type）	認証プロバイダーのタイプ。`OKTA`、`ACTIVE_DIRECTORY`、`LDAP`、`FEDERATION`、`SOCIAL`、`IMPORT`のいずれか。	テキスト
プロファイルプロパティ（Profile Properties）
市区町村（City）	ユーザーの住所の市部分。	テキスト
コストセンター（Cost center）	ユーザーに割り当てられているコストセンターの名前。	テキスト
国番号（Country code）	国の省略形。	テキスト
部門（Department）	ユーザーの所属部署の名前。	テキスト
表示名（Display name）	ユーザーの名前。エンドユーザーへの表示に適しています。	テキスト
事業部（Division）	ユーザーの事業部の名前。	テキスト
プライマリメールアドレス（Primary email）	ユーザーのプライマリーメールアドレス。	テキスト
従業員番号（Employee number）	Organizationまたは企業からユーザーに割り当てられている一意の識別子。	テキスト
名（First name）	ユーザーの名。	テキスト
敬称接頭辞（Honorific prefix）	ユーザーの敬称接頭辞。ほとんどの西洋言語では称号としても知られています。	テキスト
敬称接尾辞（Honorific suffix）	ユーザーの敬称接尾辞。ほとんどの西洋言語では称号としても知られています。	テキスト
姓（Last name）	ユーザーの姓つまり名字。	テキスト
地域（Locale）	通貨、日時の形式、数値の表示形式などの項目をローカライズするための、ユーザーのデフォルトの場所。	テキスト
ユーザー名（Username）	ユーザーのログインユーザー名（通常、メールアドレスの形式）。	テキスト
マネージャー（Manager）	ユーザーのマネージャーの表示名。	テキスト
マネージャーID（ManagerId）	ユーザーのマネージャーのID。	テキスト
ミドルネーム（Middle name）	ユーザーのミドルネーム。	テキスト
携帯電話（Mobile phone）	ユーザーの携帯電話番号。	テキスト
ニックネーム（Nickname）	ユーザーが選定するニックネーム（該当する場合）。	テキスト
組織（Organization）	ユーザーの組織の名前。	テキスト
郵便物送付先（Postal Address）	ユーザーの住所の郵便物送付先部分。	テキスト
優先言語（Preferred language）	ユーザーの優先する書き言葉または話し言葉の言語。	テキスト
メインの電話番号（Primary phone）	ユーザーのメインの電話番号（自宅の番号など）。	テキスト
プロファイルURL（Profile Url）	ユーザーのオンラインプロファイル（Webページ）のURL。	テキスト
セカンダリメールアドレス（Secondary email）	ユーザーのセカンダリメールアドレス（一般にアカウント復旧に使用）。	テキスト
状態（State）	ユーザーの住所の州または地域部分。	テキスト
番地（Street address）	ユーザーの住所の完全な番地部分。	テキスト
タイムゾーン（Time zone）	ユーザーのタイムゾーン。	テキスト
タイトル（Title）	ユーザーの役職名。	テキスト
ユーザータイプ（User type）	組織に対するユーザーの関係（従業員または請負業者など）。	テキスト
郵便番号（Zip code）	ユーザーの住所のZIPコードまたは郵便番号部分。	テキスト
カスタムプロファイルプロパティー（Custom Profile Properties）	このカードの設定時に生成される追加のカスタムユーザープロファイルプロパティー。	動的生成

追加情報

1. 基本情報フィールド

次の4つのフィールドは基本情報フィールドで、クリアできません。

ユーザー名
名
姓
プライマリメールアドレス

セマンティクスの更新の設定	空の値の受け渡しの設定	基本フィールドの処理
Partial	はい	これら4つのフィールドのいずれかが選択されて空白のままの場合、カードはエラーを報告します。これらのフィールドのいずれかが選択されて有効な値が入力されている場合、更新されます。選択されていないすべてのフィールドは変更されずに残ります。
Partial	いいえ	これら4つのフィールドのいずれかが選択されて有効な値が入力されている場合、更新されます。これらのフィールドのいずれかが選択されているが空白のままか選択されていない場合、変更されずに残ります。
Strict	N/A	これら4つのフィールドのいずれかが選択されているが空白のままか選択されていない場合、カードはエラーを報告します。これらすべてのフィールドが選択されて有効な値が入力されている場合にのみ、カードは通過できます。

セマンティクスの更新の設定

空の値の受け渡しの設定

基本フィールドの処理

Partial

はい

これら4つのフィールドのいずれかが選択されて空白のままの場合、カードはエラーを報告します。
これらのフィールドのいずれかが選択されて有効な値が入力されている場合、更新されます。
選択されていないすべてのフィールドは変更されずに残ります。

Partial

いいえ

これら4つのフィールドのいずれかが選択されて有効な値が入力されている場合、更新されます。
これらのフィールドのいずれかが選択されているが空白のままか選択されていない場合、変更されずに残ります。

Strict

N/A

これら4つのフィールドのいずれかが選択されているが空白のままか選択されていない場合、カードはエラーを報告します。
これらすべてのフィールドが選択されて有効な値が入力されている場合にのみ、カードは通過できます。

2. 資格情報

a. パスワード（Password）

実際の値を表示しませんが、フィールドが既存の値を含むか値がクリアされているかどうかにかかわらず常にtrueを表示します。
ユーザーが資格情報なしで作成され、以前に有効なパスワードが設定されたことがない場合にのみfalseを表示します。
フィールドをクリアするには、フィールドを選択し、空白のままにした状態で、次のいずれかのオプションを使用します。
- セマンティクスの更新（Update Semantics）をPartialに設定し、空の値の受け渡し（Pass Empty Values）をYesに設定する
- セマンティクスの更新（Update Semantics）をStrictに設定する
フィールドが選択されていない場合、常に変更されずに残ります。

b. 復旧質問と復旧回答（b. Recovery Question and Recovery Answer）

これらのフィールドを消去することはできません。
ユーザーが資格情報なしで作成され、以前に有効な復旧質問と復旧回答が設定されたことがない場合にのみ空にすることができます。
これら2つのフィールドは同時に更新する必要があり、そうしない場合は変更されずに残ります。