You need to enable JavaScript to run this app.
导航
初始化客户端(Harmony SDK)
最近更新时间:2024.12.24 10:05:00首次发布时间:2024.12.23 17:29:49

初始化 TOSClient 实例之后,您才可以向 TOS 服务发送 HTTP/HTTPS 请求。本文介绍 Harmony SDK 的初始化方式。
TOS Harmony 客户端提供了一系列接口用来与 TOS 服务进行交互,用来管理桶和对象等 TOS 的资源。初始化客户端时,需要设置 AccessKey ID、AccessKey Secret 和 Region 等信息。

创建 TosClient

STS (Security Token Service) 是一种授权第三方用户临时访问的服务。通过 STS,您可以为第三方应用或子用户提供自定义过期时间的 Token 访问凭证。
Harmony SDK 提供了相应的访问接口,支持通过 STS 进行临时授权访问 TOS。推荐在 Harmony SDK 使用 STS 的方式访问 TOS。配置时,您需要在 SDK 中设置授权的 Token。
以下代码展示如何通过 STS 初始化 TosClient。

const client = new TosClient({
  accessKeyId: "Provide your ak",
  accessKeySecret: "Provide your sk",
  securityToken: 'Provide your securityToken',
  region: "Provide your region", // 填写 Bucket 所在地域。以华北2(北京)为例,"Provide your region" 填写为 cn-beijing。
  endpoint: "Provide your endpoint", // 填写域名地址。
});

初始化参数列表

参数

参数类型

是否必选

示例值

说明

accessKeyId

String

必选

AKTPYmI1Z****

Access Key ID。查看 AK、SK 信息的具体步骤,请参见查看 AK/SK 信息

accessKeySecret

String

必选

T1dJM01UU****==

AccessKey Secret,私有访问密钥。

region

String

必选

cn-beijing

TOS 服务端所在地域。TOS 支持的地域及访问域名信息,请参见地域和访问域名(Endpoint)

endpoint

String

可选

tos-cn-beijing.volces.com

访问域名,为空时使用 region 所在的访问域名。

securityToken

String

可选

STSkeyJBY2NvdW50SW************

临时访问凭证中的安全令牌。关于创建临时访问凭证的详细介绍,请参见使用 STS 临时 AK/SK+Token 访问火山引擎 TOS

secure

Boolean

可选

true

是否使用 HTTPS 请求,取值说明如下:

  • true:使用 HTTPS 请求。
  • false:不使用 HTTPS 请求。

默认为 true

isCustomDomain

Boolean

可选

false

是否为自定义域名,,取值说明如下:

  • true:自定义域名。
  • false:不是自定义域名。

默认为 false