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 on a Dataiku DSS instance. Specifically, for the "DSS Administration" resource and the "Get Tag" operation, it retrieves details about a global tag within a specified category on the DSS instance.

Common scenarios where this node is beneficial include:

  • Managing metadata tags used across projects in Dataiku DSS.
  • Automating retrieval of tag information for auditing or reporting purposes.
  • Integrating tag data into workflows that require dynamic access to DSS tag metadata.

Practical example:

  • A user wants to fetch details of a specific tag under a global tag category to verify its properties before applying it to datasets or projects programmatically.

Properties

Name Meaning
Category Name The name of the global tag category containing the tag. Required to identify the category.
Tag Name The name of the tag within the specified category whose details are to be retrieved.

Output

The node outputs JSON data representing the details of the requested global tag from the specified category. This includes all metadata and properties associated with that tag as returned by the Dataiku DSS API.

If the operation involves downloading files (not applicable for "Get Tag"), the node would output binary data representing the downloaded file.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Needs an API key credential for authenticating requests to the Dataiku DSS API.
  • The node expects the DSS server URL and user API key to be configured in the credentials.

Troubleshooting

  • Missing Credentials Error: If the API key credential is not provided or invalid, the node will throw an error indicating missing credentials. Ensure the API key is correctly set up.
  • Required Parameter Missing: The node validates required parameters such as "Category Name" and "Tag Name". Omitting these will cause errors. Provide all mandatory inputs.
  • API Request Failures: Network issues, incorrect server URLs, or insufficient permissions can cause API call failures. Verify connectivity and user permissions on the DSS instance.
  • Parsing Errors: If the API response is malformed or unexpected, JSON parsing may fail. Check the DSS API status and response format.

Links and References

Discussion