All Products
Search
Document Center

Security Center:DescribePropertySoftwareDetail

Last Updated:Jan 20, 2026
This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

Query details of asset fingerprint software collection

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:
    • For mandatory resource types, indicate with a prefix of * .
    • 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:DescribePropertySoftwareDetailget
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
RemarkstringNo

The name or IP address of the server to be queried.

192.168.XX.XX
NamestringNo

The name of the software to be queried.

kernel
PathstringNo

The installation path of the software.

/etc/test
SoftwareVersionstringNo

The version information of the software.

3.10.0
UuidstringNo

The UUID of the server.

50d213b4-3a35-427a-b8a5-****
CurrentPageintegerNo

Set which page of the returned results to start displaying the query results. The default value is 1, indicating that the display starts from the first page.

1
PageSizeintegerNo

Set the number of software asset fingerprint information items displayed per page during pagination. The default value is 10, indicating that 10 items of software asset fingerprint information are displayed per page.

10
InstallTimeStartlongNo

The timestamp when the software update started. Unit: milliseconds.

1649321495000
InstallTimeEndlongNo

The timestamp when the software update ended. Unit: milliseconds.

1650012695000
ExtendstringNo

Whether the software name supports fuzzy search. To enable fuzzy search, set the value of this parameter to 1; other values or an empty value indicate that fuzzy search is not supported.

1
UseNextTokenbooleanNo

Whether to use the NextToken method to pull asset list data. If this parameter is used, TotalCount will no longer be returned. Values:

  • true: Use the NextToken method.
  • false: Do not use the NextToken method.
true
NextTokenstringNo

Used to mark the starting position for reading. Leave it blank to start from the beginning.

Note For the first call, you do not need to fill this in; the response will include the NextToken for the second call, and each subsequent call's response will contain the NextToken for the next call.
E17B501887A2D3AA5E8360A6EFA3B***

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the current request, generated by Alibaba Cloud as a unique identifier for the request, which can be used for troubleshooting and problem localization.

6AEE7412-0065-1135-B790-AE2C38BA68FB
PageInfoobject

Information displayed on the query result page.

CurrentPageinteger

The page number of the current page during pagination.

1
PageSizeinteger

The number of software asset fingerprint information displayed per page when performing a paginated query. The default value is 10, indicating that 10 pieces of software asset fingerprint information are displayed per page.

10
TotalCountinteger

The total number of fingerprint information for the queried software assets.

1
Countinteger

The number of fingerprint information of software assets displayed on the current page.

1
NextTokenstring

The NextToken value returned using the NextToken method.

B604532DEF982B875E8360A6EFA3B***
Propertysarray<object>

Details list of the queried software asset's fingerprint information.

PropertySoftwareobject

Details list of the fingerprint information of the queried software assets.

InternetIpstring

The public IP address of the server.

192.168.XX.XX
Ipstring

List of server IPs

192.168.XX.XX
InstanceIdstring

The instance ID of the server.

i-hp35tftuh52wbp1g****
IntranetIpstring

The private IP address of the server.

100.104.XX.XX
InstallTimestring

The installation time of the software.

2022-04-07 10:54:49
Uuidstring

The UUID of the server.

162eb349-c2d9-4f8b-805c-75b43d4c****
Versionstring

The version information of the software asset.

3.10.0
InstanceNamestring

The name of the server instance.

hc-host-****
Pathstring

The installation directory information of the software asset.

/etc/test
Namestring

The name of the software.

aaa_base
CreateTimestamplong

The timestamp of the latest scan of the asset fingerprint. The unit is milliseconds.

1649149566000
InstallTimeDtlong

The installation timestamp of the software. The unit is in milliseconds.

1649066826000

Examples

Sample success responses

JSONformat

{
  "RequestId": "6AEE7412-0065-1135-B790-AE2C38BA68FB",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 10,
    "TotalCount": 1,
    "Count": 1,
    "NextToken": "B604532DEF982B875E8360A6EFA3B***"
  },
  "Propertys": [
    {
      "InternetIp": "192.168.XX.XX",
      "Ip": "192.168.XX.XX",
      "InstanceId": "i-hp35tftuh52wbp1g****",
      "IntranetIp": "100.104.XX.XX",
      "InstallTime": "2022-04-07 10:54:49",
      "Uuid": "162eb349-c2d9-4f8b-805c-75b43d4c****",
      "Version": "3.10.0",
      "InstanceName": "hc-host-****",
      "Path": "/etc/test",
      "Name": "aaa_base",
      "CreateTimestamp": 1649149566000,
      "InstallTimeDt": 1649066826000
    }
  ]
}

Error codes

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

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

Change history

Change timeSummary of changesOperation
2025-12-12The Error code has changed. The request parameters of the API has changed. The response structure of the API has changedView Change Details
2022-01-05The request parameters of the API has changed. The response structure of the API has changedView Change Details