调用DescribeFieldStatistics接口查询您资产中服务器的统计信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeFieldStatistics |
需要执行的操作。 取值:DescribeFieldStatistics。 |
MachineTypes | String | 否 | ecs |
指定要查询的资产类型。不指定资产类型,即查询所有类型资产的统计信息。取值:
|
调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数。
调用API的请求格式,请参见本文示例中的请求示例。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
GroupedFields | Struct |
资产信息。 |
|
GeneralAssetCount | Integer | 10 |
一般资产数量。 |
GroupCount | Integer | 20 |
服务器组数量。 |
ImportantAssetCount | Integer | 10 |
重要资产数量。 |
InstanceCount | Integer | 100 |
您查询时指定的资产类型下的所有资产数量。如果查询时没有指定资产类型,此处的数量是您资产中所有服务器和云产品的数量之和。 |
NewInstanceCount | Integer | 10 |
新增服务器数量。 |
NotRunningStatusCount | Integer | 10 |
未启动(未开机)的服务器数量。 |
OfflineInstanceCount | Integer | 21 |
离线服务器的数量。 |
RegionCount | Integer | 11 |
服务器所属的地域数量。 |
RiskInstanceCount | Integer | 90 |
存在风险的资产数量。 |
TestAssetCount | Integer | 10 |
测试资产数量。 |
UnprotectedInstanceCount | Integer | 10 |
未受保护的资产数量。 |
VpcCount | Integer | 5 |
专有网络VPC数量。 |
RequestId | String | 7E0618A9-D5EF-4220-9471-C42B5E92719F |
阿里云为该请求生成的唯一标识符。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeFieldStatistics
&<公共请求参数>
正常返回示例
XML
格式
<DescribeFieldStatisticsResponse>
<RequestId>988AF6BE-4823-436D-8339-4D9ADF7DFEB6</RequestId>
<GroupedFields>
<InstanceCount>200</InstanceCount>
<OfflineInstanceCount>67</OfflineInstanceCount>
<VpcCount>26</VpcCount>
<GroupCount>43</GroupCount>
<RiskInstanceCount>106</RiskInstanceCount>
<RegionCount>27</RegionCount>
<NotRunningStatusCount>23</NotRunningStatusCount>
<ImportantAssetCount>11</ImportantAssetCount>
<GeneralAssetCount>179</GeneralAssetCount>
<NewInstanceCount>11</NewInstanceCount>
<TestAssetCount>10</TestAssetCount>
<UnprotectedInstanceCount>68</UnprotectedInstanceCount>
</GroupedFields>
</DescribeFieldStatisticsResponse>
JSON
格式
{
"RequestId": "988AF6BE-4823-436D-8339-4D9ADF7DFEB6",
"GroupedFields": {
"InstanceCount": 200,
"OfflineInstanceCount": 67,
"VpcCount": 26,
"GroupCount": 43,
"RiskInstanceCount": 106,
"RegionCount": 27,
"NotRunningStatusCount": 23,
"ImportantAssetCount": 11,
"GeneralAssetCount": 179,
"NewInstanceCount": 11,
"TestAssetCount": 10,
"UnprotectedInstanceCount": 68
}
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交