DescribeChartData - 查询安全日报图表统计数据_云安全中心(Security Center)-阿里云帮助中心

查询安全报告中配置图表的统计数据。

调试

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

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
yundun-sas:DescribeChartData	none	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
CharId	string	否	图表 ID。说明调用 DescribeChartList 接口获取该参数。报告版本为 1.0.0 必填。	CID_ASSET_RISK_TREND
TimeStart	long	否	统计起始时间戳。单位：毫秒。	1683603086000
TimeEnd	long	否	统计结束时间戳。单位：毫秒。	1683862286000
Lang	string	否	设置请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	zh
ReportId	long	否	报表 ID。说明调用 DescribeCustomizeReportList 接口获取该参数。	721734
ChartId	string	否	图表 ID。说明调用 DescribeChartList 接口获取该参数。报告版本为 2.0.0 必填。	CID_VUL_SUMMARY

返回参数

名称	类型	描述	示例值
	object
PropertyValue	string	图表中的属性值。	{'totalCount': '0'}
ProperyArrayValue	string	图表的属性数组。	[]
ChartType	string	图表类型。取值： timeLine：时间轴线图 timeBar：时间轴柱状图 bar：柱状图 line：线图 pie：饼图 gauge：测量图 table：表格 text：文本	timeBar
ChartDataType	string	图表数据类型。取值： commonCoordinate：普通坐标 timeCoordinate：时间轴坐标 multipleValue：多值 singleValue：单值 propertyValue：属性值 propertyArrayValue：数组属性值	propertyArrayValue
CoordinateData	object	坐标数据。
YAxisList	array<object>	纵轴值列表。
YAxisDo	object	纵轴值。
Type	string	数据类型。	high
Name	string	数据类型名称。	Port
Value	array	各横坐标点对应的纵坐标的值。
LongItem	string	横坐标点对应的纵坐标的值。	1
SubType	string	图表子类型数据。	CID_SUSPICIOUS_TREND-AL
XAxis	array	横坐标值列表。
StringItem	string	横坐标值。	2024-01-01
SingleData	object	单值图数据。
Type	string	数据类型。	suspicious
Value	long	单值图的数据值。	172
Name	string	数据类型名称。	suspicious
MultipleData	array<object>	多值图数据。
MultipleDataItem	object	多值图。
Type	string	数据类型。	safe
Value	long	属性值。	0
Color	string	字体颜色，十六进制颜色码 RGBA。	#FFA800
Name	string	数据类型名称。	Safety
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	50CCE62A-2BC4-5CF8-B976-E4F62A31****
ChartSubTypeList	array	选择的图表子类型值列表。
ChartSubType	string	选择的图表子类型值。	["CID_VUL_TREND-CVE", "CID_VUL_TREND-SYS", "CID_VUL_TREND-CMS", "CID_VUL_TREND-APP", "CID_VUL_TREND-EMG"]
AllChartSubTypeList	array<object>	该图表所有子类型可选择值。
AllChartSubType	object
SubType	string	图表子类型。	CID_SUSPICIOUS_TREND-ALL
SubTypeName	string	图表子类型名称。	All Alerts
PropertyArrayValue	string	数组图表属性值。	[]

示例

正常返回示例

JSON格式

{
  "PropertyValue": "{'totalCount': '0'}",
  "ProperyArrayValue": "[]",
  "ChartType": "timeBar",
  "ChartDataType": "propertyArrayValue",
  "CoordinateData": {
    "YAxisList": [
      {
        "Type": "high",
        "Name": "Port",
        "Value": [
          "1"
        ],
        "SubType": "CID_SUSPICIOUS_TREND-AL"
      }
    ],
    "XAxis": [
      "2024-01-01"
    ]
  },
  "SingleData": {
    "Type": "suspicious",
    "Value": 172,
    "Name": "suspicious"
  },
  "MultipleData": [
    {
      "Type": "safe",
      "Value": 0,
      "Color": "#FFA800",
      "Name": "Safety"
    }
  ],
  "RequestId": "50CCE62A-2BC4-5CF8-B976-E4F62A31****",
  "ChartSubTypeList": [
    "[\"CID_VUL_TREND-CVE\", \"CID_VUL_TREND-SYS\", \"CID_VUL_TREND-CMS\", \"CID_VUL_TREND-APP\", \"CID_VUL_TREND-EMG\"]"
  ],
  "AllChartSubTypeList": [
    {
      "SubType": "CID_SUSPICIOUS_TREND-ALL",
      "SubTypeName": "All Alerts"
    }
  ],
  "PropertyArrayValue": "[]"
}

错误码

HTTP status code	错误码	错误信息	描述
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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