/// <summary>
/// Updates an Amazon EKS cluster to the specified Kubernetes version. Your cluster continues
/// to function during the update. The response output includes an update ID that you
/// can use to track the status of your cluster update with the <a>DescribeUpdate</a>
/// API operation.
///
///
/// <para>
/// Cluster updates are asynchronous, and they should finish within a few minutes. During
/// an update, the cluster status moves to <code>UPDATING</code> (this status transition
/// is eventually consistent). When the update is complete (either <code>Failed</code>
/// or <code>Successful</code>), the cluster status moves to <code>Active</code>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the UpdateClusterVersion service method.</param>
///
/// <returns>The response from the UpdateClusterVersion service method, as returned by EKS.</returns>
/// <exception cref="Amazon.EKS.Model.ClientException">
/// These errors are usually caused by a client action. Actions can include using an action
/// or resource on behalf of a user that doesn't have permissions to use the action or
/// resource or specifying an identifier that is not valid.
/// </exception>
/// <exception cref="Amazon.EKS.Model.InvalidParameterException">
/// The specified parameter is invalid. Review the available parameters for the API request.
/// </exception>
/// <exception cref="Amazon.EKS.Model.InvalidRequestException">
/// The request is invalid given the state of the cluster. Check the state of the cluster
/// and the associated operations.
/// </exception>
/// <exception cref="Amazon.EKS.Model.ResourceInUseException">
/// The specified resource is in use.
/// </exception>
/// <exception cref="Amazon.EKS.Model.ResourceNotFoundException">
/// The specified resource could not be found. You can view your available clusters with
/// <a>ListClusters</a>. Amazon EKS clusters are Region-specific.
/// </exception>
/// <exception cref="Amazon.EKS.Model.ServerException">
/// These errors are usually caused by a server-side issue.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/UpdateClusterVersion">REST API Reference for UpdateClusterVersion Operation</seealso>
public virtual UpdateClusterVersionResponse UpdateClusterVersion(UpdateClusterVersionRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = UpdateClusterVersionRequestMarshaller.Instance;
options.ResponseUnmarshaller = UpdateClusterVersionResponseUnmarshaller.Instance;
return(Invoke <UpdateClusterVersionResponse>(request, options));
}
/// <summary>
/// Initiates the asynchronous execution of the UpdateClusterVersion operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the UpdateClusterVersion operation on AmazonEKSClient.</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 EndUpdateClusterVersion
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/UpdateClusterVersion">REST API Reference for UpdateClusterVersion Operation</seealso>
public virtual IAsyncResult BeginUpdateClusterVersion(UpdateClusterVersionRequest request, AsyncCallback callback, object state)
{
var options = new InvokeOptions();
options.RequestMarshaller = UpdateClusterVersionRequestMarshaller.Instance;
options.ResponseUnmarshaller = UpdateClusterVersionResponseUnmarshaller.Instance;
return(BeginInvoke(request, options, callback, state));
}
/// <summary>
/// Initiates the asynchronous execution of the UpdateClusterVersion operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the UpdateClusterVersion operation.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
/// <returns>The task object representing the asynchronous operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/eks-2017-11-01/UpdateClusterVersion">REST API Reference for UpdateClusterVersion Operation</seealso>
public virtual Task <UpdateClusterVersionResponse> UpdateClusterVersionAsync(UpdateClusterVersionRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = UpdateClusterVersionRequestMarshaller.Instance;
options.ResponseUnmarshaller = UpdateClusterVersionResponseUnmarshaller.Instance;
return(InvokeAsync <UpdateClusterVersionResponse>(request, options, cancellationToken));
}