GetEntitiyStat - 查询实体计数

Updated at:

查询实体计数。

接口说明

入参 JsonConfig 是一个非常复杂的 JSON 配置,为此我们提供了辅助工具类帮助具体配置示例,请参考 Demo 。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-sas:GetEntitiyStat

get

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

IncidentUuid

string

是

事件 ID。

85ea4241-798f-4684-a876-65d4f0c3****

EntityType

string

否

事件关联的资产 ID。

6c740667-80b2-476d-8924-2e706feb****

AssetName

string

否

事件关联的资产 ID。

6c740667-80b2-476d-8924-2e706feb****

AssetUuid

string

否

事件关联的资产 ID。

6c740667-80b2-476d-8924-2e706feb****

EntityName

string

否

事件关联的资产 ID。

6c740667-80b2-476d-8924-2e706feb****

EntityUuid

string

否

事件关联的资产 ID。

6c740667-80b2-476d-8924-2e706feb****

IsAsset

string

否

事件关联的资产 ID。

6c740667-80b2-476d-8924-2e706feb****

IsMalwareEntity

string

否

事件列表排列方向。 取值:

  • desc:降序排列

  • asc:升序排列。

desc

Tags

string

否

实体标签。格式为 JSON 数组字符串:"[{"tagKey1":"tagValue1"},{"tagKey2":"tagValue2"}]"

sys:agent:dispose

RoleType

integer

否

0,单账号登录;1,全局视图;2,切换视图;3,局部视图

1

RoleFor

integer

否

管理员切换成其他成员视角的用户 ID。

1637941677243702

RegionId

string

否

威胁分析的数据管理中心所在地。您需要根据资产所在地域,选择管理中心所在地。取值:

  • cn-hangzhou:资产属于中国内地与中国香港

  • ap-southeast-1:资产属于海外地域

cn-hangzhou

EntityUuids

string

否

返回参数

名称

类型

描述

示例值

object

BaseResponse<List>

Data

array<object>

请求返回值。

123456

object

容量明细。

EntityType

string

实体类型

ip

EntityNum

integer

实体数量。

3

EntityUuid

string

实体 uuid

5cde2118666ffda40783ebd7cec9a60a

IncidentNum

integer

AlertNum

integer

Success

boolean

请求是否成功。取值:

  • true:成功

  • false:失败

true

Code

integer

请求状态码。

200

Message

string

请求返回消息。

success

RequestId

string

请求 id。

9AAA9ED9-78F4-5021-86DC-D51C7511****

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "EntityType": "ip",
      "EntityNum": 3,
      "EntityUuid": "5cde2118666ffda40783ebd7cec9a60a",
      "IncidentNum": 0,
      "AlertNum": 0
    }
  ],
  "Success": true,
  "Code": 200,
  "Message": "success",
  "RequestId": "9AAA9ED9-78F4-5021-86DC-D51C7511****"
}

错误码

HTTP status code

错误码

错误信息

描述

500 InternalError The request processing has failed due to some unknown error. 服务发生某些未知错误,请稍后再试

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。