Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

The node provides integration with the Dataiku DSS API, enabling users to perform a wide range of operations on various Dataiku DSS resources. Specifically for the Macro resource and the Abort Macro operation, this node allows users to abort a running macro execution in a specified project. This is useful when a macro run needs to be stopped prematurely due to errors, changed requirements, or manual intervention.

Common scenarios include:

  • Stopping a long-running or stuck macro process.
  • Managing automation workflows where conditional logic requires halting a macro.
  • Integrating macro control within larger data pipelines or orchestrations.

Example use case:

  • A user triggers a macro run but detects an issue in the input data; they can use this node to abort the macro run programmatically before it completes.

Properties

Name Meaning
Project Key The unique key identifying the Dataiku DSS project containing the macro.
Runnable Type The type of runnable entity (e.g., macro) to target for the abort operation.
Run The identifier of the specific macro run instance to abort.

These properties are required to specify which macro run should be aborted within which project and runnable type.

Output

The output JSON contains the response from the Dataiku DSS API after attempting to abort the macro run. Typically, this will confirm whether the abort request was successful or provide error details if it failed.

If the operation involves downloading files or binary content (not applicable for aborting macros), the node would return binary data prepared accordingly. For the Abort Macro operation, the output is JSON indicating the status of the abort request.

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 API credentials are not set or invalid, the node will throw an error indicating missing credentials.
  • Required Parameter Missing: Errors will occur if any of the required parameters (Project Key, Runnable Type, or Run) are not provided.
  • API Request Failures: Network issues, incorrect project keys, or invalid run IDs may cause API call failures. The node returns detailed error messages from the API to help diagnose these issues.
  • Permission Issues: Ensure the API key has sufficient permissions to abort macro runs in the specified project.

Links and References


This summary focuses on the Macro resource's Abort Macro operation as requested, based on static analysis of the provided source code and property definitions.

Discussion