Dataiku DSSInstall

Overview

This node integrates with the Dataiku DSS API, enabling users to perform a wide range of administrative and operational tasks on a Dataiku DSS instance. Specifically, for the DSS Administration - Delete Category operation, it allows deleting an existing global tag category from the DSS instance.

Common scenarios where this node is beneficial include automating Dataiku DSS management workflows such as managing tags, categories, projects, datasets, and other resources programmatically. For example, an administrator can automate cleanup by deleting obsolete tag categories or integrate category deletion into larger project lifecycle automation.

Practical example:

• Automatically delete a global tag category when it is no longer needed, ensuring that the DSS environment remains clean and organized without manual intervention.

Properties

The node supports many other properties for different operations and resources, but for the Delete Category operation under DSS Administration, the key input is the Category Name.

Output

The output JSON contains the response from the Dataiku DSS API after attempting to delete the specified category. Typically, this will be a confirmation of deletion or an error message if the operation failed.

• If the deletion is successful, the output may be empty or contain status information.
• If the API returns logs or textual data, it will be included in the output.
• No binary data output is expected for this operation.

Example output (success):

{
  "Status Code": "204 No Content"
}

Example output (error):

{
  "error": "Category not found"
}

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 base URL of the DSS server and the user API key to be configured in the credentials.
• No additional external dependencies beyond the Dataiku DSS API and n8n's HTTP request capabilities.

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 the "Category Name" property; omitting it will cause an error.
• API Errors: Common API errors might include "Category not found" if the specified category does not exist, or permission errors if the API key lacks sufficient rights.
• Network Issues: Ensure the DSS server URL is reachable from the n8n environment.
• Unexpected Response Format: If the API response cannot be parsed as JSON, the raw text will be returned; check the API server logs or network responses for details.

Links and References

• Dataiku DSS API Documentation
• Dataiku DSS Global Tag Categories API
• n8n Documentation on Creating Custom Nodes

This summary focuses on the DSS Administration - Delete Category operation extracted from the provided source code and property definitions.