Queries the cloud desktops in which vulnerabilities are detected.

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 DescribeDesktopIdsByVulNames

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

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
VulName.N RepeatList Yes oval:com.redhat.rhsa:def:20210348

The name of vulnerability N.

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

Response parameters

Parameter Type Example Description
DesktopItems Array of DesktopItem

Details about cloud desktops.

DesktopId String ecd-138dsptkrt00u****

The ID of the cloud desktop.

DesktopName String test

The name of the cloud desktop.

RequestId String 484256DA-D816-44D2-9D86-B6EE4D5BA78C

The ID of the request.

Examples

Sample requests

https://ecd.cn-hangzhou.aliyuncs.com/?Action=DescribeDesktopIdsByVulNames
&OfficeSiteId=cn-hangzhou+dir-363353****
&RegionId=cn-hangzhou
&Type=cve
&VulName.1=oval:com.redhat.rhsa:def:20210348
&<Common request parameters>

Sample success responses

XML format

<DescribeDesktopIdsByVulNames>
      <RequestId>484256DA-D816-44D2-9D86-B6EE4D5BA78C</RequestId>
      <DesktopItems>
            <DesktopName>test</DesktopName>
            <DesktopId>ecd-138dsptkrt00u****</DesktopId>
      </DesktopItems>
</DescribeDesktopIdsByVulNames>

JSON format

{
	"RequestId": "484256DA-D816-44D2-9D86-B6EE4D5BA78C",
	"DesktopItems": [{
		"DesktopName": "test",
		"DesktopId": "ecd-138dsptkrt00u****"
	}]
}