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

错误码

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