Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to perform a wide range of administrative and operational tasks within a Dataiku DSS instance. Specifically, for the "DSS Administration" resource and the "Create Tag" operation, it allows adding a new tag to an existing global tag category in the DSS environment.

Common scenarios where this node is beneficial include automating the management of tags and categories used for organizing and classifying data assets, projects, or other entities within Dataiku DSS. For example, a user might automate the creation of tags to classify datasets by sensitivity level or business domain, facilitating governance and searchability.

Practical example:

  • Automatically create a new tag named "Confidential" under the category "Data Sensitivity" to label datasets that contain sensitive information.

Properties

Name Meaning
Category Name The name of the global tag category under which the new tag will be created.
Request Body A JSON object representing the details of the tag to create. This typically includes the tag's properties such as its name and description.

Output

The node outputs the response from the Dataiku DSS API call in the json field. For the "Create Tag" operation, this will generally be a JSON object representing the newly created tag, including its attributes as returned by the DSS API.

If the operation involves binary data (not typical for Create Tag), the node would output the binary content accordingly, but for this operation, the output is JSON.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key) for authentication with the DSS server.
  • The node expects the 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 credentials, ensure that the Dataiku DSS API credentials are properly set up in n8n.
  • Category Name Required: The operation requires a valid "Category Name". If omitted or incorrect, the node will throw an error indicating this requirement.
  • Request Body Format: The request body must be a valid JSON object describing the tag. Invalid JSON or missing required fields may cause the API call to fail.
  • API Errors: Errors returned from the DSS API (e.g., permission denied, category not found) will be surfaced by the node. Check the API response message for details.
  • Network Issues: Ensure that the DSS server URL is reachable from the n8n environment.

Links and References


This summary focuses on the "DSS Administration" resource and the "Create Tag" operation as requested, based on static analysis of the provided source code and property definitions.

Discussion