初始化 TOSClient 实例之后,您才可以向 TOS 服务发送 HTTP/HTTPS 请求。本文介绍 Harmony SDK 的初始化方式。
TOS Harmony 客户端提供了一系列接口用来与 TOS 服务进行交互,用来管理桶和对象等 TOS 的资源。初始化客户端时,需要设置 AccessKey ID、AccessKey Secret 和 Region 等信息。
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 | 访问域名,为空时使用 |
securityToken | String | 可选 | STSkeyJBY2NvdW50SW************ | 临时访问凭证中的安全令牌。关于创建临时访问凭证的详细介绍,请参见使用 STS 临时 AK/SK+Token 访问火山引擎 TOS。 |
secure | Boolean | 可选 | true | 是否使用 HTTPS 请求,取值说明如下:
默认为 |
isCustomDomain | Boolean | 可选 | false | 是否为自定义域名,,取值说明如下:
默认为 |