Article ID: 111220, created on Jul 4, 2014, last review on Aug 12, 2014

  • Applies to:
  • Odin Business Automation Standard 4.5
  • Virtuozzo 6.0
  • Virtuozzo containers for Linux 4.7
  • Virtuozzo containers for Linux 4.6
  • Virtual Automation 6.0

Notas generales

Parallels Virtual Automation (PVA) tiene distintos puertos API en función de la versión y del tipo de host PVA.

Parallels Virtual Automation 4.0 (PIM, Parallels Infrastructure Manager, VZAgent):

  • 4433 - Servicio XML API no SSL
  • 4434 - Servicio XML API SSL
  • 4646 - Servicio API SOAP

Nodo de administración de Parallels Virtual Automation 4.5, 4.6 y 6.0 (Reemplazo para el nodo principal de PIM 4.0):

  • 4533 - Servicio XML API no SSL
  • 4534 - Servicio XML API SSL

* Parallels Virtual Automation Agent 4.5, 4.6* y 6.0 (Reemplazo para VZAgent 3.0 y 4.0 en nodos secundarios en el grupo PIM. PVA Agent se instala directamente en el host cuando se instala Parallels Containers o Parallels Server):

  • 4433 - Servicio XML API no SSL
  • 4434 - Servicio XML API SSL
  • 4646 - Servicio API SOAP

El servicio API de PVA puede operar en modo de compatibilidad con las versiones anteriores, motivo por el que la versión de la API suele establecerse a la 4.0.0. De todos modos, este parámetro puede modificarse, de ser necesario.

Para utilizar una versión anterior de la API de PVA, deberá seguir las instrucciones detalladas en la guía de API correspondiente y establecer la versión de protocolo de la API apropiada en el encabezado XML. Vea este ejemplo:

<packet id="1" version="4.0.0"> o <packet id="1" version="4.5.0">

Busque las referencias para cada versión del protocolo de XML API en el manual correspondiente (disponibles en inglés):

Referencia de XML API de VZAgent 3.0

Referencia de XML API de PVA 4.0

Referencia de XML API de PVA 6.0

Formas de enviar una petición XML API

Una petición XML API puede enviarse al servicio XML API de PVA de distintos modos:

  1. Las peticiones API a un PVA Agent pueden enviarse mediante la herramienta vzlcon:

    • En Windows:

      vzlcon
      
    • En Linux\Bare Metal:

      /opt/pva/agent/bin/vzlcon
      

    NOTA: los paquetes se separan mediante la combinación ctrl+shift+2:

    [root@myserver ~]# /opt/pva/agent/bin/vzlcon
    <packet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="0" priority="0" version="4.5.0">
    <origin>vzclient2-4a7e18fd-c53a-a048-af57-06602fbb8317</origin>
    <target>agent</target>
    <data>
    <ok/>
    <eid>4a7e18fd-c53a-a048-af57-06602fbb8317</eid>
    </data>
    </packet>
    <packet version="4.0.0"><data><system><get_version/></system></data></packet>
    ^@  <==Here CTRL+SHIFT+2 was pressed
    <packet xmlns:ns1="http://www.swsoft.com/webservices/vzl/4.0.0/protocol" xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/system" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" priority="0" version="4.0.0">
    <ns1:origin>gend</ns1:origin>
    <ns1:target>vzclient2-4a7e18fd-c53a-a048-af57-06602fbb8317</ns1:target>
    <ns1:dst>
    <director>gend</director>
    </ns1:dst>
    <ns1:data>
    <ns2:system>
    <ns2:version>vzagent-4.6.843</ns2:version>
    <ns2:pva_version>4.6</ns2:pva_version>
    <ns2:pva_release>1764</ns2:pva_release>
    </ns2:system>
    </ns1:data>
    </packet>
    ^C
    
  2. Mediante la herramienta openssl:

    ~# echo -ne '<packet id="1" version="4.0.0"><data><system><login><name>BASE 64 ENCRYPTED USER NAME</name><realm>00000000-0000-0000-0000-000000000000</realm><password>BASE64 ENCRYPTED PASSWORD</password></login></system></data></packet>\0<packet id="2" version="4.0.0">YOUR XML API REQUEST</packet>\0' | openssl s_client -connect HOSTNAME:4434 -cipher ADH-AES256-SHA -quiet
    

    En este ejemplo deberá especificar las credenciales cifras base64 para autenticarse en el servicio XML API. Esta acción pueden realizarse mediante perl:

    ~#perl -MMIME::Base64 -e "print(encode_base64('YOUR PLAIN TEXT PASSWORD'))"
    WU9VUiBQTEFJTiBURVhUIFBBU1NXT1JE
    

    Su petición XML API se incluye en el segundo paquete. Puede enviar múltiples paquetes en una secuencia que termine por '\0' tras el paquete de autenticación.

  3. Mediante el cliente Perl adjunto a este artículo:

    ~# ./pvaapi.pl -name=root -password='PASSWORD' -host=HOSTNAME -packet='<packet version="4.0.0"><data><system><get_version/></system></data></packet>'
    <packet xmlns:ns1="http://www.swsoft.com/webservices/vzl/4.0.0/protocol" xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/system" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" priority="0" version="4.0.0">
    <ns1:origin>gend</ns1:origin>
    <ns1:target>vzclient25401-057cfcc0-18b0-e44b-9730-ba41ac7c877a</ns1:target>
    <ns1:dst>
    <director>gend</director>
    </ns1:dst>
    <ns1:data>
    <ns2:system>
    <ns2:version>vzagent-4.0.0.483.swsoft</ns2:version>
    <ns2:pva_version></ns2:pva_version>
    <ns2:pva_release></ns2:pva_release>
    </ns2:system>
    </ns1:data>
    </packet>
    

    Use el script pvaapi_stdin.pl para enviar un paquete largo a la línea de comandos:

    ~# ./pvaapi_stdin.pl -name=root -password='PASSWORD' -host=HOSTNAME < long_package.xml
    
  4. Mediante un cliente XML API personalizado.

Información adicional

Artículos relacionados que pueden resultarle de utilidad:

6981 Resolución de problemas de PVA.

111223 Cómo encontrar peticiones XML API enviadas a PVA Agente por el nodo de administración de PVA o Power Panel

9216 Compatibilidad de VZagent API (Windows)

111821 Compatibilidad de VZagent API (Linux)

NOTA: si desea más información acerca de las versiones de la API de PVA, de cambios y de cambios de aplicaciones cliente, consulte PTN en http://sp.parallels.com/ptn/documentation/virtuozzo/

Attachments

319940068c5fa20655215d590b7be29b c9ea6ca1b35b3385431f406f1be737be 2897d76d56d2010f4e3a28f864d69223 0889ab60fa6494de107aa7338c3c38b6 e8e50b42231236b82df27684e7ec0beb d02f9caf3e11b191a38179103495106f 400e18f6ede9f8be5575a475d2d6b0a6 caea8340e2d186a540518d08602aa065 0c05f0c76fec3dd785e9feafce1099a9 0dd5b9380c7d4884d77587f3eb0fa8ef 624ca542e40215e6f1d39170d8e7ec75 70a5401e8b9354cd1d64d0346f2c4a3e c62e8726973f80975db0531f1ed5c6a2 36627b12981f68a16405a79233409a5e

Email subscription for changes to this article
Save as PDF