Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling automation and management of various Dataiku DSS resources. Specifically, for the "Create Project From Bundle With Archive" operation under the "Bundles Automation-Side" resource, it allows users to create a new project in Dataiku DSS from an existing bundle archive. This is useful for automating project creation workflows where projects are packaged as bundles and need to be instantiated programmatically.

Common scenarios include:

  • Automating deployment pipelines by creating projects from pre-built bundles.
  • Migrating or replicating projects across different Dataiku DSS instances.
  • Integrating Dataiku DSS project creation into larger data orchestration workflows.

Example: Automatically create a new Dataiku DSS project from a bundle archive stored in your environment, triggered by an external event or schedule.

Properties

Name Meaning
Query Parameters A collection of optional query parameters that can be added to the API request URL. Includes many possible keys such as archivePath, projectKey, wait, withScenarios, etc., allowing fine control over the creation process.
projectKey The key identifier of the project to create or target.
archivePath Path to the archive file containing the bundle to use for project creation.
wait Boolean flag indicating whether to wait for the project creation process to complete before returning. Defaults to true.
withScenarios Boolean flag indicating whether to include scenarios when creating the project from the bundle. Defaults to true.
exportAnalysisModels Boolean flag to export analysis models during the bundle processing. Defaults to true.
exportManaged Boolean flag to export managed datasets during the bundle processing. Defaults to true.
exportSavedModels Boolean flag to export saved models during the bundle processing. Defaults to true.
exportUploads Boolean flag to export uploaded files during the bundle processing. Defaults to true.

Note: The full list of query parameters is extensive and includes many other options related to project configuration, folder IDs, deletion modes, and more, providing detailed customization of the project creation process.

Output

The node outputs the JSON response returned by the Dataiku DSS API after attempting to create the project from the bundle archive. The output structure depends on the API response but typically includes details about the created project or status information.

If the operation involves downloading files (not applicable here), binary data would be prepared 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 credential) for authentication with the Dataiku DSS API.
  • The node uses HTTP requests to communicate with the Dataiku DSS REST API endpoints.
  • No additional external services beyond Dataiku DSS are required.

Troubleshooting

  • Missing Credentials Error: If the API credentials are not provided or invalid, the node will throw an error "Missing Dataiku DSS API Credentials". Ensure you have configured the API key credential correctly.
  • Required Parameter Missing: The node validates required parameters like projectKey and others depending on the operation. If missing, it throws errors specifying which parameter is required.
  • API Request Failures: Errors from the Dataiku DSS API (e.g., network issues, permission denied, invalid bundle archive) will be surfaced as node errors with messages prefixed by "Error calling Dataiku DSS API".
  • Timeouts: If wait is set to true, the node waits for the project creation to complete; if the process takes too long, consider setting wait to false or increasing timeout settings externally.
  • Invalid Bundle Archive: Ensure the archive path or file used is a valid Dataiku DSS bundle archive compatible with the target DSS version.

Links and References


This summary focuses on the "Create Project From Bundle With Archive" operation within the "Bundles Automation-Side" resource, describing its purpose, input properties, output, dependencies, and common troubleshooting points based on static code analysis.

Discussion