@aws- sdk/ 客户端- 无服务器应用程序库

说明

JavaScript Serverless Application Repository Client for Node.js, 浏览器和React Introduct 的 AWS SDK 应用程序存储客户端.

AWS 无服务器应用程序仓库让开发者和企业能够快速找到 并在 AWS 云中部署无服务器应用程序。 关于无服务器应用程序的更多信息, 参见AWS网站上的无服务器电子计算和应用.

AWS无服务器应用程序仓库与AWS Lambda控制台深度融合,以便开发者 所有级别都可以从没有服务器的计算开始,而不需要学习任何新的东西. 您可以使用分类 浏览诸如网络和移动后端,数据处理应用程序,或聊天器等应用程序的关键词. 也可以通过名称、出版商或事件源搜索应用程序。 要使用一个应用程序,你只是选择它, 配置任何需要的字段,并按几下进行部署.

您也可以轻松地发布申请表,公开与社区分享,或私下分享 在你的团队或整个组织。 要发布一个没有服务器的应用程序(或应用程序),您可以使用 AWS管理控制台,AWS命令行接口(AWS CLI),或AWS SDKs上传代码. 随同 代码,您上传一个简单的表单文件,也称为AWS无服务器应用模型(AWS SAM)模板. 关于AWS SAM的更多信息,参见AWS实验室上的AWS无服务器应用模型(AWS SAM) GitHub 仓库 .

AWS 无服务器应用程序仓库开发者指南包含更多关于两个开发者的信息 现有经验:

• Consuming Applications – 浏览应用程序并查看有关它们的信息,包括 源代码和读取我的文件. 同时安装、配置和部署您所选择的应用程序.

  出版应用程序 – 配置并上传应用程序以提供给其他应用程序 ,并发布应用程序的新版本.

安装

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

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

开始

导入

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

// ES5 example
const { ServerlessApplicationRepositoryClient, ListApplicationsCommand } = require("@aws-sdk/client-serverlessapplicationrepository");

// ES6+ example
import { ServerlessApplicationRepositoryClient, ListApplicationsCommand } from "@aws-sdk/client-serverlessapplicationrepository";

使用量

发出请求:

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

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

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

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

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

import { ServerlessApplicationRepository } from "@aws-sdk/client-serverlessapplicationrepository";

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

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

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

// callbacks (not recommended).
client.listApplications(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-serverlessapplicationrepository 软件包正在更新. 为了帮助客户,你可以检查我们 生成客户端脚本。 。 。 .

许可证

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

客户端命令( 操作列表)