Skip to content

Latest commit

 

History

History
 
 

cpp

README.rst

AWS SDK for C++ Code Examples

A collection of code examples for the AWS SDK for C++. The examples are grouped according to the AWS service they demonstrate.

Prerequisites

Before using the Code Examples, first complete the installation and setup steps of Getting Started in the AWS SDK for C++ Developer Guide.

The Getting Started section covers how to obtain and build the SDK, and how to build your own code utilizing the SDK with a sample "Hello World"-style application. A similar procedure is applicable to utilizing the code examples in this repository.

Building and running the code examples

Additional information geared specifically to understanding the example applications is at AWS SDK for C++ Code Examples.

Docker image (Beta)

This example code will soon be available in a container image hosted on [Amazon Elastic Container Registry (ECR)](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html). This image will be pre-loaded with all C++ examples with dependencies pre-resolved, allowing you to explore these examples in an isolated environment.

As of January 2023, the [SDK for C++ image](https://gallery.ecr.aws/b4v4v1s0/cpp) is available on ECR Public but is still undergoing active development. Refer to [this GitHub issue](awsdocs#4133) for more information.

Automated tests

The automated tests for C++ examples can be run using the Python script [run_automated_tests.py](run_automated_tests.py). The script contains instructions for its use.

For information about the dependencies needed to run the examples, see the [DockerFile](Dockerfile).

Additional information

  • As an AWS best practice, grant all code least privilege, or only the permissions required to perform a task. For more information, see Grant Least Privilege in the AWS Identity and Access Management User Guide.
  • This code has not been tested in all AWS Regions. Some AWS services are available only in specific Regions. For more information, see Region Table on the AWS website.
  • Running this code might result in charges to your AWS account.
  • To propose a new code example for the AWS documentation team to consider producing, create a new request. The team is looking to produce code examples that cover broader scenarios and use cases, versus simple code snippets that cover only individual API calls. For instructions, see the Proposing new code examples section in the Readme on GitHub.

Copyright and License

All content in this repository, unless otherwise stated, is Copyright © Amazon Web Services, Inc. or its affiliates. All rights reserved.

Except where otherwise noted, all examples in this collection are licensed under the Apache license, version 2.0 (the "License"). The full license text is provided in the LICENSE file accompanying this repository.