All Products
Search
Document Center

Security Center:GetDataTrend

Last Updated:Oct 24, 2024

Queries the security operations trends of the vulnerabilities, alerts, and baseline risks.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
yundun-sas:GetDataTrendget
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
BizTypesstringYes

The type of the security data that you want to query. Valid values:

  • HC_NEW: the number of new baseline risks.
  • HC_OPERATE: the number of handled baseline risks.
  • VUL_NEW: the number of new vulnerabilities.
  • VUL_OPERATE: the number of handled vulnerabilities.
  • SUSP_NEW: the number of new alerts.
  • SUSP_OPERATE: the number of handled alerts.
HC_NEW,HC_OPERATE
StartTimestamplongYes

The beginning of the time range to query. The value is a UNIX timestamp. Unit: milliseconds.

1687334501000
EndTimestamplongYes

The end of the time range to query. The value is a UNIX timestamp. Unit: milliseconds.

1721923200000
IntervalintegerYes

The interval of the data that you want to query. Unit: milliseconds.

Note The minimum value is 1000.
86400000

Response parameters

ParameterTypeDescriptionExample
object

PlainResult

Dataobject

The response parameters.

DateListarray

The statistical timestamps of the trend data.

DateListinteger

The statistical timestamp of the trend data. Unit: seconds.

1721404800
DateStrListarray

The statistical dates and time for the trend data.

DateStrListstring

The statistical time and date of the trend data.

Note The value is in the yyyy-MM-dd HH:mm:ss format.
2024-01-01 00:00:00
ItemListarray<object>

The returned data.

ItemListobject

The returned data.

KeyNamestring

The type of the security data. Valid values:

  • HC_NEW: the number of new baseline risks.
  • HC_OPERATE: the number of handled baseline risks.
  • VUL_NEW: the number of new vulnerabilities.
  • VUL_OPERATE: the number of handled vulnerabilities.
  • SUSP_NEW: the number of new alerts.
  • SUSP_OPERATE: the number of handled alerts.
HC_NEW
CountListarray

The statistical values of the trend data.

CountListlong

The statistical value of the trend data.

10
RequestIdstring

The request ID.

1383B0DB-D5D6-4B0C-9E6B-75939C8E****

Examples

Sample success responses

JSONformat

{
  "Data": {
    "DateList": [
      1721404800
    ],
    "DateStrList": [
      "2024-01-01 00:00:00"
    ],
    "ItemList": [
      {
        "KeyName": "HC_NEW",
        "CountList": [
          10
        ]
      }
    ]
  },
  "RequestId": "1383B0DB-D5D6-4B0C-9E6B-75939C8E****"
}

Error codes

HTTP status codeError codeError messageDescription
400IllegalParamIllegal param-
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.