セッション (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: 789

{
  "sessions" : [ {
    "id" : "220c01e4-fb37-404f-ba6e-93f9d9c1fed4",
    "attributeNames" : [ ],
    "creationTime" : "2025-05-22T08:03:34.888566190Z",
    "lastAccessedTime" : "2025-05-22T20:02:49.888573274Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "attributeNames" : [ ],
    "creationTime" : "2025-05-22T15:03:34.892864120Z",
    "lastAccessedTime" : "2025-05-22T20:02:57.892867627Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "c32f6f36-8b34-4328-a51a-658946a3eef0",
    "attributeNames" : [ ],
    "creationTime" : "2025-05-22T18:03:34.892870943Z",
    "lastAccessedTime" : "2025-05-22T20:03:22.892871694Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  } ]
}

クエリパラメーター

エンドポイントはクエリパラメーターを使用して、返すセッションを制限します。次の表に、単一の必須クエリパラメーターを示します。

パラメーター 説明

username

ユーザーの名前。

レスポンス構造

レスポンスには、一致するセッションの詳細が含まれます。次の表に、レスポンスの構造を示します。

パス タイプ 説明

sessions

Array

指定されたユーザー名のセッション。

sessions.[].id

String

セッションの ID。

sessions.[].attributeNames

Array

セッションに保存されている属性の名前。

sessions.[].creationTime

String

セッションが作成されたときのタイムスタンプ。

sessions.[].lastAccessedTime

String

セッションが最後にアクセスされたときのタイムスタンプ。

sessions.[].maxInactiveInterval

Number

セッションが期限切れになるまでの最大非アクティブ期間（秒単位）。

sessions.[].expired

Boolean

セッションの有効期限が切れているかどうか。

単一セッションの取得

単一のセッションを取得するには、次の 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":"2025-05-22T15:03:34.892864120Z","lastAccessedTime":"2025-05-22T20:02:57.892867627Z","maxInactiveInterval":1800,"expired":false}

レスポンス構造

レスポンスには、リクエストされたセッションの詳細が含まれます。次の表に、レスポンスの構造を示します。

パス タイプ 説明

id

String

セッションの ID。

attributeNames

Array

セッションに保存されている属性の名前。

creationTime

String

セッションが作成されたときのタイムスタンプ。

lastAccessedTime

String

セッションが最後にアクセスされたときのタイムスタンプ。

maxInactiveInterval

Number

セッションが期限切れになるまでの最大非アクティブ期間（秒単位）。

expired

Boolean

セッションの有効期限が切れているかどうか。

セッションを削除する

セッションを削除するには、次の curl ベースの例に示すように、DELETE リクエストを /actuator/sessions/{id} に作成します。

$ curl 'http://localhost:8080/actuator/sessions/4db5efcc-99cb-4d05-a52c-b49acfbb7ea9' -i -X DELETE

上記の例は、id が 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9 であるセッションを削除します。