对象存储
对象存储
对象存储
文档指南
请输入
产品动态
产品公告
产品计费
快速入门
用户指南
存储桶管理
基础设置
容错与容灾
ObjectSet
文件管理
监控与告警
权限配置
IAM 策略管理
典型配置场景
IAM 子用户授权
使用工具及 SDK 的授权说明
接入点
单区域接入点（SRAP）
内容感知与处理（SenseFlow）
TOS Agent
数据处理
分层命名空间（HNS）
TOS Vectors
API 参考
向量桶
SDK 参考
Python-Vectors
向量桶
向量索引
Java-Vectors
向量桶
向量索引
Node.js-Vectors
向量桶
向量索引
工具指南
tosutil
常用命令
辅助命令
TOS Browser
FSX
TOS PyTorch Connector
tosfsspec
API 参考
签名机制
存储桶
桶基础操作
自定义域名
数据处理
媒体处理
视频转码
音频转码
ObjectSet
生命周期
对象
基础操作
分片上传
SDK 参考
Java
存储桶接口
管理桶配置
ObjectSet
对象接口
下载对象
数据处理
视频处理
日志配置
分层命名空间
Python
数据处理
存储桶接口
对象接口
上传对象
C++
存储桶接口
对象接口
Go
对象接口
存储桶接口
管理桶配置
ObjectSet
数据处理
日志配置
Node.js
存储桶接口
对象接口
上传对象
数据处理
Browser.js
上传对象
.NET
对象接口
PHP
对象接口
异常处理
Android
对象接口
iOS
对象接口
Harmony
存储桶接口
对象接口
上传对象
Rust
存储桶接口
桶基础操作
桶清单
自定义域名
对象接口
基础操作
错误码
01-SERVICE_ERROR
02-AUTH
03-ACCESS_CONTROL
04-QOS
05-REQUEST
06-BUCKET
07-LIFECYCLE
08-ACL
09-CORS
10-POLICY
11-MIRROR
12-REPLICATION
13-WEBSITE
14-NOTIFICATION
15-ENCRYPT
16-CUSTOMDOMAIN
17-OBJECT
18-TAG
19-MULTIPART
20-STORAGE_CLASS
21-CALLBACK
22-DATA_PROCESS
23-BATCH
24-STORAGE_LENS
25-INVENTORY
26-DIRECTORY_BUCKET
32-WORM
常见问题
最佳实践
AIGC-豆包大模型最佳实践
校验数据一致性
- 文档首页
对象存储TOS VectorsSDK 参考Node.js-Vectors初始化客户端（TOS Vectors Node.js SDK）
复制全文
下载 pdf初始化客户端（TOS Vectors Node.js SDK）
文档反馈
问问助手初始化 TosVectorsClient 实例之后，您才可以向 TOS Vectors 服务发送 HTTP/HTTPS 请求。本文介绍 Node.js SDK 的初始化方式。
背景信息
TOS Vectors Node.js 客户端提供了一系列接口用来与 TOS Vectors 服务进行交互，用来管理桶和向量等 TOS Vectors 上的资源。初始化客户端时，需要带上 Access Key ID（AK）、Secret Access Key（SK） 和 Region 等信息。在初始化时，您可以设置建立连接超时时间、超时重试次数和最大空闲连接数量等可选参数。
前提条件
配置长期访问凭证
初始化 SDK 前，您需要先配置长期访问凭证。本章节介绍不同操作系统下配置长期访问凭证的操作步骤。
macOS
Linux
Windows
- 打开终端并执行以下命令打开文件。
- nano ~/.bash_profile
- 在文件末尾添加 AKSK 信息。
- export TOS_ACCESS_KEY=AKTPYmI1Z****export TOS_SECRET_KEY=T1dJM01UU****
- 保存文件并退出。
- 执行以下命令生效配置信息。
- source ~/.bash_profile
- 执行以下命令验证配置信息。
- echo $TOS_ACCESS_KEYecho $TOS_SECRET_KEY
- 如果配置成功，则返回如下示例：
- AKTPYmI1Z****T1dJM01UU****
- 打开终端并执行以下命令打开文件。
- sudo vim /etc/profile
- 在文件末尾添加 AKSK 信息。
- export TOS_ACCESS_KEY=AKTPYmI1Z****export TOS_SECRET_KEY=T1dJM01UU****
- 保存文件并退出。
- 执行以下命令生效配置信息。
- source /etc/profile
- 执行以下命令验证配置信息。
- echo $TOS_ACCESS_KEYecho $TOS_SECRET_KEY
- 如果配置成功，则返回如下示例：
- AKTPYmI1Z****T1dJM01UU****
- 打开命令行工具，执行以下命令，添加 AKSK 信息。
- set TOS_ACCESS_KEY=AKTPYmI1Z****set TOS_SECRET_KEY=T1dJM01UU****
- 执行以下命令生效配置信息。
- setx TOS_ACCESS_KEY "%TOS_ACCESS_KEY%"setx TOS_SECRET_KEY "%TOS_SECRET_KEY%"
- 重启命令行工具，然后执行以下命令验证配置信息。
- echo %TOS_ACCESS_KEY%echo %TOS_SECRET_KEY%
- 如果配置成功，则返回如下示例：
- AKTPYmI1Z****T1dJM01UU****
创建 TosVectorsClient
使用必选参数初始化
以下代码展示如何使用 TOS 域名等必选参数初始化 TosVectorsClient，包括 Access Key ID、Secret Access Key、Endpoint 和 Region。
import { TosVectorsClient } from '@volcengine/tos-sdk';
// 创建客户端
const client = new TosVectorsClient({
accessKeyId: process.env['TOS_ACCESS_KEY'],
accessKeySecret: process.env['TOS_SECRET_KEY'],
region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，则 "Provide your region" 填写为 cn-beijing。
endpoint: "Provide your endpoint", // 填写域名地址
});
使用可选参数初始化
TOS Vectors Node.js SDK 提供了多个可选参数来自定义配置 TosVectorsClient，例如配置 STS、HTTP 请求超时时间、请求重试策略等。
以下代码展示如何自定义配置 TosVectorsClient 的 HTTP 连接超时时间，具体的配置场景请参见下文的配置超时机制。
import { TosVectorsClient } from '@volcengine/tos-sdk';
const connectionTimeout = 10000;
// 创建客户端
const client = new TosVectorsClient({
accessKeyId: process.env['TOS_ACCESS_KEY'],
accessKeySecret: process.env['TOS_SECRET_KEY'],
region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，则 "Provide your region" 填写为 cn-beijing。
endpoint: "Provide your endpoint", // 填写域名地址
connectionTimeout,
});
console.log(client);
常见配置场景
配置超时机制
您可以在初始化 TosVectorsClient 时，通过添加可选参数配置网络请求的超时时间。目前 TOS Vectors Node.js SDK 提供了以下超时参数用于 HTTP 请求的超时配置：
- requestTimeout：HTTP 请求超时时间，单位毫秒，默认值为 120000，即 120 秒。
- connectionTimeout：建立 HTTP 连接的超时时间，单位毫秒，默认值为 10000，即 10 秒。
以下代码展示如何在初始化 TosVectorsClient 时配置超时时间。
// 导入 SDK, 当 TOS Node.JS SDK 版本小于 2.5.2 请把下方 TosVectorsClient 改成 TOS 导入
import { TosVectorsClient } from '@volcengine/tos-sdk';
const connectionTimeout = 10000;
const requestTimeout = 120000;
// 创建客户端
const client = new TosVectorsClient({
accessKeyId: process.env['TOS_ACCESS_KEY'],
accessKeySecret: process.env['TOS_SECRET_KEY'],
region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，则 "Provide your region" 填写为 cn-beijing。
endpoint: "Provide your endpoint", // 填写域名地址
connectionTimeout,
requestTimeout,
});
console.log(client);
配置重试策略
网络波动或短期 TOS Vectors 服务异常（例如返回 500 HTTP 状态码）等场景会导致请求 TOS 服务失败。针对此问题，SDK 内部提供了重试机制，根据设置的重试次数进行指数退避重试，默认重试次数为 3 次。
幂等操作的接口在失败后会使用指数退避策略进行重试，非幂接口则直接抛出对应异常。您可以在初始化 TosVectorsClient 时，添加可选参数配置重试次数。
以下代码展示如何设置 SDK 的重试次数。
// 导入 SDK, 当 TOS Node.JS SDK 版本小于 2.5.2 请把下方 TosVectorsClient 改成 TOS 导入
import { TosVectorsClient } from '@volcengine/tos-sdk';
// 设置最大重试次数为 3 次，可根据实际需要调整
const maxRetryCount = 3;
// 创建客户端
const client = new TosVectorsClient({
accessKeyId: process.env['TOS_ACCESS_KEY'],
accessKeySecret: process.env['TOS_SECRET_KEY'],
region: "Provide your region", // 填写 Bucket 所在地域。以华北2（北京)为例，则 "Provide your region" 填写为 cn-beijing。
endpoint: "Provide your endpoint", // 填写域名地址
maxRetryCount,
});
初始化参数列表
参数 | 参数类型 | 是否必选 | 示例值 | 说明 |
参数 | 参数类型 | 是否必选 | 示例值 | 说明 |
accessKeyId | string | 必选 | AKTPYmI1Z**** | Access Key ID，密钥 ID。 |
accessKeySecret | string | 必选 | T1dJM01UU****== | AccessKey Secret，私有访问密钥。 |
region | string | 必选 | cn-beijing | TOS 服务端所在地域。 |
endpoint | string | 可选，为空时由 region 参数决定 | tosvectors-cn-beijing.volces.com | 访问域名，为空时由 region 参数决定。 |
stsToken | string | 可选 | STSkeyJBY2NvdW50SW************ | 临时访问凭证中的安全令牌。 |
enableVerifySSL | boolean | 可选 | true | 配置是否开启 SSL 证书校验，默认值为 False。 |
requestTimeout | number | 可选 | 120000 | HTTP 请求超时时间，单位毫秒，默认值为 120000。 |
connectionTimeout | number | 可选 | 10000 | 建立连接超时时间，单位毫秒，默认值为 10000。 |
idleConnectionTime | number | 可选 | 60000 | 连接池中空闲 HTTP 连接时间超过此参数的设定值，则关闭 HTTP 连接，单位：毫秒，默认值为 60000。 |
maxConnections | number | 可选 | 1024 | HTTP 连接池最大连接数，默认值为 1024。 |
maxRetryCount | number | 可选 | 3 | 请求失败后的最大重试次数，默认值为 3。 |
proxyHost | string | 可选 | localhost | 代理服务器的主机地址，当前只支持 HTTP 协议。 |
proxyPort | number | 可选 | 8080 | 代理服务器的端口号。 |
最近更新时间：2026.08.03 10:40:16
这个页面对您有帮助吗？
有用
有用
无用
无用