@aws- sdk/ 客户端检测
说明
JavaScript Detective客户端的 AWS SDK 为Node.js, 浏览器和React Introduct 服务.
探长用机器学习和有目的的可视化帮助你 分析并调查整个亚马逊网络服务(Amazon Web Services)工作量的安全问题。 侦探自动提取基于时间的事件 作为登录尝试,API呼叫,以及来自CloudTrail和Amazon虚拟私人云(Amazon VPC)的网络流量流日志. 它还提取了由下列人员发现的发现: 亚马逊卫视.
侦探API主要支持行为的创建和管理 图表。 行为图包含从一组成员账户中提取的数据,并且 由管理员账户创建和管理.
要在行为图中添加一个成员账户,管理员账户发送一个 请访问账户。 账户接受邀请后成为成员 行为图中的账户.
侦探也融入了组织. 二. 本组织 管理账户指定该账户的侦探管理员账户 组织。 该账户成为管理者账户 组织行为 图表。 侦探管理员账户也是委托管理员 组织警探的账户.
侦探管理员账户可以启用任何组织账户作为 组织行为图中的成员账户. 本组织账户没有收到 请柬。 侦探管理员账户也可以邀请其他账户访问 组织行为图.
每个行为图都是针对一个地区 您只能使用 API 来管理 属于当前选中区域的行为图 终点.
一个行为图的管理员账户可以使用侦探 API 来完成 目标如下:
-
启用和禁用侦探。 启用侦探创建新 行为图.
-
在行为图中查看成员账户列表.
-
在行为图中加入成员账户.
-
从行为图中删除成员账户.
-
将标记应用到行为图中 .
组织管理账户可以使用侦探API来选择 委托给警探的管理员.
一个组织的"侦探管理员"账户可以使用"侦探API"来完成以下工作:
-
履行管理员账户的所有功能.
-
确定是否作为成员自动启用新的组织账户 组织行为图中的账户.
受邀成员账户可以使用"侦探API"来完成以下工作:
-
查看所邀请的行为图列表 .
-
接受邀请为行为图投稿.
-
拒绝向行为图投稿的邀请 .
-
从行为图中删除他们的账户 .
所有API动作都被记录为CloudTrail事件. 见 用 CloudTrail 登录侦探 API 呼叫。 。 。 .
我们把"总账"改为"行政账". 一个 管理员账户用于集中管理多个账户. 就 探长 管理员账户管理着他们的行为 图表.
安装
要安装此软件包, 请使用您最喜欢的软件包管理器的 CLI :
npm install @aws-sdk/client-detectiveyarn add @aws-sdk/client-detectivepnpm add @aws-sdk/client-detective
开始
导入
AWS SDK由客户端和命令进行调制.
要发送请求,只需导入 DetectiveClient 财务报告和审定财务报表
例如,您需要的命令 ListGraphsCommand数字 :
// ES5 example
const { DetectiveClient, ListGraphsCommand } = require("@aws-sdk/client-detective");
// ES6+ example
import { DetectiveClient, ListGraphsCommand } from "@aws-sdk/client-detective";
使用量
发出请求:
- 以配置(如证书,区域)为客户端提供证据.
- 见 文件/中心 用于配置细节.
- 见 @aws- sdk/ 配置 附加选项.
- 以输入参数证明命令 .
- 打电话
send操作客户端,以输入方式提供命令对象.
const client = new DetectiveClient({ region: "REGION" });
const params = { /** input parameters */ };
const command = new ListGraphsCommand(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"后缀.
Detective 扩展 DetectiveClient 并额外支持所有操作,服务员, 和活人作为方法.
这种风格可能从JavaScript v2的AWS SDK中为您所熟悉.
如果你正在捆绑 AWS SDK, 我们建议只使用赤骨客户端(DetectiveClient) (中文(简体) ).
更多详情见博客文章:
javaScript 的 AWS SDK 模块包。 。 。 .
import { Detective } from "@aws-sdk/client-detective";
const client = new Detective({ region: "REGION" });
// async/await.
try {
const data = await client.listGraphs(params);
// process data.
} catch (error) {
// error handling.
}
// Promises.
client
.listGraphs(params)
.then((data) => {
// process data.
})
.catch((error) => {
// error handling.
});
// callbacks (not recommended).
client.listGraphs(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-detective 软件包正在更新.
为了帮助客户,你可以检查我们 生成客户端脚本。 。 。 .
许可证
此 SDK 分布于 Apache 许可证,2.0版本, (中文(简体) ), 更多信息见LICENSE.