获取安装云监控插件的主机列表。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

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

系统规定参数。取值:DescribeMonitoringAgentHosts。

HostName String hostNam1

主机名称。

InstanceIds String i-a3d1q1pm2f9yr29e****

实例ID。

InstanceRegionId String cn-hangzhou

实例的regionId。

KeyWord String host1

模糊搜索关键字。

PageNumber Integer 1

页数。

PageSize Integer 10

每页显示记录条数。

SerialNumbers String a1ab31a3-1234-40f2-9e95-c8caa8f0****

序列号搜索。

返回参数

名称 类型 示例值 描述
Code String 200

状态码,200表示成功。

Hosts

主机列表。

  └AgentVersion String 2.1.55

插件版本。

  └AliUid Long 123456

阿里云云账号ID。

  └EipAddress String 22.22.XX.XX

EIP地址。

  └EipId String xxx

EIP的ID。

  └HostName String hostIP

主机名称。

  └InstanceId String i-a2d5q7pm3f9yr212****

实例ID。

  └InstanceTypeFamily String ecs.n4

ECS 实例规格。

  └IpGroup String 12.23.XX.XX

IP地址,多个地址逗号分隔。

  └NatIp String 22.22.XX.XX

NAT IP。

  └NetworkType String vpc

网络类型。

  └OperatingSystem String Linux

操作系统。

  └Region String cn-hangzhou

地域。

  └SerialNumber String x12335-6cc8-4a22-9f21-1a00a719****

序列号。

  └isAliyunHost Boolean true

是否是阿里云主机 。

Message String Successfully

错误信息。

PageTotal Integer 50

页数。

RequestId String 63EEBB2A-9E51-41E4-9E83-5DE7F3B292E0

请求ID。

Success Boolean true

是否成功。

Total Integer 10

总记录条数。

示例

请求示例


http(s)://[Endpoint]/?Action=DescribeMonitoringAgentHosts
&<公共请求参数>

正常返回示例

XML 格式

<DescribeMonitoringAgentHostsResponse>
  <PageTotal>1</PageTotal>
  <PageNumber>1</PageNumber>
  <PageSize>100</PageSize>
  <Hosts>
    <Host>
      <AgentVersion>2.1.55</AgentVersion>
      <SerialNumber>x12335-6cc8-4a22-9f21-1a00a719****</SerialNumber>
      <NetworkType>vpc</NetworkType>
      <Region>ap-south-1</Region>
      <InstanceTypeFamily>ecs.n4</InstanceTypeFamily>
      <isAliyunHost>true</isAliyunHost>
      <IpGroup>12.23.XX.XX</IpGroup>
      <AliUid>127067667954****4</AliUid>
      <InstanceId>i-a2d5q7pm3f9yr29e****</InstanceId>
      <OperatingSystem>Linux</OperatingSystem>
      <HostName>sitemonitor-mengmai-1</HostName>
    </Host>
  </Hosts>
  <Success>true</Success>
  <Code>200</Code>
  <Total>2</Total>
</DescribeMonitoringAgentHostsResponse>

JSON 格式

{
	"PageTotal":1,
	"PageNumber":1,
	"PageSize":100,
	"Hosts":{
		"Host":[
			{
				"SerialNumber":"x12335-6cc8-4a22-9f21-1a00a719****",
				"AgentVersion":"2.1.55",
				"NetworkType":"vpc",
				"Region":"ap-south-1",
				"IpGroup":"12.23.XX.XX",
				"isAliyunHost":true,
				"InstanceTypeFamily":"ecs.n4",
				"AliUid":"127067667954****",
				"InstanceId":"i-a2d5q7pm3f9yr212****",
				"OperatingSystem":"Linux",
				"HostName":"sitemonitor-mengmai-1"
			}
		]
	},
	"Success":true,
	"Code":200,
	"Total":2
}

错误码

查看本产品错误码