/// <summary>
/// Initiates the asynchronous execution of the StopInstances operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the StopInstances 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>
public Task<StopInstancesResponse> StopInstancesAsync(StopInstancesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new StopInstancesRequestMarshaller();
var unmarshaller = StopInstancesResponseUnmarshaller.Instance;
return InvokeAsync<StopInstancesRequest,StopInstancesResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
public void StopInstancesMarshallTest()
{
var operation = service_model.FindOperation("StopInstances");
var request = InstantiateClassGenerator.Execute<StopInstancesRequest>();
var marshaller = new StopInstancesRequestMarshaller();
var internalRequest = marshaller.Marshall(request);
var validator = new AWSQueryValidator(internalRequest.Parameters, request, service_model, operation);
validator.Validate();
var payloadResponse = new XmlSampleGenerator(service_model, operation).Execute();
UnmarshallerContext context = new EC2UnmarshallerContext(Utils.CreateStreamFromString(payloadResponse), false, new WebResponseData());
var response = StopInstancesResponseUnmarshaller.Instance.Unmarshall(context)
as StopInstancesResponse;
InstantiateClassGenerator.ValidateObjectFullyInstantiated(response);
}
/// <summary>
/// Stops an Amazon EBS-backed instance. Each time you transition an instance from stopped
/// to started, Amazon EC2 charges a full instance hour, even if transitions happen multiple
/// times within a single hour.
///
///
/// <para>
/// You can't start or stop Spot Instances.
/// </para>
///
/// <para>
/// Instances that use Amazon EBS volumes as their root devices can be quickly stopped
/// and started. When an instance is stopped, the compute resources are released and you
/// are not billed for hourly instance usage. However, your root partition Amazon EBS
/// volume remains, continues to persist your data, and you are charged for Amazon EBS
/// volume usage. You can restart your instance at any time.
/// </para>
///
/// <para>
/// Before stopping an instance, make sure it is in a state from which it can be restarted.
/// Stopping an instance does not preserve data stored in RAM.
/// </para>
///
/// <para>
/// Performing this operation on an instance that uses an instance store as its root device
/// returns an error.
/// </para>
///
/// <para>
/// You can stop, start, and terminate EBS-backed instances. You can only terminate instance
/// store-backed instances. What happens to an instance differs if you stop it or terminate
/// it. For example, when you stop an instance, the root device and any other devices
/// attached to the instance persist. When you terminate an instance, the root device
/// and any other devices attached during the instance launch are automatically deleted.
/// For more information about the differences between stopping and terminating instances,
/// see <a href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html">Instance
/// Lifecycle</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.
/// </para>
///
/// <para>
/// For more information about troubleshooting, see <a href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesStopping.html">Troubleshooting
/// Stopping Your Instance</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the StopInstances service method.</param>
///
/// <returns>The response from the StopInstances service method, as returned by EC2.</returns>
public StopInstancesResponse StopInstances(StopInstancesRequest request)
{
var marshaller = new StopInstancesRequestMarshaller();
var unmarshaller = StopInstancesResponseUnmarshaller.Instance;
return Invoke<StopInstancesRequest,StopInstancesResponse>(request, marshaller, unmarshaller);
}
/// <summary>
/// Initiates the asynchronous execution of the StopInstances operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the StopInstances operation on AmazonEC2Client.</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 EndStopInstances
/// operation.</returns>
public IAsyncResult BeginStopInstances(StopInstancesRequest request, AsyncCallback callback, object state)
{
var marshaller = new StopInstancesRequestMarshaller();
var unmarshaller = StopInstancesResponseUnmarshaller.Instance;
return BeginInvoke<StopInstancesRequest>(request, marshaller, unmarshaller,
callback, state);
}
IAsyncResult invokeStopInstances(StopInstancesRequest stopInstancesRequest, AsyncCallback callback, object state, bool synchronized)
{
IRequest irequest = new StopInstancesRequestMarshaller().Marshall(stopInstancesRequest);
var unmarshaller = StopInstancesResponseUnmarshaller.GetInstance();
AsyncResult result = new AsyncResult(irequest, callback, state, synchronized, signer, unmarshaller);
Invoke(result);
return result;
}
/// <summary>
/// <para>Stops an Amazon EBS-backed instance. Each time you transition an instance from stopped to started, Amazon EC2 charges a full instance
/// hour, even if transitions happen multiple times within a single hour.</para> <para>You can't start or stop Spot Instances.</para>
/// <para>Instances that use Amazon EBS volumes as their root devices can be quickly stopped and started. When an instance is stopped, the
/// compute resources are released and you are not billed for hourly instance usage. However, your root partition Amazon EBS volume remains,
/// continues to persist your data, and you are charged for Amazon EBS volume usage. You can restart your instance at any time.</para>
/// <para>Before stopping an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data
/// stored in RAM.</para> <para>Performing this operation on an instance that uses an instance store as its root device returns an error.</para>
/// <para>You can stop, start, and terminate EBS-backed instances. You can only terminate instance store-backed instances. What happens to an
/// instance differs if you stop it or terminate it. For example, when you stop an instance, the root device and any other devices attached to
/// the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are
/// automatically deleted. For more information about the differences between stopping and terminating instances, see <a href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-lifecycle.html">Instance Lifecycle</a> in the <i>Amazon Elastic
/// Compute Cloud User Guide</i> .</para>
/// </summary>
///
/// <param name="stopInstancesRequest">Container for the necessary parameters to execute the StopInstances service method on AmazonEC2.</param>
///
/// <returns>The response from the StopInstances service method, as returned by AmazonEC2.</returns>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
public Task<StopInstancesResponse> StopInstancesAsync(StopInstancesRequest stopInstancesRequest, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new StopInstancesRequestMarshaller();
var unmarshaller = StopInstancesResponseUnmarshaller.GetInstance();
return Invoke<IRequest, StopInstancesRequest, StopInstancesResponse>(stopInstancesRequest, marshaller, unmarshaller, signer, cancellationToken);
}
/// <summary>
/// Initiates the asynchronous execution of the StopInstances operation.
/// <seealso cref="Amazon.EC2.IAmazonEC2.StopInstances"/>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the StopInstances 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>
public async Task<StopInstancesResponse> StopInstancesAsync(StopInstancesRequest request, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new StopInstancesRequestMarshaller();
var unmarshaller = StopInstancesResponseUnmarshaller.GetInstance();
var response = await Invoke<IRequest, StopInstancesRequest, StopInstancesResponse>(request, marshaller, unmarshaller, signer, cancellationToken)
.ConfigureAwait(continueOnCapturedContext: false);
return response;
}
