/// <summary>
/// The BatchUpsertTableRows API allows you to upsert one or more rows in a table. The
/// upsert operation takes a filter expression as input and evaluates it to find matching
/// rows on the destination table. If matching rows are found, it will update the cells
/// in the matching rows to new values specified in the request. If no matching rows are
/// found, a new row is added at the end of the table and the cells in that row are set
/// to the new values specified in the request.
///
///
/// <para>
/// You can specify the values to set in some or all of the columns in the table for
/// the matching or newly appended rows. If a column is not explicitly specified for a
/// particular row, then that column will not be updated for that row. To clear out the
/// data in a specific cell, you need to set the value as an empty string ("").
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the BatchUpsertTableRows service method.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
///
/// <returns>The response from the BatchUpsertTableRows service method, as returned by Honeycode.</returns>
/// <exception cref="Amazon.Honeycode.Model.AccessDeniedException">
/// You do not have sufficient access to perform this action. Check that the workbook
/// is owned by you and your IAM policy allows access to the resource in the request.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.InternalServerException">
/// There were unexpected errors from the server.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.RequestTimeoutException">
/// The request timed out.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.ResourceNotFoundException">
/// A Workbook, Table, App, Screen or Screen Automation was not found with the given ID.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.ServiceQuotaExceededException">
/// The request caused service quota to be breached.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.ServiceUnavailableException">
/// Remote service is unreachable.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.ThrottlingException">
/// Tps(transactions per second) rate reached.
/// </exception>
/// <exception cref="Amazon.Honeycode.Model.ValidationException">
/// Request is invalid. The message in the response contains details on why the request
/// is invalid.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/honeycode-2020-03-01/BatchUpsertTableRows">REST API Reference for BatchUpsertTableRows Operation</seealso>
public virtual Task <BatchUpsertTableRowsResponse> BatchUpsertTableRowsAsync(BatchUpsertTableRowsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = BatchUpsertTableRowsRequestMarshaller.Instance;
options.ResponseUnmarshaller = BatchUpsertTableRowsResponseUnmarshaller.Instance;
return(InvokeAsync <BatchUpsertTableRowsResponse>(request, options, cancellationToken));
}
internal virtual BatchUpsertTableRowsResponse BatchUpsertTableRows(BatchUpsertTableRowsRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = BatchUpsertTableRowsRequestMarshaller.Instance;
options.ResponseUnmarshaller = BatchUpsertTableRowsResponseUnmarshaller.Instance;
return(Invoke <BatchUpsertTableRowsResponse>(request, options));
}
