Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, allowing users to perform a wide range of operations on various Dataiku DSS resources. Specifically for the Project Folder resource and the Move Project operation, it enables moving a project from one project folder to another within the current project folder hierarchy.

Common scenarios where this node is beneficial include:

  • Organizing projects by relocating them into different folders to maintain a clean project structure.
  • Automating project management workflows that involve restructuring project folders.
  • Integrating project folder management into larger automation pipelines.

Example use case:

  • You have multiple projects in a root folder and want to programmatically move a specific project into a subfolder based on certain criteria or triggers.

Properties

Name Meaning
Project Key The unique identifier key of the project to be moved.
Folder ID The identifier of the target project folder where the project will be moved.
Query Parameters Optional additional query parameters to customize the API request (key-value pairs).

Output

The node outputs the JSON response returned by the Dataiku DSS API after attempting to move the project. This typically includes confirmation of the move operation or details about the updated project folder structure.

If the operation involves downloading files or binary data (not applicable for Move Project), the node would output binary data accordingly, but for this operation, the output is JSON only.

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 base URL of the DSS server and the user API key credential to be configured in n8n.

Troubleshooting

  • Missing Credentials Error: If the API credentials are not provided or invalid, the node will throw an error indicating missing Dataiku DSS API credentials.
  • Required Parameter Missing: The node validates required parameters such as Project Key and Folder ID. If these are missing, it throws descriptive errors like "Project Key is required" or "Folder ID is required".
  • API Request Failures: Network issues, incorrect server URLs, or insufficient permissions can cause API call failures. The node surfaces these errors with messages prefixed by "Error calling Dataiku DSS API".
  • Invalid Operation or Resource: If an unsupported resource or operation is selected, the node throws an error indicating an unknown resource or operation.

To resolve common errors:

  • Ensure all required input properties are set correctly.
  • Verify API credentials and server connectivity.
  • Confirm that the user has sufficient permissions to move projects within the specified folders.

Links and References


This summary focuses on the Project Folder resource and the Move Project operation as requested, based on static analysis of the provided source code and property definitions.

Discussion