Metodo list (oggetto iface)

Guide di integrazione › Guida di riferimento API del servizio Web › Oggetti validi per l'API di CA AppLogic › Oggetto iface › Metodo list (oggetto iface)

Metodo list (oggetto iface)

Description

Recupera un elenco di interfacce per un componente dell'applicazione in esecuzione.

Sintassi

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

Argomenti

app: Nome dell'applicazione
comp: Nome del componente
vdc: Nome del data center virtuale di destinazione

Tipo di transazione

sincrona

Tipo di richiesta

GET

Esempi

Recupera l'interfaccia di un componente per sugarcrm:main.srv1.

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

Output di esempio

XML:

<component>
   <name>main.srv1</name>
   <interfaces>
       <interface>
         <name>aux</name>
          <ip>10.80.54.26</ip>
         <mac>F2:64:0A:00:36:22</mac>
          <state>idle</state>
         <type>output</type>
      </interface>
      <interface>
         <name>db</name>
         <ip>10.80.54.23</ip>
         <mac>F2:64:0A:00:36:1F</mac>
         <state>idle</state>
          <type>output</type>
      </interface>
      <interface>
          <name>default</name>
         <ip>10.80.54.43</ip>
          <mac>F2:64:0A:00:36:25</mac>
         <state>active</state>
          <type>raw</type>
      </interface>
      .
      .  
      .
   </interfaces>
</component>

JSON:

{
   "interface" : 
      {
         "ip" : "10.80.54.26",
         "name" : "aux",
         "type" : "output",
         "mac" : "F2:64:0A:00:36:22",
         "state" : "idle"
      },
       {
         "ip" : "10.80.54.23",
         "name" : "db",
         "type" : "output",
         "mac" : "F2:64:0A:00:36:1F",
         "state" : "idle"
      },
       {
         "ip" : "10.80.54.43",
         "name" : "default",
         "type" : "raw",
         "mac" : "F2:64:0A:00:36:25",
         "state" : "active"
      },
      .
      .
      .
   ],
   "name" : "main.srv1"
}

Codici di errore HTTP

404: Entità vdc mygrid non trovata - È stato specificato un nome di VDC non configurato nell'applicazione WS_API.
400.4: Argomenti necessari mancanti (app). - Argomento app=app mancante nella richiesta.
400.4: Argomenti necessari mancanti (comp). - Argomento comp=comp mancante nella richiesta.
404.1: Impossibile elencare le interfacce dell'elenco per il componente test:main.srv - La verifica dell'applicazione non è installata. - Applicazione non valida specificata nella richiesta.
404.1: Impossibile elencare le interfacce dell'elenco per il componente test:main.srv - La verifica dell'applicazione non è in esecuzione. - L'applicazione specificata nella richiesta è in stato di interruzione.
404.1: Impossibile elencare le interfacce per il componente test:main.srv - è 'interrotto'. - Il componente specificato nella richiesta è in stato di interruzione.
404.1: Impossibile elencare le interfacce per il componente test:main.srv - Non esiste. - Componente non valido specificato nella richiesta.