@aws-sdk/client-elastic-load-balancing-v2

中文文档
3.1164.0发布于 2026/11/07Apache-2.0TypeScriptESM + CJS近 30 天下载 669.4万

JavaScript Elastic Load Balance V2 节点客户端的 AWS SDK, 浏览器和回放本地

中文使用文档
文档目录10 节
  1. 说明
  2. 安装
  3. 开始
  4. 导入
  5. 使用量
  6. 解决问题
  7. 获取帮助
  8. 捐款
  9. 许可证
  10. 客户端命令( 操作列表)

@aws-sdk/客户端-弹性-负载-均衡-v2

说明

JavaScript ElasticLoadBalanceV2 节点客户端的AWS SDK,浏览器和React Introduct.

弹性负载平衡

负载平衡器会分配到目标之间的流量, 例如您的EC2 实例 . 这使得您能够增加应用程序的可用性。 负载平衡器 监测已登记目标的健康情况,确保目标仅通向 健康的目标。 您配置您的负载平衡器可指定一个来信流量 或更多收听器,这些收听器配置为协议和端口号码,用于连接 客户端为负载平衡器。 您配置带有协议和端口号码的目标组 从负载平衡器连接到目标,并使用健康检查设置 在检查目标健康状况时.

弹性负载平衡支持以下类型的负载平衡器: 应用程序负载 平衡器、网络负载平衡器、网关负载平衡器和经典负载平衡器。 这个 参考文献包括下列负载平衡器类型:

  • 应用程序负载平衡器 - 在应用程序层( 第7层)操作并支持 HTTP 和 HTTPS. (英语).

  • 网络负载平衡器 - 在传输层操作( 第4层) 并支持 TCP, TLS, UDP, 和QUIC. (中文(简体) ).

  • 网关负载平衡器 - 在网络层操作( 第3层) .

更多信息,请参见 弹性负载平衡用户 指南。 。 。 .

所有弹性负载平衡操作均具有一能性,这意味着它们完成于 大多数时候。 如果你重复一次手术,它就会成功.

安装

要安装此软件包, 请使用您最喜欢的软件包管理器的 CLI :

  • npm install @aws-sdk/client-elastic-load-balancing-v2
  • yarn add @aws-sdk/client-elastic-load-balancing-v2
  • pnpm add @aws-sdk/client-elastic-load-balancing-v2

开始

导入

AWS SDK由客户端和命令进行调制. 要发送请求,只需导入 ElasticLoadBalancingV2Client 财务报告和审定财务报表 例如,您需要的命令 DescribeListenersCommand数字 :

// ES5 example
const { ElasticLoadBalancingV2Client, DescribeListenersCommand } = require("@aws-sdk/client-elastic-load-balancing-v2");
// ES6+ example
import { ElasticLoadBalancingV2Client, DescribeListenersCommand } from "@aws-sdk/client-elastic-load-balancing-v2";

使用量

发出请求:

  • 以配置(如证书,区域)为客户端提供证据.
  • 以输入参数证明命令 .
  • 打电话 send 操作客户端,以输入方式提供命令对象.
const client = new ElasticLoadBalancingV2Client({ region: "REGION" });

const params = { /** input parameters */ };
const command = new DescribeListenersCommand(params);

自动/等待

我们建议使用 等待时 运算符等待通过发送操作返回的承诺如下:

// async/await.
try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  // error handling.
} finally {
  // finally.
}

承诺

您还可以使用 承诺连锁。 。 。 .

client
  .send(command)
  .then((data) => {
    // process data.
  })
  .catch((error) => {
    // error handling.
  })
  .finally(() => {
    // finally.
  });

合并客户端

归集客户端类别从同套件中导出,但没有"Client"后缀.

ElasticLoadBalancingV2 扩展 ElasticLoadBalancingV2Client 并额外支持所有操作,服务员, 和活人作为方法. 这种风格可能从JavaScript v2的AWS SDK中为您所熟悉.

如果你正在捆绑 AWS SDK, 我们建议只使用赤骨客户端(ElasticLoadBalancingV2Client) (中文(简体) ). 更多详情见博客文章: javaScript 的 AWS SDK 模块包。 。 。 .

import { ElasticLoadBalancingV2 } from "@aws-sdk/client-elastic-load-balancing-v2";

const client = new ElasticLoadBalancingV2({ region: "REGION" });

// async/await.
try {
  const data = await client.describeListeners(params);
  // process data.
} catch (error) {
  // error handling.
}

// Promises.
client
  .describeListeners(params)
  .then((data) => {
    // process data.
  })
  .catch((error) => {
    // error handling.
  });

// callbacks (not recommended).
client.describeListeners(params, (err, data) => {
  // process err and data.
});

解决问题

当服务返回例外时,错误将包括例外信息, 以及响应元数据(如请求编号).

try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  const { requestId, cfId, extendedRequestId } = error.$metadata;
  console.log({ requestId, cfId, extendedRequestId });
  /**
   * The keys within exceptions are also parsed.
   * You can access them by specifying exception names:
   * if (error.name === 'SomeServiceException') {
   *     const value = error.specialKeyInException;
   * }
   */
}

另见 文档/错误。 。 。 .

获取帮助

请利用这些社区资源获得帮助. 我们使用 GitHub 问题来跟踪错误和特性请求,但处理它们的带宽有限.

为了测试您在Node.js中通用的JavaScript代码,浏览器和反应本地环境, 拜访我们 代码样本 repo。 。 。 .

捐款

此客户端代码是自动生成的. 任何修改在下次修改时都会被覆盖 @aws-sdk/client-elastic-load-balancing-v2 软件包正在更新. 为了帮助客户,你可以检查我们 生成客户端脚本。 。 。 .

许可证

此 SDK 分布于 Apache 许可证,2.0版本, (中文(简体) ), 更多信息见LICENSE.

客户端命令( 操作列表)

添加听众证书

命令 API 引用 编号 : 投入 编号 : 产出

添加标签

命令 API 引用 编号 : 投入 编号 : 产出

添加信任重现

命令 API 引用 编号 : 投入 编号 : 产出

创建收听器

命令 API 引用 编号 : 投入 编号 : 产出

创建LoadBalancer 程序

命令 API 引用 编号 : 投入 编号 : 产出

创建规则

命令 API 引用 编号 : 投入 编号 : 产出

创建目标组

命令 API 引用 编号 : 投入 编号 : 产出

创建信任站

命令 API 引用 编号 : 投入 编号 : 产出

删除收听器

命令 API 引用 编号 : 投入 编号 : 产出

删除 LOADBAlancer 程序

命令 API 引用 编号 : 投入 编号 : 产出

删除规则

命令 API 引用 编号 : 投入 编号 : 产出

删除共享信任结构协会

命令 API 引用 编号 : 投入 编号 : 产出

删除目标组

命令 API 引用 编号 : 投入 编号 : 产出

删除信任层

命令 API 引用 编号 : 投入 编号 : 产出

目标

命令 API 引用 编号 : 投入 编号 : 产出

描述账户属性

命令 API 引用 编号 : 投入 编号 : 产出

描述能力保留

命令 API 引用 编号 : 投入 编号 : 产出

描述听众属性

命令 API 引用 编号 : 投入 编号 : 产出

描述听众证书

命令 API 引用 编号 : 投入 编号 : 产出

描述听众

命令 API 引用 编号 : 投入 编号 : 产出

描述Load Balancer 属性

命令 API 引用 编号 : 投入 编号 : 产出

描述障碍者

命令 API 引用 编号 : 投入 编号 : 产出

说明规则

命令 API 引用 编号 : 投入 编号 : 产出

描述社会保障政策

命令 API 引用 编号 : 投入 编号 : 产出

描述标签

命令 API 引用 编号 : 投入 编号 : 产出

描述目标组属性

命令 API 引用 编号 : 投入 编号 : 产出

描述目标组

命令 API 引用 编号 : 投入 编号 : 产出

描述目标健康

命令 API 引用 编号 : 投入 编号 : 产出

描述信任协会

命令 API 引用 编号 : 投入 编号 : 产出

说明信任结构

命令 API 引用 编号 : 投入 编号 : 产出

描述信任层

命令 API 引用 编号 : 投入 编号 : 产出

获取资源政策

命令 API 引用 编号 : 投入 编号 : 产出

获取 TrustStoreCa 证书

命令 API 引用 编号 : 投入 编号 : 产出

获取信任

命令 API 引用 编号 : 投入 编号 : 产出

修改能力保留

命令 API 引用 编号 : 投入 编号 : 产出

修改IPPools

命令 API 引用 编号 : 投入 编号 : 产出

修改收听器

命令 API 引用 编号 : 投入 编号 : 产出

修改收听器属性

命令 API 引用 编号 : 投入 编号 : 产出

修改LoadBalancer 属性

命令 API 引用 编号 : 投入 编号 : 产出

修改规则

命令 API 引用 编号 : 投入 编号 : 产出

修改目标组

命令 API 引用 编号 : 投入 编号 : 产出

修改目标组属性

命令 API 引用 编号 : 投入 编号 : 产出

修改信任层

命令 API 引用 编号 : 投入 编号 : 产出

注册目标

命令 API 引用 编号 : 投入 编号 : 产出

删除收听器证书

命令 API 引用 编号 : 投入 编号 : 产出

删除标签

命令 API 引用 编号 : 投入 编号 : 产出

删除信任重置

命令 API 引用 编号 : 投入 编号 : 产出

设置地址处理模式

命令 API 引用 编号 : 投入 编号 : 产出

设定规则优先级

命令 API 引用 编号 : 投入 编号 : 产出

设置安全组

命令 API 引用 编号 : 投入 编号 : 产出

设置子网

命令 API 引用 编号 : 投入 编号 : 产出

版本与发布记录

@aws-sdk/client-elastic-load-balancing-v2 共发布 738 个版本,首次发布于 2020/01/17;过去 12 个月发布了 223 个版本。

版本发布日期距今
3.1164.0latest2026/11/07今天
3.1163.02026/11/061 天前
3.1162.02026/11/052 天前
3.1161.02026/10/318 天前
3.1160.02026/10/309 天前
3.1159.02026/10/2910 天前

其他发布通道:alpha → 1.0.0-alpha.18,beta → 1.0.0-beta.5,gamma → 1.0.0-gamma.11,rc → 3.5.1-rc.0。

关于 @aws-sdk/client-elastic-load-balancing-v2 的常见问题

@aws-sdk/client-elastic-load-balancing-v2 是什么?

JavaScript Elastic Load Balance V2 节点客户端的 AWS SDK, 浏览器和回放本地

如何安装 @aws-sdk/client-elastic-load-balancing-v2?

在项目目录运行 npm install @aws-sdk/client-elastic-load-balancing-v2,或使用 pnpm add / yarn add / bun add。

@aws-sdk/client-elastic-load-balancing-v2 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@aws-sdk/client-elastic-load-balancing-v2 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aws-sdk/client-elastic-load-balancing-v2 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@aws-sdk/client-elastic-load-balancing-v2 可以商用吗?

@aws-sdk/client-elastic-load-balancing-v2 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws-sdk/client-elastic-load-balancing-v2 的下载量有多少?

根据 npm 官方下载统计,@aws-sdk/client-elastic-load-balancing-v2 在 2026/10/08 – 2026/11/06 这 30 天内被下载 6,693,921 次,日均约 223,131 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@aws-sdk/client-elastic-load-balancing-v2 还在维护吗?

最新版本 3.1164.0 发布于 2026/11/07(今天);至今共发布 738 个版本,其中过去 12 个月发布了 223 个;首次发布于 2020/01/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。