Document the datasources.update_data method

Author: vogelsgesang

docs/api-ref.md

@@ -748,6 +748,41 @@ An updated `ConnectionItem` for the data source.
 See the `update_connection.py` sample in the Samples directory.
 
 
+<br>
+<br>
+
+#### datasource.update_data
+
+```py
+datasource.update_date(datasource_or_connection_item, *, request_id, actions, payload)
+```
+
+Updates the data contained within a published live-to-Hyper datasource.
+
+REST API: [Update Data in Published Live-to-Hyper Data Sources](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_how_to_update_data_to_hyper.htm)
+
+
+**Parameters**
+
+Name   |  Description
+ :--- | : ---
+`datasource_or_connection_item` | Either a `DataSourceItem` or a `ConnectionItem`. If the datasource only contains a single connections, the `DataSourceItem` is sufficient to identify which data should be updated. Otherwise, for datasources with multiple connections, a `ConnectionItem` must be provided.
+`request_id` | used as an idempotency key
+`actions` | a list of actions (insert, update, delete, ...) specifying how to modify the data within the published datasource
+`payload` | an (optional) Hyper file containing tuples to be inserted/deleted or other payload data used by the `actions`.
+
+For more information on the `actions`, see the [REST API docs on "Action batch description"](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_how_to_update_data_to_hyper.htm#action-batch-descriptions).
+To create a `payload` Hyper file, you can use [Hyper API](https://help.tableau.com/current/api/hyper_api/en-us/index.html) or [pantab](https://github.com/innobi/pantab).
+
+**Returns**
+
+A `JobItem` for the update job on the server. Upon completion of this job, the data was updated.
+
+**Example**
+
+See the `update_datasource_data.py` sample in the Samples directory.
+
+
 <br>
 <br>
 

docs/samples.md

@@ -59,5 +59,6 @@ The following list describes the samples available in the repository:
 * `set_http_options.py` Demonstrates HTTP options for the server and specifically for downloading workbooks.
 * `set_refresh_schedule.py` Sets the schedule to refresh a workbook or datasource.
 * `update_connection.py` Updates and embeds connection credentials of a datasource.
+* `update_datasource_data.py` Updates the data within a published live-to-Hyper datasource.
 
 **Note**: For all of the samples, ensure that your Tableau Server user account has permission to access the resources. Also keep in mind that some example operations (like create group) are not allowed on Tableau Online.