You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@streampipes.apache.org by "Daniel Ebi (Jira)" <ji...@apache.org> on 2021/04/28 07:42:00 UTC

[jira] [Updated] (STREAMPIPES-349) Redesign and harmonization of the Data Lake REST API

     [ https://issues.apache.org/jira/browse/STREAMPIPES-349?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Daniel Ebi updated STREAMPIPES-349:
-----------------------------------
    Description: 
The objective of the REST API redesign is to increase usability by adapting the endpoint design and simplifying the code.

The redesign is done according to the draft developed and discussed in Confluence [1].

 
 
 
----
[1] [https://cwiki.apache.org/confluence/display/STREAMPIPES/Data+Lake+Sink]

  was:
The objective of the REST API redesign is to increase usability by adapting the endpoint design and simplifying the code.

The redesign is done according to the draft developed and discussed in Confluence [1]

 
||functionality||request type||path||query parameters||payload||
|listing all existing measurement series (incl. event schema)|GET|/measurements|-| |
|removing all existing measurement series|DELETE|/measurements|-| |
|getting data points of a specific measurement series|GET|/measurements/\{measurementID}|+slicing data by timestamp criterion+ * startDate
_start date, if not specified: first element_
 * endDate
_end date, if not specified: last element_

+paging+ * page:
_page number_
 * itemsPerPage / limit:
_limit rows per page_
 * offset:
_specify offset (time_offset)_

+grouping+ * groupBy:
_grouping tags (comma-seperated)_
 * aggregationFunction:
_aggregation function (e.g. mean)_
 * timeInterval:
_time interval for aggregation (e.g. 1m - one minute), if specified: performing group by time_

+downloading
+_can be combined with slicing operators_ * format
_data format (csv, json)_| |
|removing a specific measurement series or selected measurements from that series|DELETE|/measurements/\{measurementID}| * startDate: optional
_start date, if not specified: first element_
 * endDate: optional
_end date, if not specified: last element_| |
|labeling of measurements|POST/
GET
 |/measurements/\{measurementID}/labeling| * startDate:
_start date, if not specified: first element_
 * endDate:
_end date, if not specified: last element_| * column:
_label column_
 * label:
_class label_|
|specifying configuration parameters for a specific measurement series|POST|/measurements/\{measurementID}/configuration|-| * key/value-pairs:_{parameter_name: value}_|
|getting current configuration parameters for a specific measurement series|GET|/measurements/\{measurementID}/configuration|-| |

 
----
[1] https://cwiki.apache.org/confluence/display/STREAMPIPES/Data+Lake+Sink


> Redesign and harmonization of the Data Lake REST API
> ----------------------------------------------------
>
>                 Key: STREAMPIPES-349
>                 URL: https://issues.apache.org/jira/browse/STREAMPIPES-349
>             Project: StreamPipes
>          Issue Type: Improvement
>          Components: Backend, Data Lake
>            Reporter: Daniel Ebi
>            Assignee: Daniel Ebi
>            Priority: P2
>
> The objective of the REST API redesign is to increase usability by adapting the endpoint design and simplifying the code.
> The redesign is done according to the draft developed and discussed in Confluence [1].
>  
>  
>  
> ----
> [1] [https://cwiki.apache.org/confluence/display/STREAMPIPES/Data+Lake+Sink]



--
This message was sent by Atlassian Jira
(v8.3.4#803005)