ContextQMD
Back to Aws Doc Sdk Examples

Hello Amazon EC2 for the SDK for C++

cpp/example_code/ec2/hello_ec2/README.md

latest2.6 KB
Original Source

Hello Amazon EC2 for the SDK for C++

Overview

This folder provides a CMake "Hello Amazon EC2" project that uses the AWS SDK for C++ to call Amazon Elastic Compute Cloud (Amazon EC2).

⚠ Important

  • Running this code might result in charges to your AWS account.
  • Running the tests might result in charges to your AWS account.
  • We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
  • This code is not tested in every AWS Region. For more information, see AWS Regional Services.

Run the Hello Amazon EC2 app

Prerequisites

Before using this example, first complete the installation and setup steps for Getting started in the AWS SDK for C++ Developer Guide.

Instructions

This example uses the CMake build system. For information about the CMake build system, see https://cmake.org/.

Many Integrated Development Environments (IDEs) support CMake. If your preferred IDE supports CMake, follow the IDE instructions to open this CMake project.

You can also build this project from a command line interface using the following commands.

sh
mkdir build 
cd build
cmake --build ..

The built executable is named hello_ec2.

You can run this example with the AWS managed policy "arn:aws:iam::aws:policy/AmazonEC2ReadOnlyAccess".

You can also use CMake to generate the input files for your native build system. For more information, see https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html.

The CMakeLists.txt file contains the build settings. If your build is failing (particularly on Windows), you might need to modify this file.

The hello_ec2.cpp file contains the C++ source code, including a "main" function.

Additional resources

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

SPDX-License-Identifier: Apache-2.0