2023-03-15 16:14:29 -04:00
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
// SPDX-License-Identifier: Apache-2.0
2024-01-16 10:41:11 -05:00
2023-03-15 16:14:29 -04:00
/**
* Before running this C++ code example, set up your development environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started.html
*
* For information on the structure of the code examples and how to build and run the examples, see
* https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started-code-examples.html.
*
**/
2021-11-15 13:15:43 +00:00
// snippet-start:[ec2.cpp.start_instance.inc]
# include <aws/core/Aws.h>
# include <aws/ec2/EC2Client.h>
# include <aws/ec2/model/StartInstancesRequest.h>
# include <aws/ec2/model/StartInstancesResponse.h>
// snippet-end:[ec2.cpp.start_instance.inc]
// snippet-start:[ec2.cpp.stop_instance.inc]
# include <aws/ec2/model/StopInstancesRequest.h>
# include <aws/ec2/model/StopInstancesResponse.h>
// snippet-end:[ec2.cpp.stop_instance.inc]
# include <iostream>
2023-03-15 16:14:29 -04:00
# include "ec2_samples.h"
//! Start an Amazon Elastic Compute Cloud (Amazon EC2) instance.
/*!
\sa StartInstance()
\param instanceID: An EC2 instance ID.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc : : EC2 : : StartInstance ( const Aws : : String & instanceId ,
const Aws : : Client : : ClientConfiguration & clientConfiguration ) {
2021-11-15 13:15:43 +00:00
// snippet-start:[ec2.cpp.start_instance.code]
2023-03-15 16:14:29 -04:00
Aws : : EC2 : : EC2Client ec2Client ( clientConfiguration ) ;
2021-11-15 13:15:43 +00:00
Aws : : EC2 : : Model : : StartInstancesRequest start_request ;
2023-03-15 16:14:29 -04:00
start_request . AddInstanceIds ( instanceId ) ;
2021-11-15 13:15:43 +00:00
start_request . SetDryRun ( true ) ;
2023-03-15 16:14:29 -04:00
auto dry_run_outcome = ec2Client . StartInstances ( start_request ) ;
if ( dry_run_outcome . IsSuccess ( ) ) {
std : : cerr
< < " Failed dry run to start instance. A dry run should trigger an error. "
< < std : : endl ;
return false ;
}
else if ( dry_run_outcome . GetError ( ) . GetErrorType ( ) ! =
Aws : : EC2 : : EC2Errors : : DRY_RUN_OPERATION ) {
std : : cout < < " Failed dry run to start instance " < < instanceId < < " : "
< < dry_run_outcome . GetError ( ) . GetMessage ( ) < < std : : endl ;
return false ;
2021-11-15 13:15:43 +00:00
}
start_request . SetDryRun ( false ) ;
2023-03-15 16:14:29 -04:00
auto start_instancesOutcome = ec2Client . StartInstances ( start_request ) ;
2021-11-15 13:15:43 +00:00
2023-03-15 16:14:29 -04:00
if ( ! start_instancesOutcome . IsSuccess ( ) ) {
std : : cout < < " Failed to start instance " < < instanceId < < " : " < <
start_instancesOutcome . GetError ( ) . GetMessage ( ) < < std : : endl ;
2021-11-15 13:15:43 +00:00
}
2023-03-15 16:14:29 -04:00
else {
std : : cout < < " Successfully started instance " < < instanceId < <
std : : endl ;
2021-11-15 13:15:43 +00:00
}
// snippet-end:[ec2.cpp.start_instance.code]
2023-03-15 16:14:29 -04:00
return start_instancesOutcome . IsSuccess ( ) ;
2021-11-15 13:15:43 +00:00
}
2023-03-15 16:14:29 -04:00
//! Stop an EC2 instance.
/*!
\sa StopInstance()
\param instanceID: An EC2 instance ID.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc : : EC2 : : StopInstance ( const Aws : : String & instanceId ,
const Aws : : Client : : ClientConfiguration & clientConfiguration ) {
2021-11-15 13:15:43 +00:00
// snippet-start:[ec2.cpp.stop_instance.code]
2023-03-15 16:14:29 -04:00
Aws : : EC2 : : EC2Client ec2Client ( clientConfiguration ) ;
2021-11-15 13:15:43 +00:00
Aws : : EC2 : : Model : : StopInstancesRequest request ;
2023-03-15 16:14:29 -04:00
request . AddInstanceIds ( instanceId ) ;
2021-11-15 13:15:43 +00:00
request . SetDryRun ( true ) ;
2023-03-15 16:14:29 -04:00
auto dry_run_outcome = ec2Client . StopInstances ( request ) ;
if ( dry_run_outcome . IsSuccess ( ) ) {
std : : cerr
< < " Failed dry run to stop instance. A dry run should trigger an error. "
< < std : : endl ;
return false ;
}
else if ( dry_run_outcome . GetError ( ) . GetErrorType ( ) ! =
Aws : : EC2 : : EC2Errors : : DRY_RUN_OPERATION ) {
std : : cout < < " Failed dry run to stop instance " < < instanceId < < " : "
< < dry_run_outcome . GetError ( ) . GetMessage ( ) < < std : : endl ;
return false ;
2021-11-15 13:15:43 +00:00
}
request . SetDryRun ( false ) ;
2023-03-15 16:14:29 -04:00
auto outcome = ec2Client . StopInstances ( request ) ;
if ( ! outcome . IsSuccess ( ) ) {
std : : cout < < " Failed to stop instance " < < instanceId < < " : " < <
outcome . GetError ( ) . GetMessage ( ) < < std : : endl ;
2021-11-15 13:15:43 +00:00
}
2023-03-15 16:14:29 -04:00
else {
std : : cout < < " Successfully stopped instance " < < instanceId < <
std : : endl ;
2021-11-15 13:15:43 +00:00
}
// snippet-end:[ec2.cpp.stop_instance.code]
2023-03-15 16:14:29 -04:00
return outcome . IsSuccess ( ) ;
2021-11-15 13:15:43 +00:00
}
2023-03-15 16:14:29 -04:00
void PrintUsage ( ) {
std : : cout < < " Usage: run_start_stop_instance <instance_id> <start|stop> " < <
std : : endl ;
2021-11-15 13:15:43 +00:00
}
2023-03-15 16:14:29 -04:00
/*
*
* main function
*
* Usage: 'sage: run_start_stop_instance <instance_id> <start|stop>"'
*
* Prerequisites: An EC2 instance to start or stop.
*
*/
# ifndef TESTING_BUILD
int main ( int argc , char * * argv ) {
if ( argc ! = 3 ) {
2021-11-15 13:15:43 +00:00
PrintUsage ( ) ;
return 1 ;
}
Aws : : SDKOptions options ;
Aws : : InitAPI ( options ) ;
{
Aws : : String instance_id = argv [ 1 ] ;
bool start_instance ;
2023-03-15 16:14:29 -04:00
if ( Aws : : Utils : : StringUtils : : CaselessCompare ( argv [ 2 ] , " start " ) ) {
2021-11-15 13:15:43 +00:00
start_instance = true ;
}
2023-03-15 16:14:29 -04:00
else if ( Aws : : Utils : : StringUtils : : CaselessCompare ( argv [ 2 ] , " stop " ) ) {
2021-11-15 13:15:43 +00:00
start_instance = false ;
}
2023-03-15 16:14:29 -04:00
else {
2021-11-15 13:15:43 +00:00
PrintUsage ( ) ;
return 1 ;
}
2023-03-15 16:14:29 -04:00
Aws : : Client : : ClientConfiguration clientConfig ;
// Optional: Set to the AWS Region (overrides config file).
// clientConfig.region = "us-east-1";
if ( start_instance ) {
AwsDoc : : EC2 : : StartInstance ( instance_id , clientConfig ) ;
2021-11-15 13:15:43 +00:00
}
2023-03-15 16:14:29 -04:00
else {
AwsDoc : : EC2 : : StopInstance ( instance_id , clientConfig ) ;
2021-11-15 13:15:43 +00:00
}
}
Aws : : ShutdownAPI ( options ) ;
return 0 ;
}
2023-03-15 16:14:29 -04:00
# endif // TESTING_BUILD
