Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node interacts with the Dataiku DSS API to manage Jupyter notebooks among many other resources. Specifically, for the Notebook resource and the Stop Jupyter Notebook Session operation, it stops an active session of a specified Jupyter notebook within a given project. This is useful when you want to programmatically terminate a running notebook session, for example, to free up resources or enforce session timeouts.

Practical scenarios include:

  • Automatically stopping idle or long-running notebook sessions.
  • Managing notebook lifecycle in automated workflows.
  • Integrating notebook session control into broader data pipeline orchestration.

Properties

Name Meaning
Project Key The unique identifier of the project containing the notebook.
Notebook Name The name of the Jupyter notebook whose session you want to stop.
Session ID The identifier of the specific notebook session to stop.

Output

The output of this operation is the JSON response from the Dataiku DSS API after attempting to stop the notebook session. It typically contains status information about the success or failure of the stop request.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Dataiku DSS API.
  • The node expects the Dataiku DSS server URL and user API key to be configured in the credentials.
  • The node uses HTTP requests to communicate with the Dataiku DSS REST API endpoints.

Troubleshooting

  • Missing Credentials Error: If the API key credential is not provided or invalid, the node will throw an error indicating missing credentials.
  • Required Parameter Missing: The node validates required parameters such as Project Key, Notebook Name, and Session ID. Omitting any of these will cause an error specifying which parameter is missing.
  • API Request Failures: Network issues, incorrect server URL, or insufficient permissions can cause API call failures. The node throws detailed errors including the message and stack trace from the API response.
  • Session Not Found: If the specified session ID does not exist or is already stopped, the API may return an error or a no-content response.

To resolve issues:

  • Ensure all required parameters are correctly set.
  • Verify that the API key has sufficient permissions.
  • Confirm the Dataiku DSS server URL is reachable.
  • Check that the session ID corresponds to an active notebook session.

Links and References

Discussion