This version is still in development and is not considered stable yet. For the latest stable version, please use Spring Boot 3.3.4!spring-doc.cn

This version is still in development and is not considered stable yet. For the latest stable version, please use Spring Boot 3.3.4!spring-doc.cn

The sessions endpoint provides information about the application’s HTTP sessions that are managed by Spring Session.spring-doc.cn

Retrieving Sessions

To retrieve the sessions, make a GET request to /actuator/sessions, as shown in the following curl-based example:spring-doc.cn

$ curl 'http://localhost:8080/actuator/sessions?username=alice' -i -X GET

The preceding examples retrieves all of the sessions for the user whose username is alice. The resulting response is similar to the following:spring-doc.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 789

{
  "sessions" : [ {
    "id" : "205bdeeb-9c3d-4e98-8f72-fa1447055f92",
    "attributeNames" : [ ],
    "creationTime" : "2024-10-02T10:55:08.184109410Z",
    "lastAccessedTime" : "2024-10-02T12:54:56.184110141Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "52c20715-8631-4641-bac6-5105f5526792",
    "attributeNames" : [ ],
    "creationTime" : "2024-10-02T00:55:08.183221122Z",
    "lastAccessedTime" : "2024-10-02T12:54:23.183229207Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  }, {
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "attributeNames" : [ ],
    "creationTime" : "2024-10-02T07:55:08.184103729Z",
    "lastAccessedTime" : "2024-10-02T12:54:31.184106474Z",
    "maxInactiveInterval" : 1800,
    "expired" : false
  } ]
}

Query Parameters

The endpoint uses query parameters to limit the sessions that it returns. The following table shows the single required query parameter:spring-doc.cn

Parameter Description

usernamespring-doc.cn

Name of the user.spring-doc.cn

Response Structure

The response contains details of the matching sessions. The following table describes the structure of the response:spring-doc.cn

Path Type Description

sessionsspring-doc.cn

Arrayspring-doc.cn

Sessions for the given username.spring-doc.cn

sessions.[].idspring-doc.cn

Stringspring-doc.cn

ID of the session.spring-doc.cn

sessions.[].attributeNamesspring-doc.cn

Arrayspring-doc.cn

Names of the attributes stored in the session.spring-doc.cn

sessions.[].creationTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was created.spring-doc.cn

sessions.[].lastAccessedTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was last accessed.spring-doc.cn

sessions.[].maxInactiveIntervalspring-doc.cn

Numberspring-doc.cn

Maximum permitted period of inactivity, in seconds, before the session will expire.spring-doc.cn

sessions.[].expiredspring-doc.cn

Booleanspring-doc.cn

Whether the session has expired.spring-doc.cn
Parameter Description

usernamespring-doc.cn

Name of the user.spring-doc.cn
Path Type Description

sessionsspring-doc.cn

Arrayspring-doc.cn

Sessions for the given username.spring-doc.cn

sessions.[].idspring-doc.cn

Stringspring-doc.cn

ID of the session.spring-doc.cn

sessions.[].attributeNamesspring-doc.cn

Arrayspring-doc.cn

Names of the attributes stored in the session.spring-doc.cn

sessions.[].creationTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was created.spring-doc.cn

sessions.[].lastAccessedTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was last accessed.spring-doc.cn

sessions.[].maxInactiveIntervalspring-doc.cn

Numberspring-doc.cn

Maximum permitted period of inactivity, in seconds, before the session will expire.spring-doc.cn

sessions.[].expiredspring-doc.cn

Booleanspring-doc.cn

Whether the session has expired.spring-doc.cn

Retrieving a Single Session

To retrieve a single session, make a GET request to /actuator/sessions/{id}, as shown in the following curl-based example:spring-doc.cn

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

The preceding example retrieves the session with the id of 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9. The resulting response is similar to the following:spring-doc.cn

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-02T07:55:08.184103729Z","lastAccessedTime":"2024-10-02T12:54:31.184106474Z","maxInactiveInterval":1800,"expired":false}

Response Structure

The response contains details of the requested session. The following table describes the structure of the response:spring-doc.cn

Path Type Description

idspring-doc.cn

Stringspring-doc.cn

ID of the session.spring-doc.cn

attributeNamesspring-doc.cn

Arrayspring-doc.cn

Names of the attributes stored in the session.spring-doc.cn

creationTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was created.spring-doc.cn

lastAccessedTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was last accessed.spring-doc.cn

maxInactiveIntervalspring-doc.cn

Numberspring-doc.cn

Maximum permitted period of inactivity, in seconds, before the session will expire.spring-doc.cn

expiredspring-doc.cn

Booleanspring-doc.cn

Whether the session has expired.spring-doc.cn
Path Type Description

idspring-doc.cn

Stringspring-doc.cn

ID of the session.spring-doc.cn

attributeNamesspring-doc.cn

Arrayspring-doc.cn

Names of the attributes stored in the session.spring-doc.cn

creationTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was created.spring-doc.cn

lastAccessedTimespring-doc.cn

Stringspring-doc.cn

Timestamp of when the session was last accessed.spring-doc.cn

maxInactiveIntervalspring-doc.cn

Numberspring-doc.cn

Maximum permitted period of inactivity, in seconds, before the session will expire.spring-doc.cn

expiredspring-doc.cn

Booleanspring-doc.cn

Whether the session has expired.spring-doc.cn

Deleting a Session

To delete a session, make a DELETE request to /actuator/sessions/{id}, as shown in the following curl-based example:spring-doc.cn

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

The preceding example deletes the session with the id of 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9.spring-doc.cn