最新の安定バージョンについては、Spring Boot 4.0.2 を使用してください！

セッション (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" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "attributeNames" : [ ],
    "creationTime" : "2026-01-22T03:01:04.057997717Z",
    "lastAccessedTime" : "2026-01-22T08:00:27.058000112Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "5869b9a7-6be7-4a09-a8ac-a1b186650aae",
    "attributeNames" : [ ],
    "creationTime" : "2026-01-21T20:01:04.057001614Z",
    "lastAccessedTime" : "2026-01-22T08:00:19.057007986Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "a44c5e4a-e280-4a17-9673-1c75837eefcd",
    "attributeNames" : [ ],
    "creationTime" : "2026-01-22T06:01:04.058002937Z",
    "lastAccessedTime" : "2026-01-22T08:00:52.058003528Z",
    "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":"2026-01-22T03:01:04.057997717Z","lastAccessedTime":"2026-01-22T08:00:27.058000112Z","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 であるセッションを削除します。