DeleteSessions - NICE DCV Session Manager


Deletes the specified NICE DCV session and removes it from the Broker's cache.

Request parameters


The ID of the session to delete.

Type: String

Required: Yes


The owner of the session to delete.

Type: String

Required: Yes


Removes a session from the Broker's cache with attempting to delete it from the NICE DCV server. This is useful for removing outdated sessions from the Broker's cache. For example, if a NICE DCV server was stopped, but the sessions are still registered on the Broker, use this flag to purge the sessions from the Broker's cache.

Keep in mind that if the session is still active, it is re-cached by the Broker.

Valid values: true | false

Type: Boolean

Required: No

Response parameters


The ID of the session


Only returned if the sessions were successfully deleted. Indicates the current state of the session. If the request completes successfully, the session transitions to the DELETING state. It could take a few minutes for the session to be deleted. When it has been deleted, the state transitions from DELETING to DELETED.


Only returned if some sessions could not be deleted. Indicates why the session could not be deleted.




The following example deletes two sessions—a session with an ID of SessionId123 that is owned by user1, and a session with an ID of SessionIdabc that is owned by user99.

from swagger_client.models.delete_session_request_data import DeleteSessionRequestData def get_sessions_api(): api_instance = swagger_client.SessionsApi(swagger_client.ApiClient(get_client_configuration())) set_request_headers(api_instance.api_client) return api_instance def delete_sessions(sessions_to_delete, force=False): delete_sessions_request = list() for session_id, owner in sessions_to_delete: a_request = DeleteSessionRequestData(session_id=session_id, owner=owner, force=force) delete_sessions_request.append(a_request) print('Delete Sessions Request:', delete_sessions_request) api_instance = get_sessions_api() api_response = api_instance.delete_sessions(body=delete_sessions_request) print('Delete Sessions Response', api_response) def main(): delete_sessions([('SessionId123', 'an owner user1'), ('SessionIdabc', 'user99')])


The following is the sample output. SessionId123 was successfully deleted, while SessionIdabc could not be deleted.

{ "RequestId": "10311636-df90-4cd1-bcf7-474e9675b7cd", "SuccessfulList": [ { "SessionId": "SessionId123", "State": "DELETING" } ], "UnsuccessfulList": [ { "SessionId": "SessionIdabc", "FailureReason": "The requested dcvSession does not exist" } ] }