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 - Update Category operation, it allows updating one or more properties of a global tag category in the DSS environment.

Common scenarios where this node is beneficial include:

  • Managing metadata categories used for tagging datasets or projects.
  • Automating updates to tag categories as part of data governance workflows.
  • Integrating DSS administration into broader automation pipelines.

For example, you might use this node to update the description or other attributes of a global tag category to reflect changes in your organization's data classification standards.

Properties

Name Meaning
Category Name The name of the global tag category to update. This identifies which category will be modified.
Request Body A JSON object containing the properties to update on the specified category.

The Request Body property expects a JSON structure that defines the fields and values to update for the category. The exact schema depends on the Dataiku DSS API specification for global tag categories.

Output

The node outputs the response from the Dataiku DSS API call in the json field of the output. This typically includes the updated details of the global tag category after the update operation.

If the API returns binary data (not typical for this operation), it would be provided in the binary field, but for updating a category, the output is expected to be JSON.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Needs valid API credentials including the DSS server URL and a user API key.
  • The node uses HTTP requests to interact with the DSS REST API.
  • Proper permissions are required on the DSS side to update global tag categories.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the API key and DSS server URL are correctly configured in the node's credential settings.
  • Category Name Required: The operation requires the "Category Name" property; omitting it will cause an error.
  • Invalid JSON in Request Body: Ensure the JSON provided in the "Request Body" is well-formed and matches the expected schema for category updates.
  • API Permission Errors: If the API returns permission denied errors, verify that the API key has sufficient rights to modify global tag categories.
  • Network Issues: Connection failures may occur if the DSS server URL is incorrect or unreachable.

Links and References


This summary focuses on the "DSS Administration" resource and the "Update Category" operation as requested, based on static analysis of the provided source code and input properties.

Discussion