セッション (sessions
)
sessions
エンドポイントは、Spring Session によって管理されるアプリケーションの HTTP セッションに関する情報を提供します。
セッションの取得
セッションを取得するには、次の curl ベースの例に示すように、GET
リクエストを /actuator/sessions
に作成します。
$ curl 'http://localhost:8080/actuator/sessions?username=alice' -i -X GET
前述の例では、ユーザー名が alice
であるユーザーのすべてのセッションを取得します。結果のレスポンスは次のようになります。
HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 786
{
"sessions" : [ {
"id" : "6de519eb-486e-4a54-ad5c-77941da08402",
"attributeNames" : [ ],
"creationTime" : "2024-10-24T09:38:16.711925Z",
"lastAccessedTime" : "2024-10-24T11:38:04.711925771Z",
"maxInactiveInterval" : 1800,
"expired" : false
}, {
"id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
"attributeNames" : [ ],
"creationTime" : "2024-10-24T06:38:16.711918998Z",
"lastAccessedTime" : "2024-10-24T11:37:39.711921814Z",
"maxInactiveInterval" : 1800,
"expired" : false
}, {
"id" : "5f9ef59f-74ef-4e3d-b71a-e48a02136c1f",
"attributeNames" : [ ],
"creationTime" : "2024-10-23T23:38:16.711047953Z",
"lastAccessedTime" : "2024-10-24T11:37:31.711056379Z",
"maxInactiveInterval" : 1800,
"expired" : false
} ]
}
クエリパラメーター
エンドポイントはクエリパラメーターを使用して、返すセッションを制限します。次の表に、単一の必須クエリパラメーターを示します。
パラメーター | 説明 |
---|---|
| ユーザーの名前。 |
レスポンス構造
レスポンスには、一致するセッションの詳細が含まれます。次の表に、レスポンスの構造を示します。
パス | タイプ | 説明 |
---|---|---|
|
| 指定されたユーザー名のセッション。 |
|
| セッションの ID。 |
|
| セッションに保存されている属性の名前。 |
|
| セッションが作成されたときのタイムスタンプ。 |
|
| セッションが最後にアクセスされたときのタイムスタンプ。 |
|
| セッションが期限切れになるまでの最大非アクティブ期間(秒単位)。 |
|
| セッションの有効期限が切れているかどうか。 |
単一セッションの取得
単一のセッションを取得するには、次の curl ベースの例に示すように、GET
リクエストを /actuator/sessions/{id}
に作成します。
$ curl 'http://localhost:8080/actuator/sessions/4db5efcc-99cb-4d05-a52c-b49acfbb7ea9' -i -X GET
上記の例は、id
が 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9
のセッションを取得します。結果のレスポンスは次のようになります。
HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 208
{"id":"4db5efcc-99cb-4d05-a52c-b49acfbb7ea9","attributeNames":[],"creationTime":"2024-10-24T06:38:16.711918998Z","lastAccessedTime":"2024-10-24T11:37:39.711921814Z","maxInactiveInterval":1800,"expired":false}
レスポンス構造
レスポンスには、リクエストされたセッションの詳細が含まれます。次の表に、レスポンスの構造を示します。
パス | タイプ | 説明 |
---|---|---|
|
| セッションの ID。 |
|
| セッションに保存されている属性の名前。 |
|
| セッションが作成されたときのタイムスタンプ。 |
|
| セッションが最後にアクセスされたときのタイムスタンプ。 |
|
| セッションが期限切れになるまでの最大非アクティブ期間(秒単位)。 |
|
| セッションの有効期限が切れているかどうか。 |