The code examples in this topic show you how to use the AWS SDK for Go V2 with AWS.
The SDK for Go V2 provides a Go API for AWS infrastructure services. Using the SDK, you can build applications on top of Amazon S3, Amazon EC2, Amazon DynamoDB, and more.
-
Single-service actions - Code examples that show you how to call individual service functions.
-
Single-service scenarios - Code examples that show you how to accomplish a specific task by calling multiple functions within the same service.
-
Cross-service examples - Sample applications that work across multiple AWS services.
Single-service actions and scenarios are organized by AWS service. A README in each folder lists and describes how to run the examples.
Cross-service examples are located in the cross_service folder. A README in each folder describes how to run the example.
- 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.
- You must have an AWS account, and have your default credentials and AWS Region configured as described in the AWS Tools and SDKs Shared Configuration and Credentials Reference Guide.
- Go 1.18 or later
Each example is a Go module that typically contains two packages that you can run:
hello and cmd. The hello package makes a single call to a service to verify that you
can use the service with the SDK. The cmd package runs more complex scenarios
to show you how to accomplish specific tasks.
For example, run the hello package from the command line:
go run ./hello
Some examples require command line arguments. In these cases, you can run the example
with a -h flag to get help. Each example has a README.md that describes additional
specifics about how to run the example and any other prerequisites.
All tests use go test, and you can find them alongside the code in the folder for each example. When an example has additional requirements to run tests, you can find them in the README for that service or cross-service example.
The unit tests in this module use stubbed responses from AwsmStubber. AwsmStubber is a tool that uses the AWS SDK for Go middleware to intercept calls to AWS, verify inputs, and return a mocked response. This means that when the unit tests are run, requests are not sent to AWS and no charges are incurred on your account.
Run unit tests in the folder for each service or cross-service example at a command prompt.
go test ./...
The integration tests in this module make actual requests to AWS. This means that when the integration tests are run, they can create and destroy resources in your account. These tests might also incur charges. Proceed with caution.
Run integration tests in the folder for each service or cross-service example at a
command prompt by including the integration tag.
go test -tags=integration ./...
This example code will soon be available in a container image hosted on Amazon Elastic Container Registry (Amazon ECR). The image will be preloaded with all Go examples, with dependencies pre-resolved. That way, you can explore the examples in an isolated environment.
- Install and run Docker on your machine.
- Navigate to the same directory as this README.
- Run
docker build -t <image_name> .and replaceimage_namewith a name for the image.
Run the Docker container with your image using the following command:
Windows
docker run -it --volume %USERPROFILE%\.aws:/root/.aws <image_name>
macOS or Linux
docker run -it -v ~/.aws/credentials:/root/.aws/credentials <image_name>
The terminal initiates a bash instance at the root of the container.
The Go code examples are in the gov2 folder and can be run by following
the instructions in the READMEs in the various folders.
To run all unit tests and write the output to a file, run the following command
in the gov2 directory of the container:
./run_all_tests.sh
To run integration tests, pass an integration argument to the run_all_tests.sh
script. Integration tests create and destroy AWS resources and will incur charges on your account.
Proceed with caution.
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
SPDX-License-Identifier: Apache-2.0