セッション (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" : [ {
    "attributeNames" : [ ],
    "creationTime" : "2026-04-23T01:53:00.764939737Z",
    "expired" : false,
    "id" : "f187c262-6488-4a8d-b2c0-562a6493819b",
    "lastAccessedTime" : "2026-04-23T13:52:15.764945157Z",
    "maxInactiveInterval" : 1800
  }, {
    "attributeNames" : [ ],
    "creationTime" : "2026-04-23T08:53:00.765613576Z",
    "expired" : false,
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "lastAccessedTime" : "2026-04-23T13:52:23.765615470Z",
    "maxInactiveInterval" : 1800
  }, {
    "attributeNames" : [ ],
    "creationTime" : "2026-04-23T11:53:00.765617935Z",
    "expired" : false,
    "id" : "ad032391-5d34-49a3-9add-6fd2d7e0692f",
    "lastAccessedTime" : "2026-04-23T13:52:48.765618385Z",
    "maxInactiveInterval" : 1800
  } ]
}

クエリパラメーター

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

パラメーター 説明

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

{"attributeNames":[],"creationTime":"2026-04-23T08:53:00.765613576Z","expired":false,"id":"4db5efcc-99cb-4d05-a52c-b49acfbb7ea9","lastAccessedTime":"2026-04-23T13:52:23.765615470Z","maxInactiveInterval":1800}

レスポンス構造

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

パス タイプ 説明

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 であるセッションを削除します。