/// <summary>
/// Initiates the asynchronous execution of the GetReservationPurchaseRecommendation operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the GetReservationPurchaseRecommendation operation on AmazonCostExplorerClient.</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 EndGetReservationPurchaseRecommendation
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation">REST API Reference for GetReservationPurchaseRecommendation Operation</seealso>
public virtual IAsyncResult BeginGetReservationPurchaseRecommendation(GetReservationPurchaseRecommendationRequest request, AsyncCallback callback, object state)
{
var marshaller = GetReservationPurchaseRecommendationRequestMarshaller.Instance;
var unmarshaller = GetReservationPurchaseRecommendationResponseUnmarshaller.Instance;
return(BeginInvoke <GetReservationPurchaseRecommendationRequest>(request, marshaller, unmarshaller,
callback, state));
}
/// <summary>
/// Initiates the asynchronous execution of the GetReservationPurchaseRecommendation operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the GetReservationPurchaseRecommendation operation on AmazonCostExplorerClient.</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 EndGetReservationPurchaseRecommendation
/// operation.</returns>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation">REST API Reference for GetReservationPurchaseRecommendation Operation</seealso>
public virtual IAsyncResult BeginGetReservationPurchaseRecommendation(GetReservationPurchaseRecommendationRequest request, AsyncCallback callback, object state)
{
var options = new InvokeOptions();
options.RequestMarshaller = GetReservationPurchaseRecommendationRequestMarshaller.Instance;
options.ResponseUnmarshaller = GetReservationPurchaseRecommendationResponseUnmarshaller.Instance;
return(BeginInvoke(request, options, callback, state));
}
/// <summary>
/// Gets recommendations for which reservations to purchase. These recommendations could
/// help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%)
/// compared to On-Demand pricing.
///
///
/// <para>
/// AWS generates your recommendations by identifying your On-Demand usage during a specific
/// time period and collecting your usage into categories that are eligible for a reservation.
/// After AWS has these categories, it simulates every combination of reservations in
/// each category of usage to identify the best number of each type of RI to purchase
/// to maximize your estimated savings.
/// </para>
///
/// <para>
/// For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, and
/// c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible
/// regional reservations to apply to the c4 family usage. AWS recommends the smallest
/// size instance in an instance family. This makes it easier to purchase a size-flexible
/// RI. AWS also shows the equal number of normalized units so that you can purchase any
/// instance size that you want. For this example, your RI recommendation would be for
/// <code>c4.large</code> because that is the smallest size instance in the c4 instance
/// family.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the GetReservationPurchaseRecommendation 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 GetReservationPurchaseRecommendation service method, as returned by CostExplorer.</returns>
/// <exception cref="Amazon.CostExplorer.Model.DataUnavailableException">
/// The requested data is unavailable.
/// </exception>
/// <exception cref="Amazon.CostExplorer.Model.InvalidNextTokenException">
/// The pagination token is invalid. Try again without a pagination token.
/// </exception>
/// <exception cref="Amazon.CostExplorer.Model.LimitExceededException">
/// You made too many calls in a short period of time. Try again later.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation">REST API Reference for GetReservationPurchaseRecommendation Operation</seealso>
public virtual Task <GetReservationPurchaseRecommendationResponse> GetReservationPurchaseRecommendationAsync(GetReservationPurchaseRecommendationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var options = new InvokeOptions();
options.RequestMarshaller = GetReservationPurchaseRecommendationRequestMarshaller.Instance;
options.ResponseUnmarshaller = GetReservationPurchaseRecommendationResponseUnmarshaller.Instance;
return(InvokeAsync <GetReservationPurchaseRecommendationResponse>(request, options, cancellationToken));
}
internal virtual GetReservationPurchaseRecommendationResponse GetReservationPurchaseRecommendation(GetReservationPurchaseRecommendationRequest request)
{
var options = new InvokeOptions();
options.RequestMarshaller = GetReservationPurchaseRecommendationRequestMarshaller.Instance;
options.ResponseUnmarshaller = GetReservationPurchaseRecommendationResponseUnmarshaller.Instance;
return(Invoke <GetReservationPurchaseRecommendationResponse>(request, options));
}
/// <summary>
/// Gets recommendations for which reservations to purchase. These recommendations could
/// help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%)
/// compared to On-Demand pricing.
///
///
/// <para>
/// AWS generates your recommendations by identifying your On-Demand usage during a specific
/// time period and collecting your usage into categories that are eligible for a reservation.
/// After AWS has these categories, it simulates every combination of reservations in
/// each category of usage to identify the best number of each type of RI to purchase
/// to maximize your estimated savings.
/// </para>
///
/// <para>
/// For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, and
/// c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible
/// regional reservations to apply to the c4 family usage. AWS recommends the smallest
/// size instance in an instance family. This makes it easier to purchase a size-flexible
/// RI. AWS also shows the equal number of normalized units so that you can purchase any
/// instance size that you want. For this example, your RI recommendation would be for
/// <code>c4.large</code> because that is the smallest size instance in the c4 instance
/// family.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the GetReservationPurchaseRecommendation service method.</param>
///
/// <returns>The response from the GetReservationPurchaseRecommendation service method, as returned by CostExplorer.</returns>
/// <exception cref="Amazon.CostExplorer.Model.DataUnavailableException">
/// The requested data is unavailable.
/// </exception>
/// <exception cref="Amazon.CostExplorer.Model.InvalidNextTokenException">
/// The pagination token is invalid. Try again without a pagination token.
/// </exception>
/// <exception cref="Amazon.CostExplorer.Model.LimitExceededException">
/// You made too many calls in a short period of time. Try again later.
/// </exception>
/// <seealso href="http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationPurchaseRecommendation">REST API Reference for GetReservationPurchaseRecommendation Operation</seealso>
public virtual GetReservationPurchaseRecommendationResponse GetReservationPurchaseRecommendation(GetReservationPurchaseRecommendationRequest request)
{
var marshaller = GetReservationPurchaseRecommendationRequestMarshaller.Instance;
var unmarshaller = GetReservationPurchaseRecommendationResponseUnmarshaller.Instance;
return(Invoke <GetReservationPurchaseRecommendationRequest, GetReservationPurchaseRecommendationResponse>(request, marshaller, unmarshaller));
}
