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 Category" operation, it retrieves detailed information about a global tag category within the DSS instance.

Common scenarios where this node is beneficial include:

  • Managing metadata tags and categories in Dataiku DSS to organize datasets, projects, or other resources.
  • Automating retrieval of tag category details for auditing or reporting purposes.
  • Integrating DSS administration tasks into broader workflows, such as governance or compliance pipelines.

Practical example:

  • A user wants to fetch details about a specific global tag category named "Data Sensitivity" to verify its properties before applying tags to datasets programmatically.

Properties

Name Meaning
Category Name The name of the global tag category to retrieve details for. This is required for operations involving categories and tags under DSS Administration.

Output

The output of the "Get Category" operation is a JSON object containing the details of the specified global tag category. This typically includes metadata such as the category's name, description, and possibly associated tags or configuration settings.

If the operation succeeds, the node returns an array of JSON objects representing the category details.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key credential) for authentication with the 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 node throws "Missing Dataiku DSS API Credentials," ensure that the API key credential is properly set up and selected in the node.
  • Required Parameter Missing: Errors like "Category Name is required" indicate that the input property was not provided. Make sure to specify the category name when using this operation.
  • HTTP Errors: Network issues or incorrect server URLs can cause request failures. Verify the DSS server address and network connectivity.
  • Parsing Errors: If the response cannot be parsed as JSON, check if the DSS API endpoint is returning valid JSON or if there are permission issues.

Links and References

Discussion