集成指南 › Web 服务 API 参考指南 › CA AppLogic API 的有效对象 › iface 对象 › info 方法（iface 对象）

info 方法（iface 对象）

说明

检索组件接口的信息

语法

/api/v1/iface/info?app=application&comp=component&iface=interface&vdc=controller-name 

参数

app

应用的名称

comp

组件的名称

iface

接口的名称

vdc

目标虚拟数据中心的名称

事务类型

同步

请求类型

GET

示例

检索 sugarcrm:main.srv1 的 in 终端的信息。

GET http://192.168.123.200/api/v1/iface/info?app=sugarcrm&comp=main.srv1&iface=in&vdc=mygrid 

样例输出

XML：

<interface>
   <name>in</name>
   <connections>
       <name>connections[0]</name>
      <loc_addr>F2640A00361E0000</loc_addr>
       <loc_ip>10.80.54.18</loc_ip>
      <rem_addr>F2640A0036350000</rem_addr>
       <rem_ip>10.80.54.17</rem_ip>
      <type>None</type>
    </connections>
    <device>eth0</device>
   <ip>10.80.54.18</ip>
   <mac>F2:64:0A:00:36:1E</mac>
   <state>active</state>
   <type>input</type>
</interface>

JSON：

{   "connections" : {
       "connections[0]" : {
         "loc_ip" : "10.80.54.18",
         "rem_addr" : "F2640A0036350000",
         "rem_ip" : "10.80.54.17",
         "type" : "None",
         "loc_addr" : "F2640A00361E0000"
      }
   },
   "ip" : "10.80.54.18",
   "name" : "in",
   "type" : "input",
   "mac" : "F2:64:0A:00:36:1E",
   "device" : "eth0",
   "state" : "active"
} 

HTTP 错误代码

404

未找到实体 vdc mygrid－WS_API 应用中没有配置指定的 VDC 名称。

400.4

缺少必需参数 (app)。 －请求中缺少参数 app=app。

400.4

缺少必需参数 (comp)。 －请求中缺少参数 comp=comp。

400.4

缺少必需参数 (iface)。 －请求中缺少参数 iface=iface。

404.1

无法显示接口 test:main.vpn.ctl 的信息－它不存在。 －请求中指定的接口、应用或组件无效或应用处于停止状态。

404.1

无法显示接口 test:main.srv 的信息－获取信息失败－有关详细信息，请参阅日志。 －请求中指定的组件未运行。