@aws-sdk/客户端-ebs

说明

JavaScript EBS客户端的AWS SDK为Node.js,浏览器和React Industrial.

您可以使用 Amazon Elastic Block Store (Amazon ESS) 直接 API 创建 Amazon EBS 快照,直接写入数据到 您的快照,读取快照上的数据,并识别差异或变化 两个快照。 如果您是一个独立的软件销售商 Amazon EBS,EBS直接API使得跟踪增量变化更有效率和成本效益更高 你的亚马逊EBS通过快照。 不必再创作出新的一卷 从快照,然后使用亚马逊弹性计算云(Amazon EC2)实例来比较差异.

您可以直接从数据中创建增量快照到卷和卷 云来用以快取灾复原. 有了写作和阅读快照的能力,你可以 将您在灾难中的数据写入快照 。 然后,在康复后,你可以 将它恢复到亚马逊网络服务或从快照上取出的地方. 你不再需要建造和 维护复杂的机制,将数据复制到和从亚马逊EBS复制.

本API参考文献提供动作,数据类型, 参数和 EBS 直接 API 的错误。 关于哪些要素的更多信息 组成EBS直接API, 以及如何有效使用它们的例子, 看 访问 Amazon EBS 快照的内容 输入 亚马逊弹性计算云用户 指南关于所支持的亚马逊网络服务区域、终点点、, eBS直接API的服务配额,参见 亚马逊弹性块存储端点和配额 内 页:1 亚马逊网络服务总参考。 。 。 .

安装

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

• npm install @aws-sdk/client-ebs
• yarn add @aws-sdk/client-ebs
• pnpm add @aws-sdk/client-ebs

开始

导入

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

// ES5 example
const { EBSClient, ListChangedBlocksCommand } = require("@aws-sdk/client-ebs");

// ES6+ example
import { EBSClient, ListChangedBlocksCommand } from "@aws-sdk/client-ebs";

使用量

发出请求:

• 以配置(如证书,区域)为客户端提供证据.
  • 见 文件/中心 用于配置细节.
  • 见 @aws- sdk/ 配置 附加选项.
• 以输入参数证明命令 .
• 打电话 send 操作客户端,以输入方式提供命令对象.

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

const params = { /** input parameters */ };
const command = new ListChangedBlocksCommand(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"后缀.

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

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

import { EBS } from "@aws-sdk/client-ebs";

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

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

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

// callbacks (not recommended).
client.listChangedBlocks(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 问题来跟踪错误和特性请求,但处理它们的带宽有限.

• 访问 开发者指南 或者说 API 参考。 。 。 .
• 看看贴有标签的博客文章 aws-sdk-js aWS 开发者博客.
• 问个问题 叠叠流 并贴上标签 aws-sdk-js。 。 。 .
• 加入 AWS JavaScript 社区 发光。 。 。 .
• 如果你发现你发现了一个虫子,请 打开一个问题。 。 。 .

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

捐款

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

许可证

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

客户端命令( 操作列表)