PAM セッション情報を取得する
特権アカウントで、セッションにログインにしているアカウントのユーザー名を取得するために使用されます。
Note
この記事の URL は、 などの https://api.contoso.com
API デプロイ中に選択されたホスト名に対する相対 URL です。
Request
Method | 要求 URL |
---|---|
GET | /api/session/sessioninfo |
クエリ パラメーター
パラメーター | 説明 |
---|---|
v | 省略可能。 API のバージョン。 含まれていない場合は、現在 (最近リリースされた) バージョンの API が使用されます。 詳細については、「 PAM REST API サービスのバージョン管理」を参照してください。 |
要求ヘッダー
一般的な要求ヘッダーについては、「PAM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。
要求本文
なし。
Response
このセクションでは、応答について説明します。
応答コード
コード | 説明 |
---|---|
200 | OK |
401 | 権限がありません |
403 | Forbidden |
408 | 要求タイムアウト |
500 | 内部サーバー エラー |
503 | サービス利用不可 |
応答ヘッダー
一般的な要求ヘッダーについては、「PAM REST API サービスの詳細」の「HTTP 要求ヘッダーと応答ヘッダー」を参照してください。
応答本文
正常に応答すると、次のプロパティを持つ PAM セッション オブジェクトが返されます。
プロパティ | 説明 |
---|---|
ユーザー名 | このセッションにログインしているアカウントのユーザー名。 |
例
このセクションでは、PAM セッション情報を取得する例を示します。
例: 要求
GET /api/session/sessioninfo/ HTTP/1.1
例: 応答
HTTP/1.1 200 OK
{
"odata.metadata":"http://localhost:8086/api/pamresources/%24metadata#sessioninfo",
"value":[
{
"Username":"FIMCITONEBOXAD\\Jen"
}
]
}