Queries the following types of asset fingerprints: middleware, databases, and web services.

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 DescribePropertyScaDetail

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

Lang String No zh

The language of the content within the request and response. Default value: zh. Valid values:

  • zh: Chinese
  • en: English
Biz String No sca

The type of the asset fingerprint that you want to query. Default value: sca. Valid values:

  • sca: middleware
  • sca_database: database
  • sca_web: web service
Note If you do not specify this parameter, the default value sca is used, which indicates that middleware fingerprints are queried.
SearchItem String No name

The type of the search condition. Valid values:

  • name: the name of a database, middleware, or web service
  • type: the type of a database, middleware, or web service
Note You must specify both the SearchItem and SearchInfo parameters before you can query the asset fingerprints based on the specified name or type.
SearchInfo String No openssl

The search keyword. You must specify this parameter based on the value of the SearchItem parameter.

  • If the SearchItem parameter is set to name, you must enter the name of an asset fingerprint.
  • If the SearchItem parameter is set to type, you must enter the type of an asset fingerprint. Valid values:
    • system_service: system service
    • software_library: software library
    • docker_component: container component
    • database: database
    • web_container: web container
    • jar: JAR package
    • web_framework: web framework
Note You must specify both the SearchItem and SearchInfo parameters before you can query the asset fingerprints based on the specified name or type.
ScaName String No openssl

The name of the asset fingerprint that you want to query.

BizType String No system_service

The type of the middleware, database, or web service that you want to query. Valid values:

  • system_service: system service
  • software_library: software library
  • docker_component: container component
  • database: database
  • web_container: web container
  • jar: JAR package
  • web_framework: web framework
SearchItemSub String No version

The type of the subquery. Valid values:

  • port
  • pid
  • version
  • user
SearchInfoSub String No 1.0.2k

The search keyword of the subquery. You must specify this parameter based on the value of the SearchItemSub parameter.

  • If the SearchItemSub parameter is set to port, you must enter a port number.
  • If the SearchItemSub parameter is set to pid, you must enter a process ID (PID).
  • If the SearchItemSub parameter is set to version, you must enter the version of a database, middleware, or web service.
  • If the SearchItemSub parameter is set to user, you must enter a username.
Note The subquery is used to search for data of a specific database, middleware, or web service.
Remark String No 192.168

The search condition, such as a server name or an IP address.

Note Fuzzy match is supported.
Name Long No 1

The name of the middleware, database, or web service.

Note This parameter is deprecated. You can ignore it.
Uuid String No uuid-02ebabe7-1c19-ab****

The UUID of the server on which the middleware, database, or web service is run.

CurrentPage Integer No 1

The number of the page to return. Default value: 1.

PageSize Integer No 10

The number of entries to return on each page. Default value: 10.

Note We recommend that you do not leave this parameter empty.
ScaVersion String No 1.0.2k

The version of the middleware, database, or web service.

Port String No 68

The port on which the process listens.

User String No root

The user who runs the process.

Pid String No 756

The ID of the process.

ProcessStartedStart Long No 1641024565

The timestamp when the process starts. Unit: milliseconds.

ProcessStartedEnd Long No 1641110965

The timestamp when the process ends. Unit: milliseconds.

ScaNamePattern String No open

The name of the process.

Response parameters

Parameter Type Example Description
RequestId String F9146867-16C8-4AAB-BB4FB8C2A4

The ID of the request, which is used to locate and troubleshoot issues.

PageInfo Object

The pagination information.

CurrentPage Integer 1

The page number of the returned page.

PageSize Integer 20

The number of entries returned per page. Default value: 10.

TotalCount Integer 2

The total number of entries returned.

Count Integer 2

The number of entries returned on the current page.

Propertys Array of PropertySca

The details about asset fingerprints.

Type String library

The type of the middleware, database, or web service.

BizTypeDispaly String Software library

The name of the middleware, database, or web service type. Valid values:

  • System service
  • Software library
  • Container component
  • Database
  • Web container
  • JAR package
  • Web framework
ProcessStarted Long 1596539788

The timestamp when the process starts. Unit: milliseconds.

InternetIp String 47.42.XX.XX

The public IP address of the server on which the middleware, database, or web service is run.

ConfigPath String /etc/my.cnf

The path to the configuration file.

Pid String 756

The ID of the process.

Port String 68

The port on which the process listens.

Cmdline String /sbin/dhclient -H iz2zeflhhbtk8gtxzt087az -1 -q -lf /var/lib/dhclient/dhclient--eth0.lease -pf /var/run/dhclient-eth0.pid eth0

The command line.

BizType String software_library

The type of the middleware, database, or web service. Valid values:

  • system_service: system service
  • software_library: software library
  • docker_component: container component
  • database: database
  • web_container: web container
  • jar: JAR package
  • web_framework: web framework
ListenIp String 0.0.XX.XX

The IP address on which the process listens.

Version String 1.0.2k

The version of the middleware, database, or web service.

InstanceName String Test01

The name of the server on which the middleware, database, or web service is run.

ListenStatus String NONE

The listening status of the process. Valid values:

  • NONE
  • LISTEN
Name String openssl

The name of the middleware, database, or web service.

Create String 2020-08-21T13:30Z

The latest collection time, which indicates the last time when Security Center collected the information about the middleware, database, or web service.

Ip String 47.42.XX.XX

The public IP address of the server on which the middleware, database, or web service is run.

ProcessUser String root

The name of the user who runs the process.

InstanceId String i-2zeclqj7ti****

The instance ID of the server on which the middleware, database, or web service is run.

WebPath String /usr/share/nginx/html

The web directory.

Ppid String 1

The ID of the parent process.

IntranetIp String 192.210.XX.XX

The private IP address of the server on which the middleware, database, or web service is run.

Uuid String uuid-02ebabe7-1c19-a****

The UUID of the server on which the middleware, database, or web service is run.

ListenProtocol String UDP

The protocol of the traffic on which the process listens. Valid values:

  • UDP
  • TCP
ImageName String registry-vpc.cn-beijing.aliyuncs.com/acs/aliyun-ingress-controller****

The name of the image.

Path String /usr/lib64/libssl.so.1.0.2k

The path of the middleware, database, or web service.

ContainerName String 5-rce_web_1

The name of the container.

Proof String /usr/lib64/libssl.so.1.0.2k

The version verification of the middleware, database, or web service.

CreateTimestamp Long 1597987834000

The latest collection timestamp, which indicates the last timestamp when Security Center collected the information about the middleware, database, or web service. Unit: milliseconds.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribePropertyScaDetail
&Lang=zh
&Biz=sca
&SearchItem=name
&SearchInfo=openssl
&ScaName=openssl
&BizType=system_service
&SearchItemSub=version
&SearchInfoSub=1.0.2k
&Remark=192.168
&Name=1
&Uuid=uuid-02ebabe7-1c19-ab****
&CurrentPage=1
&PageSize=10
&ScaVersion=1.0.2k
&Port=68
&User=root
&Pid=756
&ProcessStartedStart=1641024565
&ProcessStartedEnd=1641110965
&ScaNamePattern=open
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribePropertyScaDetailResponse>
    <RequestId>F9146867-16C8-4AAB-BB4FB8C2A4</RequestId>
    <PageInfo>
        <CurrentPage>1</CurrentPage>
        <PageSize>20</PageSize>
        <TotalCount>2</TotalCount>
        <Count>2</Count>
    </PageInfo>
    <Propertys>
        <Type>library</Type>
        <BizTypeDispaly>Software library</BizTypeDispaly>
        <ProcessStarted>1596539788</ProcessStarted>
        <InternetIp>47.42.XX.XX</InternetIp>
        <ConfigPath>/etc/my.cnf</ConfigPath>
        <Pid>756</Pid>
        <Port>68</Port>
        <Cmdline>/sbin/dhclient -H iz2zeflhhbtk8gtxzt087az -1 -q -lf /var/lib/dhclient/dhclient--eth0.lease -pf /var/run/dhclient-eth0.pid eth0</Cmdline>
        <BizType>software_library</BizType>
        <ListenIp>0.0.XX.XX</ListenIp>
        <Version>1.0.2k</Version>
        <InstanceName>Test01</InstanceName>
        <ListenStatus>NONE</ListenStatus>
        <Name>openssl</Name>
        <Create>2020-08-21T13:30Z</Create>
        <Ip>47.42.XX.XX</Ip>
        <ProcessUser>root</ProcessUser>
        <InstanceId>i-2zeclqj7ti****</InstanceId>
        <WebPath>/usr/share/nginx/html</WebPath>
        <Ppid>1</Ppid>
        <IntranetIp>192.210.XX.XX</IntranetIp>
        <Uuid>uuid-02ebabe7-1c19-a****</Uuid>
        <ListenProtocol>UDP</ListenProtocol>
        <ImageName>registry-vpc.cn-beijing.aliyuncs.com/acs/aliyun-ingress-controller****</ImageName>
        <Path>/usr/lib64/libssl.so.1.0.2k</Path>
        <ContainerName>5-rce_web_1</ContainerName>
        <Proof>/usr/lib64/libssl.so.1.0.2k</Proof>
        <CreateTimestamp>1597987834000</CreateTimestamp>
    </Propertys>
</DescribePropertyScaDetailResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F9146867-16C8-4AAB-BB4FB8C2A4",
  "PageInfo" : {
    "CurrentPage" : 1,
    "PageSize" : 20,
    "TotalCount" : 2,
    "Count" : 2
  },
  "Propertys" : [ {
    "Type" : "library",
    "BizTypeDispaly" : "Software library",
    "ProcessStarted" : 1596539788,
    "InternetIp" : "47.42.XX.XX",
    "ConfigPath" : "/etc/my.cnf",
    "Pid" : "756",
    "Port" : "68",
    "Cmdline" : "/sbin/dhclient -H iz2zeflhhbtk8gtxzt087az -1 -q -lf /var/lib/dhclient/dhclient--eth0.lease -pf /var/run/dhclient-eth0.pid eth0",
    "BizType" : "software_library",
    "ListenIp" : "0.0.XX.XX",
    "Version" : "1.0.2k",
    "InstanceName" : "Test01",
    "ListenStatus" : "NONE",
    "Name" : "openssl",
    "Create" : "2020-08-21T13:30Z",
    "Ip" : "47.42.XX.XX",
    "ProcessUser" : "root",
    "InstanceId" : "i-2zeclqj7ti****",
    "WebPath" : "/usr/share/nginx/html",
    "Ppid" : "1",
    "IntranetIp" : "192.210.XX.XX",
    "Uuid" : "uuid-02ebabe7-1c19-a****",
    "ListenProtocol" : "UDP",
    "ImageName" : "registry-vpc.cn-beijing.aliyuncs.com/acs/aliyun-ingress-controller****",
    "Path" : "/usr/lib64/libssl.so.1.0.2k",
    "ContainerName" : "5-rce_web_1",
    "Proof" : "/usr/lib64/libssl.so.1.0.2k",
    "CreateTimestamp" : 1597987834000
  } ]
}

Error codes

HTTP status code Error code Error message Description
500 ServerError ServerError The error message returned because a server error occurred.

For a list of error codes, visit the API Error Center.