AWS SDK for Go - docs.aws.amazon.com

1 AWS SDK for GoDeveloper GuideAWS SDK for Go: Developer GuideCopyright 2018 Amazon Web Services, Inc. and/or its affiliates. All rights SDK for Go Developer GuideAmazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored SDK for Go Developer GuideTable of ContentsAWS SDK for Go .. 1 Using the aws sdk for go with AWS Cloud9.

2 1 More Info .. 1 Getting Started .. 2 Install the aws sdk for go .. 2 Get your AWS access keys .. 2To get your access key ID and secret access key .. 2 Import Packages .. 3 Configuring the SDK.. 4 Specifying the AWS Region .. 4 Specifying Credentials .. 4 IAM Roles for Amazon EC2 Instances .. 5 Shared Credentials File .. 5 Environment Variables .. 7 Hard-Coded Credentials in an Application (Not Recommended) .. 7 Other Credentials Providers .. 7 Configuring a Proxy .. 7 Logging Service Calls .. 8 Creating a Custom Endpoint .. 8 Using Cloud9 with the SDK.. 9 Step 1: Set up Your AWS Account to Use AWS Cloud9.

3 9 Step 2: Set up Your AWS Cloud9 Development Environment .. 9 Step 3: Set up the aws sdk for go .. 9 Step 4: Download Example Code .. 10 Step 5: Run Example Code.. 11 Using Sessions.. 12 Concurrency .. 12 Sessions with a Shared Configuration File .. 12 Creating Sessions .. 12 Create Sessions with Option Overrides .. 13 Deprecated New.. 13 Shared Configuration Fields .. 14 Environment Variables .. 7 Adding Request Handlers .. 14 Copying a Session .. 14 Using AWS Services .. 15 Constructing a Service .. 15 Tagging Service Resources .. 15 Getting the HTTP Request and Response with Each Service Call.

4 17 Service Operation Calls .. 18 Calling Operations.. 18 Calling Operations with the Request Form.. 19 Handling Operation Response Body .. 19 Concurrently Using Service Clients .. 20 Using Pagination Methods .. 20 Using Waiters .. 21 Handling Errors .. 23 Handling Specific Service Error Codes .. 23 Additional Error Information .. 24 Specific Error Interfaces .. 24 Code Examples.. 25 SDK Request Examples .. 25 Using with SDK Requests .. 25 Using API Field Setters with SDK Requests .. 26iiiAWS SDK for Go Developer GuideAWS CloudTrail Examples .. 26 Listing the CloudTrail Trails.

5 27 Creating a CloudTrail Trail .. 28 Listing CloudTrail Trail Events .. 30 Deleting a CloudTrail Trail .. 31 Amazon CloudWatch Examples .. 32 Describing CloudWatch Alarms .. 33 Using Alarms and Alarm Actions in CloudWatch .. 34 Getting Metrics from CloudWatch .. 37 Sending Events to Amazon CloudWatch Events .. 40 AWS CodeBuild Examples .. 43 Getting Information about All AWS CodeBuild Projects .. 43 Building an AWS CodeBuild Project .. 44 Listing Your AWS CodeBuild Project Builds .. 45 Amazon DynamoDB Examples .. 46 Listing all Amazon DynamoDB Tables Using the aws sdk for go .

6 46 Creating an Amazon DynamoDB Table Using the aws sdk for go .. 47 Creating an Amazon DynamoDB Table Item Using the aws sdk for go .. 48 Creating Amazon DynamoDB Table Items from a JSON File Using the aws sdk for go .. 50 Reading an Amazon DynamoDB Table Item.. 51 Getting Amazon DynamoDB Table Items Using Expression Builder .. 53 Updating an Amazon DynamoDB Table Item.. 55 Deleting an Amazon DynamoDB Table Item.. 56 Amazon EC2 Examples .. 56 Creating Amazon EC2 Instances with Tags or without Block Devices .. 57 Managing Amazon EC2 Instances .. 59 Working with Amazon EC2 Key Pairs .. 64 Using Regions and Availability Zones with Amazon EC2.

7 67 Working with Security Groups in Amazon EC2 .. 69 Using Elastic IP Addresses in Amazon EC2 .. 73 Amazon Glacier Examples .. 78 The Scenario .. 78 Prerequisites .. 78 Create a Vault .. 78 Upload an Archive .. 79 AWS IAM Examples .. 79 Managing IAM Users.. 79 Managing IAM Access Keys .. 86 Managing IAM Account Aliases .. 90 Working with IAM Policies .. 93 Working with IAM Server Certificates .. 98 AWS KMS Examples .. 102 Creating a CMK in AWS Key Management Service .. 102 Encrypting Data with AWS Key Management Service .. 103 Decrypting a Data Blob in AWS Key Management Service.

8 104Re-encrypting a Data Blob in AWS Key Management Service .. 104 AWS Lambda Examples .. 105 Displaying Information about All Lambda Functions .. 105 Creating a Lambda Function .. 106 Running a Lambda Function .. 107 Configuring a Lambda Function to Receive Notifications .. 109 Amazon Polly Examples .. 110 Getting a List of Voices .. 110 Getting a List of Lexicons .. 111 Synthesizing Speech .. 111 Amazon S3 Examples .. 113 Performing Basic Amazon S3 Bucket Operations .. 113ivAWS SDK for Go Developer GuideCreating Pre-Signed URLs for Amazon S3 Buckets .. 125 Using an Amazon S3 Bucket as a Static Web Host.

9 128 Working with Amazon S3 CORS Permissions .. 132 Working with Amazon S3 Bucket Policies .. 133 Working with Amazon S3 Bucket ACLs .. 137 Encrypting Amazon S3 Bucket Items .. 144 Amazon SES Examples .. 148 Listing Valid Amazon SES Email Addresses .. 148 Verifying an Email Address in Amazon SES .. 149 Sending a Message to an Email Address in Amazon SES .. 150 Deleting an Email Address in Amazon SES .. 152 Getting Amazon SES Statistics .. 153 Amazon SQS Examples .. 154 Using Amazon SQS Queues .. 154 Sending and Receiving Messages in Amazon SQS .. 158 Managing Visibility Timeout in Amazon SQS Queues.

10 162 Enabling Long Polling in Amazon SQS Queues .. 164 Using Dead Letter Queues in Amazon SQS .. 168 Setting Attributes on an Amazon SQS Queue .. 170 Amazon WorkDocs Examples .. 172 Listing Users.. 172 Listing User Docs.. 173 SDK Utilities.. 176 Amazon CloudFront URL Signer .. 176 Amazon DynamoDB Attributes Converter .. 176 Amazon Elastic Compute Cloud Metadata .. 177 Retrieving an Instance's Region .. 177 Amazon S3 Transfer Managers .. 178 Upload Manager.. 178 Download Manager .. 181 Document History .. 184vAWS SDK for Go Developer GuideUsing the aws sdk for go with AWS Cloud9 aws sdk for go Developer GuideThe aws sdk for go provides APIs and utilities that developers can use to build Go applications that useAWS services, such as Amazon Elastic Compute Cloud (Amazon EC2) and Amazon Simple Storage Service(Amazon S3).