ListAgent - 列举代理_在线迁移服务(Data Online Migration )-阿里云帮助中心

列举用户在该区域下的代理。

接口说明

列举代理，您必须有 mgw:ListImportAgent 权限。

授权信息

当前API暂无授权信息透出。

请求语法

GET /agentlist HTTP/1.1
Host: userid.cn-hangzhou.mgw.aliyuncs.com

请求参数

名称	类型	必填	描述	示例值
marker	string	否	设定从该 marker 之后列举代理。默认值：无	test_agent
count	integer	否	指定返回代理的数量。取值：大于 0 小于等于 1000 默认值：1000	100

返回参数

名称	类型	描述	示例值
	object	列举代理的响应体。
ImportAgentList	ListAgentResp	代理列表详情。

示例

正常返回示例

JSON格式

{
  "ImportAgentList": {
    "Truncated": true,
    "NextMarker": "test_next_marker",
    "ImportAgent": [
      {
        "Owner": "test_owner",
        "Name": "test_name",
        "CreateTime": "2024-05-01T12:00:00.000Z",
        "ModifyTime": "2024-05-01T12:00:00.000Z",
        "DeployMethod": "default",
        "AgentEndpoint": "vpc",
        "ActivationKey": "6af62558-970d-4f44-8663-4e297170fd6a",
        "Tags": "K1:V1,K2:V2",
        "Version": "test_agent_id",
        "TunnelId": "test_tunnel_id"
      }
    ]
  }
}

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ImportAgentList>
  <Truncated>true</Truncated>
  <NextMarker>test_next_marker</NextMarker>
  <ImportAgent>
    <Owner>test_owner</Owner>
    <Name>test_name</Name>
    <CreateTime>2024-05-01T12:00:00.000Z</CreateTime>
    <ModifyTime>2024-05-01T12:00:00.000Z</ModifyTime>
    <DeployMethod>default</DeployMethod>
    <AgentEndpoint>vpc</AgentEndpoint>
    <ActivationKey>6af62558-970d-4f44-8663-4e297170fd6a</ActivationKey>
    <Tags>K1:V1,K2:V2</Tags>
    <Version>test_agent_id</Version>
    <TunnelId>test_tunnel_id</TunnelId>
  </ImportAgent>
</ImportAgentList>

错误码

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