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函数