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 Scenario resource and the Get Scenario operation, the node retrieves detailed information about a specific scenario within a given project in Dataiku DSS.

Common use cases include:

  • Automating retrieval of scenario configurations or statuses as part of a workflow.
  • Monitoring scenarios programmatically to trigger alerts or downstream processes.
  • Integrating scenario data into dashboards or reports.

Example: You want to fetch the details of a scenario identified by its ID in a particular project to check its configuration or status before deciding whether to run it or modify it.

Properties

Name Meaning
Project Key The unique key identifying the Dataiku DSS project containing the scenario.
Scenario ID The unique identifier of the scenario to retrieve details for.

These properties are required inputs when performing the "Get Scenario" operation.

Output

The output is a JSON object representing the retrieved scenario details from the Dataiku DSS API. This typically includes all metadata and configuration information about the specified scenario.

  • The output is returned as a JSON array with one element per input item.
  • If the API returns binary data (not typical for this operation), it would be provided in the binary field, but for "Get Scenario" the response is JSON.
  • If no content is returned, the node outputs a status code indicating "204 No Content".

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 node throws "Missing Dataiku DSS API Credentials", ensure that you have configured the API key credential correctly in n8n.
  • Required Parameter Errors: The node validates required parameters such as Project Key and Scenario ID. If these are missing, errors like "Project Key is required" or "Scenario Key is required" will appear. Provide these values to resolve.
  • API Request Failures: Network issues, incorrect server URLs, or invalid API keys can cause request failures. Check connectivity and credentials.
  • Unexpected Response Format: If the API response cannot be parsed as JSON, the node attempts to return raw text. Verify the API endpoint and parameters.

Links and References


This summary focuses on the "Scenario" resource and the "Get Scenario" operation based on the provided source code and property definitions.

Discussion