Dataiku DSSInstall

Overview

This node integrates with the Dataiku DSS API, enabling users to perform various administrative and operational tasks on a Dataiku DSS instance. Specifically, for the DSS Administration - Update Tag operation, it allows updating one or more properties of a global tag within a specified global tag category.

This operation is useful in scenarios where you need to manage metadata tags centrally in your Dataiku DSS environment, such as modifying tag descriptions, colors, or other attributes to keep your tagging system consistent and up-to-date.

Practical example:
You have a global tag category "Data Quality" with several tags representing different quality levels. You want to update the description or color of a specific tag "High Quality" to better reflect its meaning or usage across projects. This node operation lets you do that programmatically via the API.

Properties

Output

The output is a JSON object representing the updated tag details as returned by the Dataiku DSS API after the update operation. It typically includes the tag's current properties such as name, description, color, and any other metadata fields supported by the API.

If the operation involves downloading files or binary data (not applicable for this operation), the node would output binary data accordingly, but for the "Update Tag" operation, the output is purely JSON.

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 credentials. Ensure you configure the API key credential properly.
• Required Parameter Missing: The node validates required parameters like Category Name and Tag Name. If these are missing, it throws an error specifying which parameter is required.
• API Errors: If the Dataiku DSS API returns an error (e.g., tag or category not found, permission denied), the node will throw an error with the message from the API. Verify that the category and tag exist and that the API key has sufficient permissions.
• Invalid JSON in Request Body: The Request Body must be valid JSON. Invalid JSON will cause parsing errors. Use proper JSON formatting.

Links and References

• Dataiku DSS API Documentation - Global Tags
• Dataiku DSS Official Website
• n8n Documentation