/// <summary>
/// Get the state for a routing control. A routing control is a simple on/off switch that
/// you can use to route traffic to cells. When the state is On, traffic flows to a cell.
/// When it's off, traffic does not flow.
///
///
/// <para>
/// Before you can create a routing control, you first must create a cluster to host the
/// control. For more information, see <a href="https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster.html">CreateCluster</a>.
/// Access one of the endpoints for the cluster to get or update the routing control state
/// to redirect traffic.
/// </para>
///
/// <para>
/// For more information about working with routing controls, see <a href="https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html">Routing
/// control</a> in the Route 53 Application Recovery Controller Developer Guide.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the GetRoutingControlState service method.</param>
///
/// <returns>The response from the GetRoutingControlState service method, as returned by Route53RecoveryCluster.</returns>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.AccessDeniedException">
/// You don't have sufficient permissions to query the routing control state.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.EndpointTemporarilyUnavailableException">
/// The cluster endpoint isn't available. Try another cluster endpoint.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.InternalServerException">
/// There was an unexpected error during processing of the request.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.ResourceNotFoundException">
/// The request references a routing control that was not found.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.ThrottlingException">
/// The request was denied because of request throttling.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.ValidationException">
/// There was a validation error on the request.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/GetRoutingControlState">REST API Reference for GetRoutingControlState Operation</seealso>
public virtual GetRoutingControlStateResponse GetRoutingControlState(GetRoutingControlStateRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = GetRoutingControlStateRequestMarshaller.Instance;
options.ResponseUnmarshaller = GetRoutingControlStateResponseUnmarshaller.Instance;
return(Invoke <GetRoutingControlStateResponse>(request, options));
}
/// <summary>
/// Initiates the asynchronous execution of the GetRoutingControlState operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the GetRoutingControlState operation on AmazonRoute53RecoveryClusterClient.</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 EndGetRoutingControlState
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/GetRoutingControlState">REST API Reference for GetRoutingControlState Operation</seealso>
public virtual IAsyncResult BeginGetRoutingControlState(GetRoutingControlStateRequest request, AsyncCallback callback, object state)
{
var options = new InvokeOptions();
options.RequestMarshaller = GetRoutingControlStateRequestMarshaller.Instance;
options.ResponseUnmarshaller = GetRoutingControlStateResponseUnmarshaller.Instance;
return(BeginInvoke(request, options, callback, state));
}
/// <summary>
/// Get the state for a routing control. A routing control is a simple on/off switch that
/// you can use to route traffic to cells. When the state is On, traffic flows to a cell.
/// When it's off, traffic does not flow.
///
///
/// <para>
/// Before you can create a routing control, you first must create a cluster to host the
/// control. For more information, see <a href="https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster.html">CreateCluster</a>.
/// Access one of the endpoints for the cluster to get or update the routing control state
/// to redirect traffic.
/// </para>
///
/// <para>
/// For more information about working with routing controls, see <a href="https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html">Routing
/// control</a> in the Route 53 Application Recovery Controller Developer Guide.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the GetRoutingControlState 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 GetRoutingControlState service method, as returned by Route53RecoveryCluster.</returns>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.AccessDeniedException">
/// You don't have sufficient permissions to query the routing control state.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.EndpointTemporarilyUnavailableException">
/// The cluster endpoint isn't available. Try another cluster endpoint.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.InternalServerException">
/// There was an unexpected error during processing of the request.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.ResourceNotFoundException">
/// The request references a routing control that was not found.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.ThrottlingException">
/// The request was denied because of request throttling.
/// </exception>
/// <exception cref="Amazon.Route53RecoveryCluster.Model.ValidationException">
/// There was a validation error on the request.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/GetRoutingControlState">REST API Reference for GetRoutingControlState Operation</seealso>
public virtual Task <GetRoutingControlStateResponse> GetRoutingControlStateAsync(GetRoutingControlStateRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = GetRoutingControlStateRequestMarshaller.Instance;
options.ResponseUnmarshaller = GetRoutingControlStateResponseUnmarshaller.Instance;
return(InvokeAsync <GetRoutingControlStateResponse>(request, options, cancellationToken));
}
