全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

初始化(Go)

最近更新时间:2025-03-17 18:18:10

新建Ks3Client

以下代码用于初始化客户端:

// 金山云主账号AccessKey拥有所有API的访问权限,风险很高。
// 强烈建议您创建并使用子账号进行API访问或日常运维,请登录https://uc.console.ksyun.com/pro/iam/#/user/list创建子账号。
// 您可以通过指定Endpoint在指定的地域创建新的存储空间。

// 创建访问凭证,请将<AccessKeyID>与<SecretAccessKey>替换成真正的值
cre := credentials.NewStaticCredentials("<AccessKeyID>", "<SecretAccessKey>", "")
// 创建Ks3Client
client := s3.New(&aws.Config{
    Credentials: cre,                          // 访问凭证,必填
    Region:      "BEIJING",                    // 访问的地域,必填
    Endpoint:    "ks3-cn-beijing.ksyuncs.com", // 访问的域名,必填
})

1. Endpoint与Region对应关系

2. 关于获取AK/SK的更多细节,请参见文档:开通KS3服务

3. 如您的Bucket创建时间在2022年7月8日前,既可以使用二级域名访问也可以使用三级域名访问,如您的Bucket创建时间在2022年7月8日后,只能使用三级域名访问。

配置项参数

以下为配置项参数详细说明:

参数名

参数描述

是否必填

Credentials

访问凭证。需要填写AK、SK构造。默认值:无。

Region

访问的地域。默认值:无。示例值:BEIJING

Endpoint

访问的域名。默认值:无。示例值:ks3-cn-beijing.ksyuncs.com,详情可参考文档:Endpoint与Region的对应关系

DisableSSL

禁止使用HTTPS访问KS3。默认值:false。

可选值:

  • true:禁用HTTPS,通过HTTP协议访问KS3。

  • false:开启HTTPS,通过HTTPS协议访问KS3。

S3ForcePathStyle

是否使用二级域名(Path Style风格)访问KS3。默认值:false。

可选值:

  • true:使用二级域名(Path Style风格)访问KS3。

  • false:使用三级域名(Virtual Hosted Style风格)访问KS3。

DomainMode

使用自定义域名。默认值:false。

可选值:

  • true:使用自定义域名,此时Endpoint参数需填写自定义域名。

  • false:不使用自定义域名。

SignerVersion

签名方式。默认值:V2。

可选值:

  • V2:使用V2签名。

  • V4:使用V4签名,计算请求体。

  • V4_UNSIGNED_PAYLOAD_SIGNER:使用V4签名,不计算请求体。

LogLevel

日志等级。默认值:aws.Off(关闭日志)。

可选值:aws.Offaws.Erroraws.Warnaws.Infoaws.Debug

LogHTTPBody

将请求体打入日志。默认值:false。

可选值:

  • true:将请求体打入日志。

  • false:不将请求体打入日志。

Logger

日志输出位置。默认值:os.Stdout(标准输出),即终端或控制台。详情可参考文档:设置日志输出

MaxRetries

最大重试次数。默认值:3。即请求失败后重试3次,总共请求4次。

  • 值为0或不填写表示使用默认值,即重试3次。

  • 值小于0表示不重试,如:-1表示不重试。

RetryRule

重试等待策略。默认值:retry.DefaultExponentialRetryRule(指数等待策略)。详情可参考文档:设置重试策略及重试条件

ShouldRetry

应当重试的条件。默认值:retry.ShouldRetry。详情可参考文档:设置重试策略及重试条件

CrcCheckEnabled

开启CRC64数据校验。默认值:false。

可选值:

  • true:开启CRC64数据校验。

  • false:关闭CRC64数据校验。

HTTPClient

请求的客户端。默认值:http.DefaultClient

纯净模式常规模式

纯净模式

点击可全屏预览文档内容