2. 初始化

2.1. 确定EndPoint

EndPoint 是NOS各个区域的地址,目前支持以下形式

EndPoint类型 备注
NOS区域域名地址 使用桶所在的区域的NOS域名地址

2.1.1. NOS区域域名地址

进入NOS控制台,在桶的 属性 中可以查找到当前桶所在的区域及域名,桶的域名的后缀部分为 该桶的公网域名,例如:test-logging.nos-eastchina1.126.net中的nos-eastchina1.126.net 为该桶的公网EndPoint。

2.2. 配置秘钥

要接入NOS服务,您需要一对有效的AccessKey(包括AccessKeyId与AccessKeySecret)来进行 签名验证,开通服务与AccessKey请参考 访问控制 :

在获取到AccessKeyId与AccessKeySecret之后,可以按照以下的步骤进行初始化

2.3. 新建S3

GO-SDK提供的接口都在S3中实现,并以成员方法的方式对外提供调用。因此使用GO-SDK前必须实例化一个S3对象。

2.3.1. 关于请求参数

S3中的方法采用对象方式进行传参:

 package main

import (
  "github.com/aws/aws-sdk-go/aws/session"
  "github.com/aws/aws-sdk-go/aws/credentials"
  "github.com/aws/aws-sdk-go/aws"
  "fmt"
  "github.com/aws/aws-sdk-go/service/s3"
)

func main() {
  copyObjectInput := &s3.CopyObjectInput{
      Bucket:aws.String(DestBucket),
      Key:aws.String(DestKey),
      CopySource:aws.String("/" + SrcBucket + "/" + SrcKey),
    }
    _,err := getS3Client().CopyObject(copyObjectInput)
    if err != nil {
      fmt.Printf(err.Error())
    }
}

2.4. 实例化S3

如果您需要修改S3的默认参数,可以在实例化S3时传入Config实例。Config是S3的配置类,可配置连接超时、Key等参数。通过Config可以设置的参数见下表:

参数 描述 是否必须
Endpoint
上传的NOS地址
AccessKey
认证使用的Access Key
SecretKey
认证使用的Access Secret
DisableSSL
是否弃用HTTPS
默认:false
S3ForcePathStyle
是否使用子目录
默认:false,NOS 公有云不支持子目录
LogLevel
打印日志的等级
默认:Debug
Logger
打印日志的对象

带Config参数实例化S3的示例代码:

 package main

import (
  "github.com/aws/aws-sdk-go/aws/session"
  "github.com/aws/aws-sdk-go/aws/credentials"
  "github.com/aws/aws-sdk-go/aws"
  "github.com/aws/aws-sdk-go/service/s3"
)


func getS3Client() (*s3.S3){
  creds := credentials.NewStaticCredentials(ak, sk, "")
  config := &aws.Config{
    Region:           aws.String(region),
    Endpoint:         aws.String(endpoint),
    S3ForcePathStyle: aws.Bool(false),
    Credentials:      creds,
    DisableSSL:       aws.Bool(false),
  }
  sess := session.Must(session.NewSession(config))
  return s3.New(sess)
}

Attention

后面的示例代码默认您已经实例化了所需的S3对象, 不再赘述,后续的代码示例均需要将实例化的代码写入main函数