Queries the details about detected vulnerabilities in cloud desktops within a workspace.

Description

After security protection is enabled, the system scans your cloud desktops for vulnerabilities once every day.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeGroupedVul

The operation that you want to perform. Set the value to DescribeGroupedVul.

OfficeSiteId String Yes cn-hangzhou+dir-363353****

The ID of the workspace.

RegionId String Yes cn-hangzhou

The ID of the region.

Type String Yes cve

The type of the vulnerability. Valid values:

  • cve: Linux software vulnerability
  • sys: Windows system vulnerability
Lang String No zh

The natural language of the request and response. Valid values:

  • zh: Chinese
  • en: English
Necessity String No asap

The priority to fix the vulnerability or the risk level of the vulnerability. Valid values:

  • asap: high
  • later: medium
  • nntf: low
Dealed String No y

The processing status of the vulnerability. Valid values:

  • y: handled
  • n: unhandled
CurrentPage Integer No 1

The number of the page to return.

Pages start from page 1.

Default value: 1.

PageSize Integer No 20

The maximum number of entries to return on each page.

Default value: 20.

Response parameters

Parameter Type Example Description
CurrentPage Integer 20

The maximum number of entries returned per page.

GroupedVulItems Array of GroupedVulItem

Details about vulnerabilities.

AliasName String RHSA-2019:0230-Important: polkit security update

The alias of the vulnerability.

AsapCount Integer 1

The number of high-risk vulnerabilities.

GmtLast String 1554185744000

The time when the vulnerability was last detected. The timestamp follows the UNIX time format. It is the number of milliseconds that have elapsed since 00:00:00 Thursday, January 1, 1970.

HandledCount Integer 0

The number of vulnerabilities processed.

LaterCount Integer 1

The number of medium-risk vulnerabilities.

Name String ***glibc security and bug fixes

The name of the vulnerability.

NntfCount Integer 0

The number of low-risk vulnerabilities.

Tags String Force restart

The tags of the vulnerability.

Type String cve

The type of the vulnerability. Valid values:

  • cve: Linux software vulnerability
  • sys: Windows system vulnerability
PageSize Integer 1

The page number of the returned page.

RequestId String 0DFCADBA-7065-42DA-AF17-6868B9C2A8CF

The ID of the request.

TotalCount Integer 2

The total number of entries returned.

Examples

Sample requests

https://ecd.cn-hangzhou.aliyuncs.com/?Action=DescribeGroupedVul
&OfficeSiteId=cn-hangzhou+dir-363353****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeGroupedVulResponse>
      <TotalCount>2</TotalCount>
      <PageSize>1</PageSize>
      <RequestId>0DFCADBA-7065-42DA-AF17-6868B9C2A8CF</RequestId>
      <CurrentPage>20</CurrentPage>
      <GroupedVulItems>
            <Type>cve</Type>
            <LaterCount>1</LaterCount>
            <GmtLast>1554185744000</GmtLast>
            <HandledCount>0</HandledCount>
            <AliasName>RHSA-2019:0230-Important: polkit security update</AliasName>
            <AsapCount>1</AsapCount>
            <NntfCount>0</NntfCount>
            <Tags> Force restart </Tags>
            <Name>***glibc security and bug fixes </Name>
      </GroupedVulItems>
</DescribeGroupedVulResponse>

JSON format

{
    "TotalCount": "2",
    "PageSize": "1",
    "RequestId": "0DFCADBA-7065-42DA-AF17-6868B9C2A8CF",
    "CurrentPage": "20",
    "GroupedVulItems": [{
        "Type": "cve",
        "LaterCount": "1",
        "GmtLast": "1554185744000",
        "HandledCount": "0",
        "AliasName": "RHSA-2019:0230-Important: polkit security update",
        "AsapCount": "1",
        "NntfCount": "0",
        "Tags": "Force restart",
        "Name": "***glibc security and bug fixes"
    }]
}