Hook Service

Overview - Provided Hooks

The Destination Earth Data Lake (DEDL) ‘Hook service’ provides ready-to-use high level serverless workflows and functions preconfigured to efficiently access and manipulate Destination Earth Data Lake (DEDL) data. A growing number of workflows and functions will provide on-demand capabilities for the diverse data analysis needs.

Overview - Custom Hooks

Users of Destination Earth Data Lake (DEDL) can also create their own ‘Custom Hooks’, for more details click on the ‘Custom Hooks’ link below.

Technology

The Hook Service is based on Argo Workflows which itself runs on top of kubernetes. ‘Provided’ and ‘Custom’ Hooks run as containers and are triggered through a dedicated API provided by Destination Earth Data Lake.

OnDemand Data Processing API

Note

Interaction with the Hook Service is based on the OnDemand Data Processing API. As an Edge Service you will have to have the necessary rights to use this API (See Access DestinE Edge Services)

Error handling

The Hook service provides standard HTTP Status Codes. Status codes starting with 2 indicate that the request was successfully received, understood, and accepted.

If an error occurs, the user will get one of the following status codes:

4xx client error

This means that the request contains bad syntax or cannot be fulfilled. To find the problem, we recommend checking the API documentation or comparing the failed request to a similar but working example and analyzing the differences.

5xx server error

The server failed to fulfill an apparently valid request. This means the error is on the server side. Users are asked to try again after a couple of minutes. If the problem persists, it should be reported to support: FAQs - Support.

Another type of error might occur when the service cannot process the orders successfully. In such cases, users will see their orders in status “Failed”, and a descriptive error message will be provided to support efficient troubleshooting.

The collection of Jupyter Notebooks examples on how to use the DestinE Data Lake services can be found at Destination Earth on Github.