ユーザーを更新する

Tenable Vulnerability Managementでユーザーを更新します。

入力

フィールド	定義	タイプ	必須
更新条件（Update By）
IDまたはUUID（ID or UUID）	ユーザーの一意識別子。 UUIDとIDの両方が受け入れられます。 UUIDの入力例：`a1ac5e57-d3cf-4396-a825-38538bc52d26` IDの入力例：`2192886`	テキスト	正
ユーザー（User）
フルネーム（Full Name）	ユーザーのフルネーム。	テキスト	FALSE
メールアドレス（Email）	ユーザーのメールアドレス。有効なメールアドレスは`name@domain`の形式にする必要があります。このドメインは、Tenable Vulnerability Managementインスタンスで承認されたドメインに対応します。管理者は、承認されたドメイン外のドメインを持つメールアドレスでユーザーを作成できます。このメールアドレスは、ユーザー名に設定されているメールアドレスを上書きします。リクエストがこのパラメーターを省略した場合、Tenable Vulnerability Managementでは、ユーザー名値がユーザーのメールアドレスとして使用されます。注: 初回セットアップ時に、TenableでVulnerability Managementインスタンスの承認済みドメインが構成されます。インスタンスにドメインを追加する場合は、Tenableサポートまでお問い合わせください。	テキスト	FALSE
有効化（Is Enabled）	ユーザーアカウントが有効（`true`）か、または無効（`false`）かを指定します。	True/False	FALSE
事前定義済みロール（Predefined Role）	ユーザーロール（User Roles）で説明されているように、整数値で表されるユーザーロール。値： `Basic` `Scan Operator` `Standard` `Scan Manager` `Administrator` 注: 事前定義されたユーザーロール（User Roles）のみ割り当てられます。ユーザーロールを更新する（Update User Role）カードを使って、カスタムロール（Custom Roles）を割り当てることができます。	ドロップダウン	FALSE

出力

フィールド	定義	タイプ
ユーザー（User）
ID	ユーザーの一意識別子。	テキスト
UUID	ユーザーのUUID。	テキスト
ユーザー名（Username）	ユーザーのユーザー名。	テキスト
メールアドレス（Email）	ユーザーのメールアドレス。この属性が空の場合、Tenable Vulnerability Managementでは、username値がユーザーのメールアドレスとして使用されます。	テキスト
フルネーム（Full Name）	ユーザーのフルネーム。	テキスト
有効化（Is Enabled）	ユーザーアカウントが有効（`true`）か、または無効（`false`）かを指定します。	True/False
コンテナUUID（Container UUID）	ユーザーが属するTenable Vulnerability ManagementインスタンスのUUID。	テキスト
ロックアウトされる（Is Lockedout）	ユーザーがTenable Vulnerability Managementアプリにサインインできる（`false`）、またはロックアウトされる（`true`）かを指定します。 Tenable Vulnerability Managementでは、ユーザーの`login_fail_count`属性が5より大きい場合、この属性を自動的にtrueに更新します。ユーザーアカウントをロック解除するには、ユーザーパスワードを変更する（Change User Password）カード（パスワード変更エンドポイント）を使用して、ユーザーのパスワードをリセットします。注: ユーザーは、ユーザーインターフェイスからロックアウトできますが、適切な認可（`api_permitted`）が割り当てられている場合は、APIリクエストを送信できます。ユーザーがAPIリクエストを送信しないようにするには、ユーザー認可を更新エンドポイントを使用して認可を制限するか、ユーザーを更新する（Update User）カード（ユーザーを更新エンドポイント）、またはユーザーアカウントを有効化エンドポイントを使用してユーザーを完全に無効にします。	True/False
タイプ（Type）	ユーザーのタイプ。注: サポートされる型は`local`のみです。	テキスト
事前定義済みロール（Predefined Role）	ユーザーロール（User Roles）で説明されているように、整数値で表されるユーザーロール。注: ユーザーにカスタムロール（Custom Role）が割り当てられている場合、このフィールドの値は`0`です。	数値
グループ（Groups）	ユーザーが属するグループのUUIDのリスト。	テキストのリスト
2要素（Two Factor）	2要素認証の詳細。注: このフィールドは、ユーザーが2要素認証をセットアップしていない場合は省略されます。	オブジェクト
アクティブ化日時（Activated At）	2要素認証のアクティブ化時間（Unixミリ秒で表示）。	数値
TOTPが有効（Is TOTP Enabled）	TOTP2要素認証が有効（`true`）または無効（`false`）のどちらであるかを指定します。	True/False
メールが有効（Is Email Enabled）	2要素認証のバックアップ通知が有効（`true`）か、または無効（`false`）かを示します。有効の場合、Tenable Vulnerability Managementはメールで2要素検証コードを送信します。	True/False
最後に成功したログイン（Last Successful Login）	ユーザーが、最後にTenable Vulnerability Managementアプリに正常にサインインした時刻（Unixミリ秒）。注: この属性は、ユーザーがTenable Vulnerability Managementユーザーインターフェイスに少なくとも1回正常にログインした場合にのみ存在します。	数値
最終失敗ログイン（Last Failed Login）	ユーザーが、最後にTenable Vulnerability Managementにサインインできなかった時刻（Unixミリ秒）。注: この属性は、ユーザーがTenable Vulnerability Managementアプリへのサインイン試行に失敗した場合にのみ存在します。	数値
ログイン失敗回数（Login Fail Count）	ユーザーが、最後にTenable Vulnerability Managementアプリに正常にサインインした以降に失敗したサインイン試行の回数。注: この属性が`5`より大きい場合、Tenable Vulnerability Managementはユーザーアカウントをロックします（ユーザーの`Is Lockedout (lockout)`属性を`true`（`1`）に更新します）。ユーザーパスワードを変更する（Change User Password）カード（ユーザーのパスワードを変更）を使用するか、ユーザーのAPIキーを生成することで、この回数を`0`にリセットできます。	数値
ログイン失敗の合計（Login Fail Total）	ユーザーが失敗したサインイン試行の合計回数。	数値
未加工出力（Raw Output）	APIから返される未加工の応答本文。	オブジェクト