この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
フィルタ基準に基づいて、ユーザ セッション データのクエリを実行します。結果は最終ログイン時刻を基準に降順に並べ替えられます。検索基準には、MAC アドレス、最終セッション時刻、ステータス、および任意またはすべてのフィールドを使用できます。クエリは index パラメータと count パラメータを使用してページングされます。count パラメータの最大サイズは 1000 です。返される JSON オブジェクトには、返されたレコード数とクエリ対象の次のインデックス(さらに結果がある場合)が格納されます。クエリ結果は、URL /api/connect/v1/clients/export を使用して CSV ファイル形式でダウンロードすることもできます。クエリのエクスポートに最大サイズの制限はありません。
GET
/api/connect/v1/clients
N
名前 |
必須 |
デフォルト |
タイプ |
場所 |
説明 |
---|---|---|---|---|---|
start |
N |
— |
文字列 |
query |
最終ログイン時刻に基づくセッション開始時刻(UTC 形式)。 |
end |
N |
— |
文字列 |
query |
最終ログイン時刻に基づくセッション終了時刻(UTC 形式)。 |
index |
N |
— |
文字列 |
query |
0 を基準とした、クエリの開始インデックス。 |
count |
N |
— |
文字列 |
query |
クエリ対象のレコード数。最大数は 1000 に制限されます。 |
status |
N |
— |
文字列 |
query |
ユーザのステータス。有効な値は、all、active です。 |
authtype |
N |
— |
文字列 |
query |
ユーザが使用している認証タイプ。有効な値/形式は、registration、SMS、social です。 |
mac |
N |
— |
文字列 |
query |
MAC アドレス(00:11:22:33:44:55:66 形式)。MAC アドレスを使用する場合、他のパラメータはすべて無視されます。 |
device |
N |
— |
文字列 |
query |
ユーザが使用しているデバイスのタイプ。 |
os |
N |
— |
文字列 |
query |
ユーザが使用しているデバイスのオペレーティング システム。 |
language |
N |
— |
文字列 |
query |
ユーザに対して使用される言語。完全な言語名または 2 文字の言語コードで検索できます。 |
all |
N |
— |
文字列 |
query |
検索をすべてのフィールドに適用します。 |
application/json