GetClientInstallationStatistic - Security Center - Alibaba Cloud Documentation Center

This API is deprecated. You are advised to use Sas(2018-12-03) - GetClientRatioStatistic.

Queries the installation rate of the client on cloud assets in the specified period of time.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
TimeStart	long	Yes	The timestamp that specifies the beginning of the time range to collect statistics. Unit: millisecond.	1687104000000
TimeEnd	long	Yes	The timestamp that specifies the end of the time range to collect statistics. Unit: millisecond.	1687708800000

Response parameters

Parameter	Type	Description	Example
	object	The returned data.
RequestId	string	The request ID.	F62DD457-2588-589A-B1F6-A1245895D2AB
ClientInstallRatio	object	The statistics on the client installation rate.
HistoryItems	object []	The historical statistics on the installation rate of the agent.
Vendor	long	The type of the cloud asset. Valid values: 0: a cloud asset provided by Alibaba Cloud. 1: a third-party cloud asset 2: an asset in a data center 3, 4, 5, and 7: other cloud asset 8: a lightweight cloud asset	4
Items	object []	The statistics on the client installation rate.
CalculateTime	long	The timestamp of the calculation. Unit: millisecond.	1687759630045
AssetTotalCount	integer	The total number of cloud assets.	100
InstallRatio	double	The installation rate. Unit: %.	80.00
InstalledAssetCount	integer	The number of cloud assets on which the client is installed.	80
CurrentItems	object []	The current statistics on the installation rate of the client.
Vendor	long	The type of the cloud asset. Valid values: 0: a cloud asset provided by Alibaba Cloud. 1: a third-party cloud asset 2: an asset in a data center 3, 4, 5, and 7: other cloud asset 8: a lightweight cloud asset	7
Items	object []	The current statistics on the installation rate of the client.
CalculateTime	long	The timestamp of the calculation. Unit: millisecond.	1687759630045
AssetTotalCount	integer	The total number of cloud assets.	100
InstallRatio	double	The installation rate. Unit: %.	70.00
InstalledAssetCount	integer	The number of assets on which the client is installed.	70
Dates	array	The time when statistics were collected.
	long	The time when statistics were collected. Unit: millisecond.	1687104000000

Examples

Sample success responses

JSONformat

{
  "RequestId": "F62DD457-2588-589A-B1F6-A1245895D2AB",
  "ClientInstallRatio": {
    "HistoryItems": [
      {
        "Vendor": 4,
        "Items": [
          {
            "CalculateTime": 1687759630045,
            "AssetTotalCount": 100,
            "InstallRatio": 80,
            "InstalledAssetCount": 80
          }
        ]
      }
    ],
    "CurrentItems": [
      {
        "Vendor": 7,
        "Items": [
          {
            "CalculateTime": 1687759630045,
            "AssetTotalCount": 100,
            "InstallRatio": 70,
            "InstalledAssetCount": 70
          }
        ]
      }
    ],
    "Dates": [
      1687104000000
    ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	IllegalParam	Illegal param	-
400	NotBuy	user not buy service	User not buy service.
403	NoPermission	caller has no permission	You are not authorized to do this operation.
500	ServerError	ServerError	-

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