Repository files navigation

This is the repository for various code examples used in the publicAWS documentation. For more information, seeTools to Build on AWS.

The code examples are organized by AWS SDK or AWS programming tool. For example, among the top-level folders:

• cpp for the latest version of the AWS SDK for C++ (version 1)
• dotnet3.5 for the latest version of the AWS SDK for .NET (version 3.5)
• gov2 for the latest version of the AWS SDK for Go (version 2)
• javav2 for the latest version of the AWS SDK for Java (version 2)
• javascriptv3 for the latest version of the AWS SDK for JavaScript (version 3)
• php for the latest version of the AWS SDK for PHP (version 3)
• python for the latest version of the AWS SDK for Python (Boto3)
• ruby for the latest version of the AWS SDK for Ruby (version 3)

Code examples for older AWS SDK versions will be archived in this repository but no longer maintained. These include:

• dotnet for versions of the AWS SDK for .NET prior to version 3.5
• go for AWS SDK for Go version 1
• java for AWS SDK for Java version 1
• javascript for AWS SDK for JavaScript version 2

As AWS SDK major version numbers increment, this repository will begin to more consistently reflect their version numbers among these folders to make these distinctions clearer. For example, if and when the AWS SDK for Ruby moves to a version 4, a newrubyv4 folder will be added. Then when AWS officially announces that AWS SDK for Ruby version 3 has been deprecated, theruby folder will be deleted.

Other top-level folders include:

• aws-cli for script examples for use with the AWS Command Line Interface (AWS CLI).
• cloudformation for example templates for use with AWS CloudFormation.
• iam_policies for example policy documents for use with AWS Identity and Access Management (IAM).
• lambda_functions for example function code for use with AWS Lambda.
• typescript for TypeScript-based code examples for use with the AWS Cloud Development Kit (CDK), and other AWS services. (For TypeScript-based code examples for use with the AWS SDK for JavaScript, see thejavascriptv3 folder.)

Note that thescripts folder contains scripts that the AWS documentation team uses internally to build the code examples into various AWS documentation sets.

Inside each language-specific directory, we include aREADME file that explains how tobuild and run the examples in the directory.

The example code in the language-specific directories is organized bythe AWS service command in theAWS Command Line Interface (AWS CLI) Command Reference (s3 forAmazon S3 examples, and soon).

To propose a new code example for the AWS documentation team to consider working on,create arequest.

Note that the AWS documentation team prefers to produce code examples that cover broader scenarios and usecases, versus simple code snippets that cover only individual API calls.

If you plan to contribute examples for use in the documentation (the purpose of this repository),read this section carefully so that we can work together effectively.For process instructions and additional guidance, see theGuidelines for contributing.

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

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