AWS Go SDK v2 版本

aws-sdk-go-v2 是专为 Go 编程语言设计的 AWS SDK 第二版。

v2 版本 SDK 要求最低 Go 1.20 版本。

查看版本说明了解 SDK 最新错误修复、更新及新增功能信息。

快速跳转：

• 入门指南
• 获取帮助
• 参与贡献
• 更多资源

SDK 主要版本的维护与支持

关于 SDK 主要版本及其底层依赖的维护与支持信息，请参阅 AWS SDK 和工具共享配置与凭证参考指南中的以下内容：

• AWS SDK 和工具维护策略
• AWS SDK 和工具版本支持矩阵

Go 版本支持策略

v2 SDK 遵循上游发布策略，并对最近弃用的语言版本提供额外六个月支持期。

AWS 保留提前终止对不受支持 Go 版本支持的权利，以解决重大安全问题。

入门指南

要开始使用 SDK，请为项目配置 Go 模块，并通过 go get 获取 SDK 依赖。以下示例展示如何使用 v2 SDK 通过 Amazon DynamoDB 客户端发起 API 请求。

初始化项目

$ mkdir ~/helloaws
$ cd ~/helloaws
$ go mod init helloaws

添加 SDK 依赖

$ go get github.com/aws/aws-sdk-go-v2/aws
$ go get github.com/aws/aws-sdk-go-v2/config
$ go get github.com/aws/aws-sdk-go-v2/service/dynamodb

编写代码

在您常用的编辑器中，将以下内容添加到 main.go 文件

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/aws/aws-sdk-go-v2/aws"
    "github.com/aws/aws-sdk-go-v2/config"
    "github.com/aws/aws-sdk-go-v2/service/dynamodb"
)

func main() {
    // Using the SDK's default configuration, loading additional config
    // and credentials values from the environment variables, shared
    // credentials, and shared configuration files
    cfg, err := config.LoadDefaultConfig(context.TODO(), config.WithRegion("us-west-2"))
    if err != nil {
        log.Fatalf("unable to load SDK config, %v", err)
    }

    // Using the Config value, create the DynamoDB client
    svc := dynamodb.NewFromConfig(cfg)

    // Build the request with its input parameters
    resp, err := svc.ListTables(context.TODO(), &dynamodb.ListTablesInput{
        Limit: aws.Int32(5),
    })
    if err != nil {
        log.Fatalf("failed to list tables, %v", err)
    }

    fmt.Println("Tables:")
    for _, tableName := range resp.TableNames {
        fmt.Println(tableName)
    }
}

编译与执行

$ go run .
Tables:
tableOne
tableTwo

获取帮助

请通过以下社区资源寻求帮助。我们使用 GitHub issues 来跟踪缺陷报告和功能需求。

• 向我们提问或发起讨论
• 如发现潜在缺陷，请提交issue
• 通过AWS支持中心创建支持工单

本SDK实现了AWS服务API。关于AWS服务的通用问题及限制，可参阅Amazon Web Services讨论论坛。

提交Issue

如在使用AWS SDK for Go时遇到缺陷，我们非常期待您的反馈。提交新issue前，请先搜索现有问题确认是否已有类似报告。请注明您使用的AWS SDK for Go版本、Go语言版本及操作系统环境，并在适当时提供复现步骤。

GitHub issues仅用于缺陷报告和功能请求。使用SDK时的帮助咨询，请参考获取帮助章节列出的资源。保持issues列表简洁将有助于我们及时响应。

反馈与贡献

v2 SDK将使用GitHub Issues跟踪功能需求与SDK问题。此外，我们将通过GitHub Projects管理跨多PR的大型任务（如重构SDK内部请求生命周期）。您可通过以下方式提供反馈：

GitHub issues。通过提交GitHub Issues反馈问题或报告缺陷。这是首选的反馈机制，便于其他用户参与讨论、点赞issue等。您提交的issue将纳入GA发布路线图评估。

代码贡献。欢迎为AWS SDK for Go 2.0提交修复或新增功能的PR。所有PR需遵循Apache 2.0许可协议，将由SDK团队成员审核后合并。建议尽可能附带单元测试。

资源

SDK开发者指南 - 本指南助您快速上手AWS SDK for Go V2

SDK迁移指南 - 从AWS SDK for Go迁移至V2的指导文档

SDK API参考文档 - 查阅SDK支持的AWS服务所有API操作的输入输出参数。该参考同时包含SDK文档、使用示例、服务客户端API操作及必需参数说明。

服务文档 - 了解AWS服务接口的官方文档。这些指南既适合服务入门，也可查询进阶信息。虽然编码时非必需，但部分服务可能提供有价值的示例代码。

论坛 - 提问求助与意见反馈

Issues - 报告问题、提交PR及参与开发（参见Apache 2.0许可）