網頁

2023/5/2

Golang 建立AWS S3 bucket

Go以AWS SDK aws-sdk-go-v2來建立S3 bucket。


範例環境:

  • Go 1.19


事前要求

參考「AWS 建立IAM管理使用者及credentials」設定供應用程式存取AWS需要的IAM管理員credentials。


下載AWS SDK Go V2 modules

在專案根目錄執行以下命令下載需要的aws-sdk-go-v2 modules。



建立S3 bucket

呼叫config.LoadDefaultConfig()傳入region參數建立aws.Conifg物件,AWS SDK預設會讀取$HOME/.aws/credentials的access keys來通過權限驗證,然後依此參數建立s3.Client來操作S3資源。

呼叫s3.Client.CreateBucket()傳入s3.CreateBucketInput建立bucket。

s3.CreateBucketInput.Bucket填入bucket名稱。

s3.CreateBucketInput.CreateBucketConfiguration填入types.CreateBucketConfiguration,其屬性LocationConstraint屬性填入與client相同region的types.BucketLocationConstraintApNortheast1

main.go

package main

import (
    "context"
    "fmt"

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

func main() {
    ctx := context.TODO()

    client := NewS3Client(ctx)

    bucket := "aws-s3-bucket-202305021730" // bucket name
    output, err := client.CreateBucket(ctx, &s3.CreateBucketInput{
        Bucket: aws.String(bucket),
        CreateBucketConfiguration: &types.CreateBucketConfiguration{
            LocationConstraint: types.BucketLocationConstraintApNortheast1, // same as client config's region
        },
    })
    if err != nil {
        panic(err)
    }

    fmt.Println(*output.Location) // http://aws-s3-bucket-202305021730.s3.amazonaws.com/

}

func NewS3Client(ctx context.Context) *s3.Client {
    cfg, err := config.LoadDefaultConfig(
        ctx,
        config.WithRegion("ap-northeast-1"),
    )
    if err != nil {
        panic(err)
    }
    return s3.NewFromConfig(cfg) // Create an Amazon S3 service client
}

github


注意S3 bucket名稱是全球唯一,所以容易出現名稱衝突而回應BucketAlreadyExists 409 Conflict的錯誤。


測試

執行Go應用程式輸出以下結果。

http://aws-s3-bucket-202305021730.s3.amazonaws.com/

在AWS console檢視建立的bucket。




沒有留言:

張貼留言