/// <summary>
/// Gets the specified ESXi host's information.
/// </summary>
/// <param name="request">The request object containing the details to send. Required.</param>
/// <param name="retryConfiguration">The retry configuration that will be used by to send this request. Optional.</param>
/// <param name="cancellationToken">The cancellation token to cancel this operation. Optional.</param>
/// <returns>A response object containing details about the completed operation</returns>
/// <example>Click <a href="https://docs.cloud.oracle.com/en-us/iaas/tools/dot-net-examples/latest/ocvp/GetEsxiHost.cs.html">here</a> to see an example of how to use GetEsxiHost API.</example>
public async Task <GetEsxiHostResponse> GetEsxiHost(GetEsxiHostRequest request, RetryConfiguration retryConfiguration = null, CancellationToken cancellationToken = default)
{
logger.Trace("Called getEsxiHost");
Uri uri = new Uri(this.restClient.GetEndpoint(), System.IO.Path.Combine(basePathWithoutHost, "/esxiHosts/{esxiHostId}".Trim('/')));
HttpMethod method = new HttpMethod("GET");
HttpRequestMessage requestMessage = Converter.ToHttpRequestMessage(uri, method, request);
requestMessage.Headers.Add("Accept", "application/json");
GenericRetrier retryingClient = Retrier.GetPreferredRetrier(retryConfiguration, this.retryConfiguration);
HttpResponseMessage responseMessage;
try
{
if (retryingClient != null)
{
responseMessage = await retryingClient.MakeRetryingCall(this.restClient.HttpSend, requestMessage, cancellationToken).ConfigureAwait(false);
}
else
{
responseMessage = await this.restClient.HttpSend(requestMessage).ConfigureAwait(false);
}
this.restClient.CheckHttpResponseMessage(requestMessage, responseMessage);
return(Converter.FromHttpResponseMessage <GetEsxiHostResponse>(responseMessage));
}
catch (Exception e)
{
logger.Error($"GetEsxiHost failed with error: {e.Message}");
throw;
}
}
/// <summary>
/// Creates a waiter using the provided configuration.
/// </summary>
/// <param name="request">Request to send.</param>
/// <param name="config">Wait Configuration</param>
/// <param name="targetStates">Desired resource states. If multiple states are provided then the waiter will return once the resource reaches any of the provided states</param>
/// <returns>a new Oci.common.Waiter instance</returns>
public Waiter <GetEsxiHostRequest, GetEsxiHostResponse> ForEsxiHost(GetEsxiHostRequest request, WaiterConfiguration config, params LifecycleStates[] targetStates)
{
var agent = new WaiterAgent <GetEsxiHostRequest, GetEsxiHostResponse>(
request,
request => client.GetEsxiHost(request),
response => targetStates.Contains(response.EsxiHost.LifecycleState.Value),
targetStates.Contains(LifecycleStates.Deleted)
);
return(new Waiter <GetEsxiHostRequest, GetEsxiHostResponse>(config, agent));
}
private void HandleOutput(GetEsxiHostRequest request)
{
var waiterConfig = new WaiterConfiguration
{
MaxAttempts = MaxWaitAttempts,
GetNextDelayInSeconds = (_) => WaitIntervalSeconds
};
switch (ParameterSetName)
{
case LifecycleStateParamSet:
response = client.Waiters.ForEsxiHost(request, waiterConfig, WaitForLifecycleState).Execute();
break;
case Default:
response = client.GetEsxiHost(request).GetAwaiter().GetResult();
break;
}
WriteOutput(response, response.EsxiHost);
}
protected override void ProcessRecord()
{
base.ProcessRecord();
GetEsxiHostRequest request;
try
{
request = new GetEsxiHostRequest
{
EsxiHostId = EsxiHostId,
OpcRequestId = OpcRequestId
};
HandleOutput(request);
FinishProcessing(response);
}
catch (Exception ex)
{
TerminatingErrorDuringExecution(ex);
}
}
/// <summary>
/// Creates a waiter using default wait configuration.
/// </summary>
/// <param name="request">Request to send.</param>
/// <param name="targetStates">Desired resource states. If multiple states are provided then the waiter will return once the resource reaches any of the provided states</param>
/// <returns>a new Oci.common.Waiter instance</returns>
public Waiter <GetEsxiHostRequest, GetEsxiHostResponse> ForEsxiHost(GetEsxiHostRequest request, params LifecycleStates[] targetStates)
{
return(this.ForEsxiHost(request, WaiterConfiguration.DefaultWaiterConfiguration, targetStates));
}