调用DescribeFieldStatistics接口查询您资产中服务器的统计信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeFieldStatistics

需要执行的操作。

取值：DescribeFieldStatistics。

MachineTypes String 否 ecs

指定要查询的资产类型。不指定资产类型，即查询所有类型资产的统计信息。取值：

  • ecs：服务器
  • cloud_product：云产品

调用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
	}
}

错误码

访问错误中心查看更多错误码。