Search Users

ユーザープロパティまたはメールアドレスのいずれかを使用してAuth0ユーザーの情報を検索します。

オプション

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

フィールド	定義	タイプ	必須
検索条件（Search By）	次のいずれかのユーザー検索オプションを選択します。 `User Properties`：ほとんどのユーザーアカウント属性に対して検索を実行できます。最近実行された書き込み操作が結果に反映されていない場合は、検索を繰り返さなければならないことがあります。ユーザーの検索を参照してください。 `Email`：メールアドレスに基づいてAuth0ユーザーを検索します。このオプションは、書き込み操作が検索リクエストの直前に行われた場合でも、成功したすべての書き込み操作の結果を反映します。	ドロップダウン	正
結果セット（Result Set）	検索結果を表示するために次のオプションのいずれかを選択します。 `First Matching Record`：検索クエリに一致する最初のレコードのみを返します。 `First 100 Matching Records` `Stream Matching Records`：一致するすべてのレコードが親フローからヘルパーフローに渡されます。このオプションを選択すると、ストリーミング用のヘルパーフローを選択したりカスタム拡張可能フィールドを追加したりできるストリーミング（Streaming）入力セクションがカードに追加されます。 Auth0では、検索で返されるユーザーの数が制限されます。ストリーミング（Streaming）オプションは最大で1000ユーザーを返します。このしきい値を超える場合は、検索を見直すか、Auth0 export jobまたはAuth0 User Import / Export拡張機能を使用してください。	ドロップダウン	正

検索条件（Search By）

次のいずれかのユーザー検索オプションを選択します。

User Properties：ほとんどのユーザーアカウント属性に対して検索を実行できます。最近実行された書き込み操作が結果に反映されていない場合は、検索を繰り返さなければならないことがあります。ユーザーの検索を参照してください。
Email：メールアドレスに基づいてAuth0ユーザーを検索します。このオプションは、書き込み操作が検索リクエストの直前に行われた場合でも、成功したすべての書き込み操作の結果を反映します。

ドロップダウン

正

結果セット（Result Set）

検索結果を表示するために次のオプションのいずれかを選択します。

First Matching Record：検索クエリに一致する最初のレコードのみを返します。
First 100 Matching Records
Stream Matching Records：一致するすべてのレコードが親フローからヘルパーフローに渡されます。

このオプションを選択すると、ストリーミング用のヘルパーフローを選択したりカスタム拡張可能フィールドを追加したりできるストリーミング（Streaming）入力セクションがカードに追加されます。

Auth0では、検索で返されるユーザーの数が制限されます。ストリーミング（Streaming）オプションは最大で1000ユーザーを返します。このしきい値を超える場合は、検索を見直すか、Auth0 export jobまたはAuth0 User Import / Export拡張機能を使用してください。

ドロップダウン

正

入力

フィールド	定義	タイプ	必須
ユーザー（User）
名前（Name）	ユーザーの名前。指定された値について、名前（Name）入力は正確に一致する名前を持つユーザーのみを返します。	テキスト	FALSE
ID	ユーザーの一意識別子。	テキスト	FALSE
メール（Email）	ユーザーのメールアドレス。メール（Email）を検索条件（Search By）オプションとして選択した場合、これはユーザー（User）セクションに表示される唯一のオプションです。	テキスト	FALSE
メールが確認済み（Email Verified）	このメールアドレスが確認済みかどうかを示します。これが`false`であるか、指定されていない場合、ユーザーは作成後に検証メールを受信します。	True/False	FALSE
電話番号（Phone Number）	ユーザーの電話番号。番号の形式は、国際的に広く使用されているE.164勧告（地域コードとエリアコードを含む12桁の番号）に従う必要があります。たとえば、`+15559876543`です。このフィールドはSMS接続を持つユーザーに対してのみ有効です。	テキスト	FALSE
電話が確認済み（Phone Verified）	この電話番号が確認済みかどうかを示します。	True/False	FALSE
名（Given Name）	ユーザーの名。	テキスト	FALSE
ユーザー名（Username）	ユーザーのユーザー名。	テキスト	FALSE
姓（Family Name）	ユーザーの姓。	テキスト	FALSE
ニックネーム（Nickname）	ユーザーのニックネーム。	テキスト	FALSE
ブロック（Blocked）	管理者がこのユーザーをブロックしているかどうかを示します。	True/False	FALSE
アイデンティティユーザーID（Identity User ID）	ユーザーのこの接続またはプロバイダー用の一意のID。	テキスト	FALSE
ID接続（Identity Connection）	ユーザーの認証に使用されるAuth0接続の名前。	テキスト	FALSE
IDがソーシャル（Identity Is Social）	接続がソーシャルプロバイダーによって認証されたかどうかを示します。	True/False	FALSE
IDプロバイダー	ユーザーを認証したエンティティの名前。たとえば、Facebook、Google、SAML、または独自のプロバイダー名です。	テキスト	FALSE
作成日時（Created At）	ユーザープロファイルが最初に作成された日時を示すタイムスタンプ。	テキスト	FALSE
更新日時（Updated At）	ユーザーのプロファイルが直近に更新または変更された日時を示すタイムスタンプ。前回のログイン（Last Login）の変更は更新と見なされます。そのため、ほとんどの場合、最終更新日（Updated At）は前回のログイン（Last Login）に一致します。	テキスト	FALSE
前回のログイン（Last Login）	ユーザーの前回のサインイン日時を示すタイムスタンプ。	テキスト	FALSE
ログイン数（Logins Count）	ユーザーがサインインした回数。	数値	FALSE
前回のIP（Last IP）	ユーザーの前回のサインイン施行に関連付けられているIPアドレス。	テキスト	FALSE
カスタムフィルター（Custom Filters）	ユーザーを検索するためのカスタムクエリを指定します。ユーザープロパティによる検索では、Luceneクエリ構文を使用します。ユーザー検索クエリの構文を参照してください。この入力の主な用途はユーザーのメタデータ（Metadata）フィールドとアプリメタデータ（App Metadata）フィールドを検索することですが、このフィルターを調整して任意のプロパティをクエリできます。例： `(name:Jessie Doe)` `(name:Jessie Doe AND given_name:Jessie)` `(name:"Jane Doe" OR given_name:John OR identities.connection:auth0 AND user_metadata.color:blue AND app_metadata.score:100)`	テキスト	FALSE
ストリーミング（Streaming）
フロー（Flow）	フローを選択（Choose Flow）をクリックして、検索結果ストリームを受信する宛先ヘルパーフローを選択します。選択（Choose）をクリックして確定します。ユーザーレコードごとにフローが1回ずつトリガーされます。ユーザーデータは、ヘルパーフローのレコード（Record）出力オブジェクトにあるキーを介して参照されます。オプションとして、クリックまたはここにドロップして作成（Click or drop here to create）の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の状態（State）出力オブジェクトの下にキーと値のペアとして追加されます。このフィールドは、結果セット（Result Set）フィールドで`Stream Matching Records`を選択した場合に表示されます。	フロー	正
レコード制限（Record Limit）	ストリーミングするレコードの数を指定します。レコード制限（Record Limit）フィールドを`0`に設定すると、レコードは返されません。レコード制限（Record Limit）フィールドに`0`より大きい値を設定すると、最大で指定された最大レコード数までのレコードが返されます。レコード制限（Record Limit）フィールドが空、null、または未選択の場合、すべてのレコードが返されます。デフォルト値は`1000`です。有効な範囲は`0`～`1000`です。このフィールドは、結果セット（Result Set）フィールドで`Stream Matching Records`を選択した場合に表示されます。	数値	FALSE

出力

フィールド	定義	タイプ
結果（Result）
ID	ユーザーの一意識別子。	テキスト
名前（Name）	ユーザーの名前。	テキスト
メール（Email）	ユーザーのメールアドレス。	テキスト
メールが確認済み（Email Verified）	このメールアドレスが確認済みかどうかを示します。これが`false`であるか、指定されていない場合、ユーザーは作成後に検証メールを受信します。	True/False
電話番号（Phone Number）	ユーザーの電話番号。この出力値はSMS接続を持つユーザーにのみ表示されます。	テキスト
電話が確認済み（Phone Verified）	この電話番号が確認済みかどうかを示します。	True/False
メタデータ（Metadata）	アプリケーションのコア機能に影響を与えないユーザー関連データ。	オブジェクト
アプリメタデータ（App Metadata）	アプリケーションのコア機能に影響を与えるユーザー関連データ。	オブジェクト
ユーザー名（Username）	ユーザーのユーザー名。	テキスト
名（Given Name）	ユーザーの名。	テキスト
姓（Family Name）	ユーザーの姓。	テキスト
ニックネーム（Nickname）	ユーザーのニックネーム。	テキスト
写真（Picture）	ユーザーの写真を含むURI（ユニフォームリソースアイデンティファイア）。例：`https://www.akc.org/wp-content/uploads/2017/11/Pomeranian-On-White-01.jpg`	テキスト
ブロック（Blocked）	管理者がこのユーザーをブロックしているかどうかを示します。	True/False
作成日時（Created At）	ユーザープロファイルが最初に作成された日時を示すタイムスタンプ。	テキスト
更新日時（Updated At）	ユーザーのプロファイルが直近に更新または変更された日時を示すタイムスタンプ。前回のログイン（Last Login）の変更は更新と見なされます。そのため、ほとんどの場合、最終更新日（Updated At）は前回のログイン（Last Login）に一致します。	テキスト
多要素	ユーザーが登録している多要素プロバイダーのリスト。	オブジェクトのリスト
前回のIP（Last IP）	ユーザーの前回のサインイン施行に関連付けられているIPアドレス。	テキスト
前回のログイン（Last Login）	ユーザーの前回のサインイン日時を示すタイムスタンプ。	テキスト
ログイン数（Logins Count）	ユーザーがサインインした回数。	数値
ID（Identities）	ユーザーを最初に認証したIDプロバイダーから取得された情報を格納します。	オブジェクトのリスト
接続（Connection）	ユーザーの認証に使用されるAuth0接続の名前。	テキスト
ユーザーID（User ID）	ユーザーのこの接続またはプロバイダー用の一意のID。	テキスト
プロバイダー（Provider）	ユーザーを認証したエンティティの名前。たとえば、Facebook、Google、SAML、または独自のプロバイダー名です。	テキスト
ソーシャルか（Is Social）	接続がソーシャルプロバイダーによって認証されたかどうかを示します。	True/False
ユーザー（Users）	検索条件に一致する最大100ユーザーのリストが返されます。このフィールドは、結果セット（Result Set）オプションに`First 100 Matching Records`を選択した場合に表示されます。このリストには、各ユーザーの出力フィールドが個別のオブジェクトとして含まれます。	オブジェクトのリスト
ストリーミングされたレコード（Records Streamed）	ストリーミングフロー内でストリーミングされたレコードの数。このフィールドは、結果セット（Result Set）オプションで`Stream Matching Records`を選択した場合に表示されます。	数値