Navigation

killSessions

On this page

Definition

killSessions

New in version 3.6.

The killSessions command kills the specified sessions. If access control is enabled, the command only kills the sessions owned by the user.

Note

Killing a session also kills any in-progress operations in the session and closes any open cursors associated with these operations.

killSessions has the following syntax:

{ killSessions: [ { id : <UUID> }, ... ] } )

The command takes an array of documents that specify the UUID portion of the session id. If you specify an empty array, the command kills all sessions, or if access control is enabled, all sessions owned by the user.

To run killSessions, use the db.runCommand( { <command> } ) method.

To view existing sessions, see $listSessions operation or $listLocalSessions.

Behavior

Session Identification

MongoDB concatenates each of the specified UUIDs with the hash of the authenticated user credentials to identify the user’s sessions to kill. If the user has no session that match, the killSessions has no effect.

Example

The following operation kills the specified session for the user:

db.runCommand( { killSessions: [ { id: UUID("f9b3d8d9-9496-4fff-868f-04a6196fc58a") } ] } )