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 Managed Folder resource and the List Files in Managed Folder operation, the node lists the contents (files) within a specified managed folder in a Dataiku DSS project.

This functionality is useful when you want to programmatically retrieve and process the list of files stored in a managed folder within a Dataiku DSS project. For example, you might use this to automate workflows that depend on file availability or to trigger downstream processing based on folder contents.

Properties

Name Meaning
Project Key The key identifier of the Dataiku DSS project containing the managed folder.
Folder ID The identifier of the managed folder whose files you want to list.

These properties are required to specify which project's managed folder's contents should be listed.

Output

The output of this operation is a JSON array where each item represents a file or content entry in the managed folder. The exact structure depends on the Dataiku DSS API response but typically includes metadata about each file such as name, path, size, modification date, etc.

If the operation involves downloading files (not applicable for listing), binary data would be returned representing the file content. However, for the "List Files in Managed Folder" operation, only JSON metadata about the files is returned.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key token) 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 node throws an error about missing API credentials, ensure that the Dataiku DSS API credentials are properly set up in n8n.
  • Project Key or Folder ID Missing: The node requires both the project key and folder ID to be provided. Omitting these will cause errors.
  • API Request Failures: Network issues, incorrect server URLs, or invalid API keys can cause request failures. Verify connectivity and credential validity.
  • Unexpected Response Format: If the API changes or returns unexpected data, parsing errors may occur. Check the Dataiku DSS API documentation for updates.

Links and References

Discussion