@aws- sdk/ 客户端安全湖
说明
JavaScript SecurityLake Clients for Node.js的 AWS SDK, 浏览器和React Introduct 用户端.
亚马逊安全 湖站是全程管理的安全数据湖站服务站. 您可以使用安全湖 自动将云、地皮和自定义源的安全数据集中到一个 数据湖存储在您的亚马逊网络服务账户中. 亚马逊网络服务组织 是一个账户管理服务, 可以合并多个 Amazon Web 服务 账户进入您创建和集中管理的组织。 与组织,你 可创建成员账户,并邀请已有账户加入您的组织. 警卫 湖帮助你分析安全数据 以更全面地了解你的 整个组织的安全态势。 也可以帮助你改善 保护您的工作量、应用程序和数据.
数据湖由亚马逊简易存储服务(Amazon S3)桶支撑,而你 保留对数据的所有权.
亚马逊安全 湖与CloudTrail集成,这项服务提供了记录: 用户、角色或亚马逊网络服务采取的行动。 在安全湖,CloudTrail捕捉API呼吁安全湖作为事件. 接获的电话包括电话 从安全湖控制台和密码呼叫 安全湖API行动。 如果你创建一个 ,您可以让 CloudTrail 事件持续传送到 Amazon S3 桶,包括安全湖事件。 如果你不配置一个线索,你仍然可以 查看事件史上的 CloudTrail 控制台最近的事件。 使用 cloudTrail收集的信息,您可以确定向 警卫 Lake, 提出请求的IP地址, 是谁提出的, 当它 并提供了更多的细节。 为了了解更多关于CloudTrail安全湖的信息,见 亚马逊安全湖用户指南。 。 。 .
警卫 湖将安全记录和事件数据的收集自动化 亚马逊网络服务综合服务和第三方服务. 这也帮助你管理 具有自定义保留和复制设置的数据的生命周期。 安全湖区 将所摄入的数据转换成 Apache Parquet 格式和称为“开源”的标准程序 《开放网络安全框架》.
其他亚马逊网络服务服务和第三方服务可以订阅存储在安全湖中的数据 事件反应和安全数据分析.
安装
要安装此软件包, 请使用您最喜欢的软件包管理器的 CLI :
npm install @aws-sdk/client-securitylakeyarn add @aws-sdk/client-securitylakepnpm add @aws-sdk/client-securitylake
开始
导入
AWS SDK由客户端和命令进行调制.
要发送请求,只需导入 SecurityLakeClient 财务报告和审定财务报表
例如,您需要的命令 ListDataLakesCommand数字 :
// ES5 example
const { SecurityLakeClient, ListDataLakesCommand } = require("@aws-sdk/client-securitylake");
// ES6+ example
import { SecurityLakeClient, ListDataLakesCommand } from "@aws-sdk/client-securitylake";
使用量
发出请求:
- 以配置(如证书,区域)为客户端提供证据.
- 见 文件/中心 用于配置细节.
- 见 @aws- sdk/ 配置 附加选项.
- 以输入参数证明命令 .
- 打电话
send操作客户端,以输入方式提供命令对象.
const client = new SecurityLakeClient({ region: "REGION" });
const params = { /** input parameters */ };
const command = new ListDataLakesCommand(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"后缀.
SecurityLake 扩展 SecurityLakeClient 并额外支持所有操作,服务员, 和活人作为方法.
这种风格可能从JavaScript v2的AWS SDK中为您所熟悉.
如果你正在捆绑 AWS SDK, 我们建议只使用赤骨客户端(SecurityLakeClient) (中文(简体) ).
更多详情见博客文章:
javaScript 的 AWS SDK 模块包。 。 。 .
import { SecurityLake } from "@aws-sdk/client-securitylake";
const client = new SecurityLake({ region: "REGION" });
// async/await.
try {
const data = await client.listDataLakes(params);
// process data.
} catch (error) {
// error handling.
}
// Promises.
client
.listDataLakes(params)
.then((data) => {
// process data.
})
.catch((error) => {
// error handling.
});
// callbacks (not recommended).
client.listDataLakes(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-jsaWS 开发者博客. - 问个问题 叠叠流 并贴上标签
aws-sdk-js。 。 。 . - 加入 AWS JavaScript 社区 发光。 。 。 .
- 如果你发现你发现了一个虫子,请 打开一个问题。 。 。 .
为了测试您在Node.js中通用的JavaScript代码,浏览器和反应本地环境, 拜访我们 代码样本 repo。 。 。 .
捐款
此客户端代码是自动生成的. 任何修改在下次修改时都会被覆盖 @aws-sdk/client-securitylake 软件包正在更新.
为了帮助客户,你可以检查我们 生成客户端脚本。 。 。 .
许可证
此 SDK 分布于 Apache 许可证,2.0版本, (中文(简体) ), 更多信息见LICENSE.