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.
Contents:
The collection of Jupyter Notebooks examples on how to use the DestinE Data Lake services can be found at Destination Earth on Github.