文档

API概览

更新时间:
本产品(云安全中心(响应编排)/2022-07-28)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(11370001915),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

剧本编排

API标题API概述
VerifyPythonFile校验python代码片段校验Python代码片段的语法是否正确。
VerifyPlaybook校验剧本配置校验剧本的配置是否正确,编排的逻辑是否合理。
TriggerSophonPlaybook触发剧本或响应命令用于触发运行剧本或响应命令。
TriggerPlaybook触发剧本用于触发已启用的自定义剧本或预定义剧本。
RunPython3Script运行python3脚本用于提交一段python3的代码片段并执行,只能用于数据处理。
RevertPlaybookRelease回滚剧本版本用于回滚剧本到指定的版本,同时可以指定回滚时是否发布该版本。
RenamePlaybookNode重命令节点命称用户在编排剧本过程中,使用该接口可重命名剧本中某一节点的名称,对该节点的引用路径也会随之改变。
QueryTreeData获取所有剧本的列表用于一次性获取所有的剧本列表。
PublishPlaybook发布剧本用于把剧本配置发布线上,发布后,剧本会以新的逻辑来运行。
ModifyPlaybookInstanceStatus修改剧本的启停状态用于修改剧本的启动与停止状态。
ModifyPlaybookInputOutput修改剧本的出入参数用于修改剧本的输入参数与输出参数。
ModifyPlaybook编辑剧本用于修改剧本的配置信息。
ModifyComponentAsset修改组件资产当一个组件需要配置资产时,该接口用户修改组件的资产信息。
DescriberPython3ScriptLogs获取pyhton脚本运行日志在提交pyhton脚本的任务后,通过返回的requestUuid来获取运行日志。
DescribeSophonCommands获取处置命令用于获取处置实体的命令。
DescribeSoarTaskAndActions获取剧本的组件执行记录用于获取剧本的一次运行过程中,组件的执行记录列表。
DescribeSoarRecords获取剧本执行记录用于获取剧本的执行记录列表。
DescribeSoarRecordInOutput获取组件运行时数据当用户执行剧本任务后,通过该接口可获取组件动作的输入数据与输出数据。
DescribeSoarRecordActionOutputList获取组件执行的输出数据列表用于获取剧本任务中,某一组件执行动作时,输出的数据列表。
DescribePopApiVersionList获取OpenAPI的版本列表用于获取某一云产品OpenAPI接口的版本信息。
DescribePopApiItemList获取OpenAPI的接口名称列表用于获取某一云产品OpenAPI接口的接口名称列表。
DescribePopApi获取OpenAPI接口详情用于获取OpenAPI的接口详情。
DescribePlaybooks获取剧本列表用于获取剧本列表。
DescribePlaybookReleases获取剧本发布的版本列表用于获取剧本发布的线上版本的信息列表。
DescribePlaybookNumberMetrics获取响应编排统计信息用于获取响应编排产品的统计信息,包含剧本数量、启用数量等内容。
DescribePlaybookNodesOutput获取组件输出的历史数据用于获取组件输出的历史数据。
DescribePlaybookMetrics获取剧本的元信息获取某一剧本的元信息,包括名字、描述、运行次数、失败率等。
DescribePlaybookInputOutput获取剧本的出入参数配置用于获取剧本的输入参数与输出参数的配置信息。
DescribePlaybook获取剧本配置用于获取剧本的xml配置信息。
DescribeNodeUsedInfos获取剧本节点的引用信息用于获取剧本中,某一节点正在被哪些节点引用。
DescribeNodeParamTags获取组件的推荐输入用于编排剧本时,组件输入的可引用路径。
DescribeLatestRecordSchema获取最新执行记录结构信息用于根据剧本最新一次的执行记录,动态生成剧本各节点的输出结构信息。
DescribeField获取全局配置信息用于获取产品全局的,通用的配置信息。
DescribeExecutePlaybooks获取可执行的剧本列表用于配置自动响应计划时,获取可执行的剧本列表。
DescribeEnumItems获取枚举信息用于获取产品需要的一些枚举信息。
DescribeDistinctReleases获取去重的版本列表获取去重后的剧本发布的版本信息列表。
DescribeComponentPlaybook获取预定义组件列表用于获取用户可以使用的预定义组件列表。
DescribeComponentList获取组件列表用于获取用户可使用的普通组件的列表。
DescribeComponentAssets获取组件的资产列表用于获取某一组件的资产信息列表。
DescribeComponentAssetForm获取组件资产元信息用于获取组件的资产元信息,即资产信息是由哪些字段组成的。
DescribeApiList获取OpenAPI列表用于获取OpenAPI的产品列表。
DeletePlaybook删除剧本用于删除指定的自定义剧本。
DeleteComponentAsset删除资产信息用于删除组件配置的资产信息。
DebugPlaybook调试剧本用于调试运行剧本。
ComparePlaybooks比较剧本版本信息用于比较发布的两个版本的剧本配置信息。
BatchModifyInstanceStatus批量修改剧本状态用于批量修改剧本的启用与停止状态。
CreatePlaybook创建剧本用于创建一个初始化的剧本。
DescribeComponentsJs获取组件的JS文件用于获取组件的JS文件,组件会以返回的JS文件来进行页面的渲染。

处置任务

API标题API概述
DescribeProcessTasks获取处置任务列表用户在使用响应编排的功能进行事件处置时,处置中心会生成相应的处置任务,该接口用于获取处置任务的列表信息。
TriggerProcessTask执行处置动作用户在使用响应编排的功能进行事件处置时,处置中心会生成相应的处置任务,该接口用于对生成的处置任务执行后续的解除封禁、重试封禁、解除隔离等动作。
  • 本页导读 (1)
文档反馈