/// <summary>
/// Initiates the asynchronous execution of the CreateParticipantConnection operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the CreateParticipantConnection operation on AmazonConnectParticipantClient.</param>
/// <param name="callback">An AsyncCallback delegate that is invoked when the operation completes.</param>
/// <param name="state">A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.</param>
///
/// <returns>An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndCreateParticipantConnection
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/connectparticipant-2018-09-07/CreateParticipantConnection">REST API Reference for CreateParticipantConnection Operation</seealso>
public virtual IAsyncResult BeginCreateParticipantConnection(CreateParticipantConnectionRequest request, AsyncCallback callback, object state)
{
var options = new InvokeOptions();
options.RequestMarshaller = CreateParticipantConnectionRequestMarshaller.Instance;
options.ResponseUnmarshaller = CreateParticipantConnectionResponseUnmarshaller.Instance;
return(BeginInvoke(request, options, callback, state));
}
/// <summary>
/// Creates the participant's connection. Note that ParticipantToken is used for invoking
/// this API instead of ConnectionToken.
///
///
/// <para>
/// The participant token is valid for the lifetime of the participant – until they are
/// part of a contact.
/// </para>
///
/// <para>
/// The response URL for <code>WEBSOCKET</code> Type has a connect expiry timeout of 100s.
/// Clients must manually connect to the returned websocket URL and subscribe to the desired
/// topic.
/// </para>
///
/// <para>
/// For chat, you need to publish the following on the established websocket connection:
/// </para>
///
/// <para>
/// <code>{"topic":"aws/subscribe","content":{"topics":["aws/chat"]}}</code>
/// </para>
///
/// <para>
/// Upon websocket URL expiry, as specified in the response ConnectionExpiry parameter,
/// clients need to call this API again to obtain a new websocket URL and perform the
/// same steps as before.
/// </para>
/// <note>
/// <para>
/// The Amazon Connect Participant Service APIs do not use <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Signature
/// Version 4 authentication</a>.
/// </para>
/// </note>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the CreateParticipantConnection 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 CreateParticipantConnection service method, as returned by ConnectParticipant.</returns>
/// <exception cref="Amazon.ConnectParticipant.Model.AccessDeniedException">
/// You do not have sufficient access to perform this action.
/// </exception>
/// <exception cref="Amazon.ConnectParticipant.Model.InternalServerException">
/// This exception occurs when there is an internal failure in the Amazon Connect service.
/// </exception>
/// <exception cref="Amazon.ConnectParticipant.Model.ThrottlingException">
/// The request was denied due to request throttling.
/// </exception>
/// <exception cref="Amazon.ConnectParticipant.Model.ValidationException">
/// The input fails to satisfy the constraints specified by Amazon Connect.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/connectparticipant-2018-09-07/CreateParticipantConnection">REST API Reference for CreateParticipantConnection Operation</seealso>
public virtual Task <CreateParticipantConnectionResponse> CreateParticipantConnectionAsync(CreateParticipantConnectionRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = CreateParticipantConnectionRequestMarshaller.Instance;
options.ResponseUnmarshaller = CreateParticipantConnectionResponseUnmarshaller.Instance;
return(InvokeAsync <CreateParticipantConnectionResponse>(request, options, cancellationToken));
}
internal virtual CreateParticipantConnectionResponse CreateParticipantConnection(CreateParticipantConnectionRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = CreateParticipantConnectionRequestMarshaller.Instance;
options.ResponseUnmarshaller = CreateParticipantConnectionResponseUnmarshaller.Instance;
return(Invoke <CreateParticipantConnectionResponse>(request, options));
}
