Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node interacts with the Dataiku DSS API to manage various resources within a Dataiku project. Specifically, for the Webapp resource and the Stop Webapp Backend operation, it stops the backend service of a specified web application within a given project.

This functionality is useful when you need to programmatically control the lifecycle of web applications hosted in Dataiku DSS, such as stopping a webapp backend for maintenance, updates, or resource management.

Example use case:

  • Automatically stop a webapp backend after certain workflows complete to save resources.
  • Integrate with deployment pipelines where the webapp backend needs to be stopped before redeployment.

Properties

Name Meaning
Project Key The key identifier of the Dataiku project containing the webapp.
Webapp ID The unique identifier of the webapp whose backend you want to stop.

Output

The output of this operation is the JSON response from the Dataiku DSS API indicating the result of the stop backend action. Typically, this will confirm whether the backend was successfully stopped or provide error details if the operation failed.

No binary data is returned for this operation.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key) for authentication with the Dataiku DSS API.
  • The node expects the Dataiku DSS server URL and user API key to be configured in the credentials.

Troubleshooting

  • Missing Credentials Error: If the API credentials are not provided or invalid, the node will throw an error indicating missing credentials.
  • Missing Required Parameters: The node validates that both "Project Key" and "Webapp ID" are provided; otherwise, it throws an error specifying which parameter is missing.
  • API Request Failures: Network issues, incorrect project or webapp IDs, or insufficient permissions can cause API errors. The node surfaces these errors with messages prefixed by "Error calling Dataiku DSS API".
  • Unexpected Response Format: If the API returns a non-JSON response or unexpected content, the node attempts to handle it gracefully but may return raw text or an error.

To resolve common issues:

  • Ensure the API key credential is correctly set up and has sufficient permissions.
  • Verify the project key and webapp ID are correct and exist in the Dataiku DSS instance.
  • Check network connectivity to the Dataiku DSS server.
  • Review API error messages for permission or resource existence issues.

Links and References

Discussion