AWS SDK for Go (version 1)
          Developer Guide
                                AWS SDK for Go (version 1) Developer Guide
           AWS SDK for Go (version 1): Developer Guide
           Copyright © 2023 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
           Amazon's trademarks and trade dress may not be used in connection with any product or service that is not 
           Amazon's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or 
           discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may 
           or may not be affiliated with, connected to, or sponsored by Amazon.
                                                                        AWS SDK for Go (version 1) Developer Guide
                       Table of Contents
                             What is the AWS SDK for Go ............................................................................................................... 1
                                     Using the AWS SDK for Go with AWS Cloud9 ................................................................................ 1
                                     More Info .................................................................................................................................. 1
                                     Maintenance and support for SDK major versions .......................................................................... 1
                                            Maintenance and support for SDK major versions ................................................................... 1
                             Getting Started .................................................................................................................................. 3
                                     Get an Amazon Account .............................................................................................................         3
                                     Install the AWS SDK for Go ......................................................................................................... 3
                                     Get your AWS access keys ........................................................................................................... 3
                                            To get your access key ID and secret access key ..................................................................... 3
                                     Import Packages ........................................................................................................................ 4
                             Configuring the SDK ........................................................................................................................... 5
                                     Creating a Session ...................................................................................................................... 5
                                     Specifying the AWS Region ......................................................................................................... 5
                                     Specifying Credentials ................................................................................................................     6
                                            IAM Roles for Tasks ............................................................................................................ 7
                                            IAM Roles for Amazon EC2 Instances .................................................................................... 7
                                            Shared Credentials File ....................................................................................................... 7
                                            Environment Variables ........................................................................................................ 8
                                            Hard-Coded Credentials in an Application (Not Recommended) ................................................ 9
                                            Other Credentials Providers ................................................................................................. 9
                                     Configuring a Proxy .................................................................................................................... 9
                                     Logging Service Calls .................................................................................................................. 9
                                     Creating a Custom Endpoint ...................................................................................................... 10
                                     Custom HTTP Client ................................................................................................................. 10
                                            Dialer.KeepAlive ...............................................................................................................   10
                                            Dialer.Timeout .................................................................................................................. 10
                                            Transport.ExpectContinueTimeout ...................................................................................... 10
                                            Transport.IdleConnTimeout ................................................................................................ 11
                                            Transport.MaxIdleConns .................................................................................................... 11
                                            Transport.MaxIdleConnsPerHost ......................................................................................... 11
                                            Transport.ResponseHeaderTimeout ..................................................................................... 11
                                            Transport.TLSHandshakeTimeout ........................................................................................ 12
                                            Create Import Statement .................................................................................................. 12
                                            Creating a Timeout Struct ................................................................................................. 12
                                            Creating a Function to Create a Custom HTTP Client ............................................................ 13
                                            Using a Custom HTTP Client .............................................................................................. 13
                             Using Cloud9 with the SDK ............................................................................................................... 15
                                     Step 1: Set up Your AWS Account to Use AWS Cloud9 ................................................................... 15
                                     Step 2: Set up Your AWS Cloud9 Development Environment .......................................................... 15
                                     Step 3: Set up the AWS SDK for Go ............................................................................................ 15
                                     Step 4: Download Example Code ................................................................................................ 16
                                     Step 5: Run Example Code ........................................................................................................ 17
                             Using Sessions ................................................................................................................................. 18
                                     Concurrency ............................................................................................................................. 18
                                     Sessions with a Shared Configuration File ................................................................................... 18
                                     Creating Sessions ..................................................................................................................... 18
                                     Create Sessions with Option Overrides ........................................................................................ 19
                                            Deprecated New ............................................................................................................... 19
                                            Shared Configuration Fields ............................................................................................... 20
                                     Environment Variables ................................................................................................................ 8
                                     Adding Request Handlers .......................................................................................................... 20
                                     Copying a Session .................................................................................................................... 20
                             Using AWS Services .......................................................................................................................... 21
                                                                                                    iii
                                                                        AWS SDK for Go (version 1) Developer Guide
                                     Constructing a Service .............................................................................................................. 21
                                     Tagging Service Resources ......................................................................................................... 21
                                     Getting the HTTP Request and Response with Each Service Call ..................................................... 23
                                     Service Operation Calls ............................................................................................................. 24
                                             Calling Operations ............................................................................................................ 24
                                             Calling Operations with the Request Form ........................................................................... 25
                                             Handling Operation Response Body .................................................................................... 25
                                     Concurrently Using Service Clients .............................................................................................. 26
                                     Using Pagination Methods ......................................................................................................... 26
                                     Using Waiters ..........................................................................................................................   27
                             Handling Errors ................................................................................................................................ 29
                                     Handling Specific Service Error Codes ......................................................................................... 29
                                     Additional Error Information ...................................................................................................... 30
                                             Specific Error Interfaces .................................................................................................... 30
                             Code Examples ................................................................................................................................     31
                                     SDK Request Examples .............................................................................................................. 31
                                             Using context.Context with SDK Requests ............................................................................ 31
                                             Using API Field Setters with SDK Requests .......................................................................... 32
                                     AWS CloudTrail Examples .......................................................................................................... 32
                                             Listing the CloudTrail Trails ............................................................................................... 33
                                             Creating a CloudTrail Trail ................................................................................................. 33
                                             Listing CloudTrail Trail Events ............................................................................................ 36
                                             Deleting a CloudTrail Trail ................................................................................................. 37
                                     Amazon CloudWatch Examples .................................................................................................. 38
                                             Describing CloudWatch Alarms ........................................................................................... 38
                                             Using Alarms and Alarm Actions in CloudWatch ................................................................... 39
                                             Getting Metrics from CloudWatch ....................................................................................... 42
                                             Sending Events to Amazon CloudWatch Events .................................................................... 45
                                             Getting Log Events from CloudWatch ................................................................................. 49
                                     AWS CodeBuild Examples .......................................................................................................... 50
                                             Getting Information about All AWS CodeBuild Projects ......................................................... 50
                                             Building an AWS CodeBuild Project .................................................................................... 51
                                             Listing Your AWS CodeBuild Project Builds .......................................................................... 52
                                     Amazon DynamoDB Examples .................................................................................................... 53
                                             Listing all Amazon DynamoDB Tables ................................................................................. 53
                                             Creating an Amazon DynamoDB Table ................................................................................ 55
                                             Creating an Amazon DynamoDB Table Item ......................................................................... 56
                                             Creating Amazon DynamoDB Table Items from a JSON File ................................................... 57
                                             Reading an Amazon DynamoDB Table Item ......................................................................... 59
                                             Getting Amazon DynamoDB Table Items Using Expression Builder .......................................... 60
                                             Updating an Amazon DynamoDB Table Item ........................................................................ 62
                                             Deleting an Amazon DynamoDB Table Item ......................................................................... 63
                                     Amazon EC2 Examples .............................................................................................................. 64
                                             Creating Amazon EC2 Instances with Tags or without Block Devices ........................................ 65
                                             Managing Amazon EC2 Instances ....................................................................................... 67
                                             Working with Amazon EC2 Key Pairs .................................................................................. 72
                                             Using Regions and Availability Zones with Amazon EC2 ......................................................... 76
                                             Working with Security Groups in Amazon EC2 ...................................................................... 77
                                             Using Elastic IP Addresses in Amazon EC2 ........................................................................... 82
                                     Amazon Glacier Examples .......................................................................................................... 86
                                             The Scenario .................................................................................................................... 87
                                             Prerequisites .................................................................................................................... 87
                                             Create a Vault .................................................................................................................. 87
                                             Upload an Archive ............................................................................................................ 88
                                     IAM Examples .......................................................................................................................... 88
                                             Managing IAM Users ......................................................................................................... 89
                                             Managing IAM Access Keys ................................................................................................ 96
                                                                                                    iv