使用 AWS 的 GO SDK 獲取區域與終端節點信息

endpoints 包提供了一個易用的介面，可以獲取到一個服務的終端節點的 url 列表和區域列表信息。並且我們將相關信息根據 AWS 服務區域進行了分組，如 AWS 標準、AWS 中國和 AWS GovCloud（美國）。

解析終端節點

設置 SDK 的默認配置時， SDK 會自動地使用 endpoints.DefaultResolver 函數。你也可以自己調用包中的EndpointFor 方法來解析終端節點。

// 解析在us-west-2區域的S3服務的終端節點
resolver := endpoints.DefaultResolver()
endpoint, err := resolver.EndpointFor(endpoints.S3ServiceID, endpoints.UsWest2RegionID)
if err != nil {
        fmt.Println("failed to resolve endpoint", err)
        return
}

fmt.Println("Resolved URL:", endpoint.URL)

如果你需要自定義終端節點的解析邏輯，你可以實現 endpoints.Resolver 介面，並傳值給aws.Config.EndpointResolver。當你打算編寫自定義的終端節點邏輯，讓 SDK 可以用來解析服務的終端節點時候，這個功能就會很有用。

以下示例，創建了一個配置好的 Session，然後 Amazon S3 服務的客戶端就可以使用這個自定義的終端節點。

s3CustResolverFn := func(service, region string, optFns ...func(*endpoints.Options)) (endpoints.ResolvedEndpoint, error) {
        if service == "s3" {
               return endpoints.ResolvedEndpoint{
                       URL:           "s3.custom.endpoint.com",
                       SigningRegion: "custom-signing-region",
               }, nil
        }

        return defaultResolver.EndpointFor(service, region, optFns...)
}
sess := session.Must(session.NewSessionWithOptions(session.Options{
        Config: aws.Config{
               Region:           aws.String("us-west-2"),
               EndpointResolver: endpoints.ResolverFunc(s3CustResolverFn),
        },
}))

分區

endpoints.DefaultResolver 函數的返回值可以被 endpoints.EnumPartitions介面使用。這樣就可以獲取 SDK 使用的分區片段，也可以列出每個分區的分區信息。

// 迭代所有分區表列印每個分區的ID
resolver := endpoints.DefaultResolver()
partitions := resolver.(endpoints.EnumPartitions).Partitions()

for _, p := range partitions {
        fmt.Println("Partition:", p.ID())
}

除了分區表之外，endpoints 包也提供了每個分區組的 getter 函數。這些工具函數可以方便列出指定分區，而不用執行默認解析器列出所有的分區。

partition := endpoints.AwsPartition()
region := partition.Regions()[endpoints.UsWest2RegionID]

fmt.Println("Services in region:", region.ID())
for id, _ := range region.Services() {
        fmt.Println(id)
}

當你獲取區域和服務值後，可以調用 ResolveEndpoint。這樣解析端點時，就可以提供分區的過濾視圖。

獲取更多 AWS SDK for GO 信息, 請關注其開源倉庫。若你有更好的看法，請留言評論。

via: https://aws.amazon.com/cn/blogs/developer/using-the-aws-sdk-for-gos-regions-and-endpoints-metadata

作者：Jason Del Ponte 譯者：Vic020 校對：wxy

本文由 LCTT 原創編譯，Linux中國 榮譽推出

本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive