ヘッダーをスキップ
Oracle VM Managerユーザーズ・ガイド
リリース2.2
B57074-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

C WebサービスAPI

Oracle VM Managerは、サード・パーティ製品とOracle VM Managerを統合可能にするWebサービスのApplication Programming Interface(API)を提供します。 このAPIを使用すると、サーバー・プールの作成、サーバーの追加、仮想マシンの作成などの任意の操作をOracle VM Managerで実行できます。 このAPIには、WebサービスをサポートしているJavaやPythonなどの任意の言語を使用してアクセスできます。

この付録では、Oracle VM ManagerのWebサービスAPIについて説明します。内容は次のとおりです。

C.1 WebサービスAPI

Oracle VM Managerは、ネットワークで接続されたOracle VM Serverの管理プラットフォームとして動作し、仮想マシン、仮想サーバーおよびサーバー・プールにアクションを指示します。 Oracle VM Managerは、Oracle VM用の管理環境を提供します。 Oracle VM Managerでは、WebサービスAPIを使用できます。 図C-1「Oracle VM ManagerのWebサービスAPIのアーキテクチャ」に、Oracle VM ManagerのWebサービスAPIのアーキテクチャを示します。

図C-1 Oracle VM ManagerのWebサービスAPIのアーキテクチャ

図C-1の説明が続きます。
「図C-1 Oracle VM ManagerのWebサービスAPIのアーキテクチャ」の説明

Oracle VM ManagerのAPIは、Oracle VM Manager用の完全なインタフェース・セットを提供します。 Oracle VM ManagerのAPIには、SOAPプロトコルを使用してOracle VM ManagerのWebサービスAPIを介してアクセスします。

Oracle VM ManagerのWebサービスAPIは、サーバー・プール、仮想サーバー、仮想マシン、ネットワーク、ストレージなどの仮想インフラストラクチャのコンポーネントを監視および管理するために必要なすべての操作(ライフ・サイクル操作を含む)を提供します。

図C-2「Oracle VM ManagerのWebサービスAPIの実装」に、Oracle VM ManagerのWebサービスAPIを示します。

図C-2 Oracle VM ManagerのWebサービスAPIの実装

図C-2の説明が続きます。
「図C-2 Oracle VM ManagerのWebサービスAPIの実装」の説明

Oracle VM ManagerのAPIは、Oracle VM ManagerのUIレイヤーおよびOracle Enterprise Managerの仮想化管理コンポーネントで使用されます。 WebサービスAPIは、Oracleアプリケーションおよびサード・パーティ製アプリケーションで使用できます。

C.2 Webサービス・クライアントの作成

Webサービスをサポートしている任意のプログラミング言語を使用して、Webサービス・クライアントを作成できます。 この章で示すほとんどのコード例は、Javaで記述されており、Oracle JDeveloperを使用して作成されていますが、任意の言語および開発ツールを使用できます。

WebサービスをJavaで使用する場合は、SOAPメッセージを直接作成するか、またはWebサービスごとにプロキシ・クラスを生成することができます。 Oracle JDeveloperでは、WebサービスのWSDL URLを使用してプロキシ・クラスを自動的に生成します。

複数のWebサービスに存在する1つのオブジェクト(ServerPoolServiceとVirtualMachineServiceの両方にあるVirtualServerオブジェクトなど)を作成する場合は、使用するすべてのWebサービスに対して、デフォルト・パッケージのapi.ovs.oracleまたは任意の自己定義パッケージ名を指定する必要があります。 api.ovs.oracle.serverPoolやapi.ovs.oracle.vmなどの特定のパッケージ名は指定しないでください。両方のパッケージに存在するオブジェクトをそれぞれのネームスペースに変換する必要があるためです。 VirtualServerの例では、オブジェクトsps.ServerPoolはvms.ServerPoolと同じではありません。また、一方のオブジェクトを起動中のメソッドに渡す前にもう一方のオブジェクトに変換する必要があります。

C.2.1 Javaでのプロキシ・クラスの作成

ここに示す例では、Oracle JdeveloperおよびJava wsimportユーティリティを使用して、Javaでプロキシ・クラスを作成しています。

C.2.1.1 Oracle JDeveloperの使用

Oracle JDeveloperを使用してOracle VM ManagerのWebサービスのプロキシ・クラスをJavaで作成するには、WebサービスのWSDL URL機能を使用します。

例C-1 Oracle JDeveloperを使用した名前でのサーバー・プールの取得

名前を使用してサーバー・プールを取得する場合のOracle JDeveloperプロキシ・クラスは、次のようになります。

   public ServerPool getServerPoolByName(String poolName) throws Exception{
        String username = "myuser";
        String password = "mypassword";

        //ServerPoolServiceSoapHttpPortClient is generated by Jdeveloper.
        server.ServerPoolServiceSoapHttpPortClient myPort =
           new server.ServerPoolServiceSoapHttpPortClient();
        myPort.setMaintainSession(true);
        myPort.setUsername(username);
        myPort.setPassword(password);
        ServerPool thePool = myPort.getServerPoolByName(poolName);
        return thePool;
    }

例C-2 Oracle JDeveloperを使用したゲスト仮想マシンまたはテンプレートのインポート

ゲスト仮想マシンまたはテンプレートをインポートする場合のOracle JDeveloperプロキシ・クラスは、次のようになります。

/**
 * @param args
 */
public static void main(String[] args) {
    try {
        oracle.ovs.api.ResourceServiceSoapHttpPortClient myPort = new oracle.ovs.api.ResourceServiceSoapHttpPortClient();
        System.out.println("calling " + myPort.getEndpoint());

        /* External Template Importing **/
        VirtualMachineTemplate vmt = new VirtualMachineTemplate();
        /* set template name **/
        vmt.setImgName("MyTemplate");
        /* set download url **/
        vmt.setDownloadURL("http://example.com/OEL5");
        /* set proxy url(optional) **/
        vmt.setProxyURL("http://proxy.example.com:80");
        /* set vm username **/
        vmt.setVmUsername("myuser");
        /* set vm password **/
        vmt.setVmPassword("mypassword");
        /* set operating system type **/
        vmt.setOsType("Enterprise Linux 5");
        /* set description **/
        vmt.setDescription("My description.");
        /* start importing **/
        myPort.registerExternalTemplate("example.com", vmt);

        /* Internal Image Importing **/
        VirtualMachineImage vmi = new VirtualMachineImage();
        /* set vm name **/
        DiscoveredVirtualMachineImage[] unregisteredImages = myPort.getAllDiscoverableImages("example.com");
        /* find unregistered vm **/
        if (unregisteredImages.length > 0) {
            vmi.setImgName(unregisteredImages[0].getImgName());
        }
        else {
            return;
        }

        /* set vm username **/
        vmi.setVmUsername("myuser");
        /* set vm passwd **/
        vmi.setVmPassword("mypassword");
        /* set vnc password **/
        vmi.setVncPassword("mypassword");
        /* set operating system type **/
        vmi.setOsType("Enterprise Linux 4 64-bit");
        /* set description **/
        vmi.setDescription("My description.");
        /* start importing **/
        myPort.registerInternalImage("example.com", vmi);

    } catch (Exception ex) {
        ex.printStackTrace();
    }
}

例C-3 Oracle JDeveloperを使用したテンプレートからのゲスト仮想マシンの作成

テンプレートからゲスト仮想マシンを作成する場合のOracle JDeveloperプロキシ・クラスは、次のようになります。

public static void main(String[] args) {
    try {
        LifecycleServiceSoapHttpPortClient myPort =
           new LifecycleServiceSoapHttpPortClient();
        System.out.println("calling " + myPort.getEndpoint());
        // Add your own code here

        myPort.setUsername("myuser");
        myPort.setPassword("mypassword");

        TemplateVmConfig templateVMConfig= new  TemplateVmConfig();
        templateVMConfig.setServerPoolName("example.com");
            //your serverpoolName
        templateVMConfig.setTemplateName("myTemplate");//your templateName

        NICConfig nic = new NICConfig();
        nic.setName("VIF0");
        nic.setIpAddress("ioemu");

       nic.setBridge("xenbr0");
        nic.setMacAddress("00:16:xx:xx:xx:xx");
        NetworkConfType confType = new NetworkConfType();
        confType.setType("Dynamic");
        nic.setNetworkConfType(confType);

        //nic.set
        NICConfig[] vifs = new NICConfig[]{nic};
        templateVMConfig.setVif(vifs);

        templateVMConfig.setVmName("MyGuestVirtualMachine");

        templateVMConfig.setConsolePassword("mypassword");
        templateVMConfig.setHaEnable(false);

        myPort.createVmBasedOnTemplate(templateVMConfig);
    } catch (Exception ex) {
        ex.printStackTrace();
    }
}

public LifecycleService _port;
public VirtualMachine createVmBasedOnTemplate(TemplateVmConfig templateVMConfig) throws java.rmi.RemoteException{
    ServiceFactory factory = ServiceFactory.newInstance();
    _port = ((LifecycleService_Service)factory.loadService(LifecycleService_Service.class))
            .getLifecycleServiceSoapHttpPort();
   return _port.createVmBasedOnTemplate(templateVMConfig);
}

C.2.1.2 wsimportの使用

wsimportユーティリティを使用してOracle VM ManagerのWebサービスのプロキシ・クラスをJavaで作成するには、次のように入力します。

$ JAVA_HOME/bin/wsimport -d <dir-for-compiled classes> -keep -s <dir-for-generated-source> -p com.oracle.ovm.manager.ws.vms -wsdllocation http://ovm_host:port/OVSWS/nameService.wsdl <path-to-wsdl-file-in-local-host>

たとえば、ServerPool Webサービスのプロキシ・クラスを作成するには、次のように入力します。

$ JAVA_HOME/bin/wsimport -d <dir-for-compiled classes> -keep -s <dir-for-generated-source> -p com.oracle.ovm.manager.ws.vms -wsdllocation http://example.com:8888/OVSWS/ServerPoolService.wsdl <path-to-wsdl-file-in-local-host>

例C-4 wsimportを使用した名前でのサーバー・プールの取得

名前を使用してサーバー・プールを取得する場合のwsimportプロキシ・クラスは、次のようになります。

   public ServerPool getServerPoolByName(String poolName) throws Exception{
        String url = "http://example.com:8888/";
        String contextPath = "OVSWS";
        String user = "myuser";
        String password = "mypassword";
        ServerPoolService_Service sps_service =
            new ServerPoolService_Service(new URL(url + contextPath +
               "/ServerPoolService.wsdl"),
            new QName("http://oracle.ovs.api/", "ServerPoolService"));
        sps = sps_service.getServerPoolServiceSoapHttpPort();

        BindingProvider bp = (BindingProvider) sps;
        Map<String, Object> rc = bp.getRequestContext();
        rc.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url + contextPath +
            "/ServerPoolServiceSoapHttpPort");
        rc.put(BindingProvider.SESSION_MAINTAIN_PROPERTY, new Boolean(true));
        rc.put(BindingProvider.USERNAME_PROPERTY, user);
        rc.put(BindingProvider.PASSWORD_PROPERTY, password);

        GetServerPoolByNameElement req = new GetServerPoolByNameElement();
        req.setPoolName(poolName);
        GetServerPoolByNameResponseElement res = sps.getServerPoolByName(req);
        ServerPool thePool = res.getResult();
        return thePool;
    }

C.2.2 Pythonでのプロキシ・クラスの作成

Pythonを使用してOracle VM ManagerのWebサービスのプロキシ(スタブ)・クラスを作成するには、次のように入力します。

$ wsdl2py -b http[s]://ovm_host:port/OVSWS/nameService.wsdl

たとえば、ServerPool Webサービスのプロキシ・クラスを作成するには、次のように入力します。

$ wsdl2py -b https://ovm.example.com:4443/OVSWS/ServerPoolService.wsdl

例C-5 Pythonを使用した名前でのサーバー・プールの取得

名前を使用してサーバー・プールを取得する場合のPythonプロキシ・クラスは、次のようになります。

import ServerPoolService_client as c

class ServerPoolManagementPort:

    def __init__(self, urlbase, auth):
        self.wspath = "/ServerPoolServiceSoapHttpPort"
        self.loc = c.ServerPoolServiceLocator()
        self.srv = self.loc.getServerPoolServiceSoapHttpPort(url = urlbase +
            self.wspath, auth = auth)
    def getServerPoolByName(self, poolName):
        """
        Return instance os a specific server pool managed by the system, by its
            name.
        @param poolName:
        @type poolName: str
        @return: ServerPool
        """
        request = c.ServerPoolService_getServerPoolByName()
        request._poolName = poolName
        response = self.srv.getServerPoolByName(request)
        return response._result

Webサービスでの認証を含めてこのコードをコールする場合は、次のように使用します。

from ServerPoolManagementPort import *
from ZSI.auth import AUTH
auth=(AUTH.httpbasic, 'myuser', 'mypassword')
spm = ServerPoolManagementPort(urlbase = 'https://ovm.example.com:4443/OVSWS/',
                   auth = auth)
serverpool = spm.getServerPoolByName('myserverpool')

C.3 認証およびセキュリティ

Oracle VM ManagerのWebサービスは、HTTP Basic認証を使用してユーザーの認証およびアクセスの制御を行います。 HTTP Basic認証では、サーバーが、Webサービス・クライアントからユーザー名およびパスワードをリクエストし、そのユーザー名およびパスワードと有効なOracle VM Managerユーザーを比較して有効であることを検証する必要があります。

SSLは、Webサービスに対してデフォルトで有効になり、トランスポート・レベルでの送信時にデータを保護します。 Webサービスのコールごとに、サーバーは基本ヘッダーでログイン資格証明が有効なOracle VM Managerユーザーかどうかを認証します。

元のOracle VM Managerのインストール後にWebサービス用のSSLを設定する必要がある場合は、次のスクリプトを使用できます。

# /opt/ovs-manager-2.2/bin/secure_ws.sh

このスクリプトは、Oracle VM ManagerのWebサービスのキーストアを生成し、OC4Jを構成します。

Oracle VM Managerでの認証を実行するには、Webサービス・クライアントからOracle VM ManagerのWebサービスにOracle VM Managerログイン資格証明を渡す必要があります。

例C-6 Javaでの認証

HTTP Basic認証をJava Webサービス・クライアントから実行するには、次の手順を実行します。

  1. WebサービスへのURLをhttpからhttpsに変更します。 たとえば、https://ovm.example.com:4443のようにです。これは、手順3のSOAP HTTPポートを取得するために使用されるURLです。

  2. 次の2つのシステム・プロパティをクライアント側のJavaに追加して、SSLハンドシェイクを実行します。

    -Djavax.net.ssl.trustStore=/path/ovmm_client_trust.jks    <=== this contains the manager's cert
    -Djavax.net.ssl.trustStorePassword=truststorepasswd
    
  3. 次のようなコードを使用して、SOAP HTTPポートを取得します。

    ServerPoolService_Service sps_service =
            new ServerPoolService_Service(new URL(url + contextPath +
                   "/ServerPoolService.wsdl"),
            new QName("http://oracle.ovs.api/", "ServerPoolService"));
    //Note, the URL here is the URL mentioned in Step 1. It is the HTTPS URL.
    ServerPoolService sps = sps_service.getServerPoolServiceSoapHttpPort();
    
    BindingProvider bp = (BindingProvider) sps;
    Map<String, Object> rc = bp.getRequestContext();
    rc.put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url + contextPath +
         "/ServerPoolServiceSoapHttpPort");
    rc.put(BindingProvider.SESSION_MAINTAIN_PROPERTY, new Boolean(true));
    rc.put(BindingProvider.USERNAME_PROPERTY, myuser);
    rc.put(BindingProvider.PASSWORD_PROPERTY, mypassword);
    
  4. Webサービス・クライアントにキーストアおよびプロキシも生成する必要があります。 たとえば、次のコードを使用できます。

    # java -Djavax.net.ssl.trustStore=/Users/myuser/ssl/client.keystore
    -Djavax.net.ssl.keyStore=/Users/myuser/ssl/client.keystore
    -Djavax.net.ssl.trustStorePassword=mypassword
    -Djavax.net.ssl.keyStorePassword=mypassword
    -jar $ORACLE_HOME/webservices/lib/wsa.jar
    -genProxy
    -wsdl https://ovm.example.com:4443/OVSWS/AdminServiceSoapHttpPort?WSDL
    
  5. Webサービス・クライアントにログイン資格証明を設定するには、次のコードを使用できます。

    System.setProperty("javax.net.ssl.trustStore", "/Users/myuser/ssl/client.keystore");
    System.setProperty("javax.net.ssl.keyStore", "/Users/myuser/ssl/client.keystore");
    System.setProperty("javax.net.ssl.trustStorePassword", "mypassword");
    System.setProperty("javax.net.ssl.keyStorePassword", "mypassword");
    ...
    

例C-7 Pythonでの認証

サーバー・プールを認証して取得するためのPythonプロキシ・クラスは、次のようになります。

import ServerPoolService_client as c
from ZSI.auth import AUTH
loc = c.ServerPoolServiceLocator()
auth = (AUTH.httpbasic, 'myuser', 'mypassword')
srv = loc.getServerPoolServiceSoapHttpPort(auth=auth)
req = c.ServerPoolService_getServerPoolByName()
req._poolName = 'myserverpool'
resp = srv.getServerPoolByName(req)
serverPool = resp._result

C.4 Webサービスの場所

各Oracle VM ManagerのWebサービスのURLの構文は、次のとおりです。

http[s]://ovm_manager_host:port/OVSWS/WS_name.wsdl

SSLは、Webサービスに対してデフォルトで有効になり、トランスポート・レベルでの送信時にデータを保護します。 WebサービスにはSSLを使用せずにアクセスできますが、セキュリティを強化するためにSSLを使用することをお薦めします。

Webサービスごとにテスト・ページを使用できます。このページを使用して、WebサービスおよびWebサービス・パラメータの値をテストできます。 Webサービス・テスト・ページのURLの構文は、次のとおりです。

http[s]://ovm_manager_host:port/OVSWS/WS_nameSoapHttpPort

Webサービス・テスト・ページをブラウザで開く場合は、Oracle VM Managerの管理者のユーザー名およびパスワードを入力して、Webサービスでの認証を実行する必要があります。 認証されると、パラメータを入力してWebサービスの様々なメソッドを起動できるフォームが表示されます。 このフォームには、WebサービスのWSDLを表示する「サービスの説明」というリンクも表示されます。 次に、WSDL URLの構文を示します。

http[s]://ovm_manager_host:port/OVSWS/WS_nameSoapHttpPort?WSDL

または

http[s]://ovm_manager_host:port/OVSWS/WS_name.wsdl

Webサービス・テスト・ページには、Webサービスのドキュメントへのリンクも表示されます。 Webサービスのドキュメントの構文は、次のとおりです。

http[s]://ovm_manager_host:port/OVSWS/WS_nameSoapHttpPort?WS_ nameSoapHttpPortstub.html

たとえば、Oracle VM Managerホストがovm.example.com、そのポートが4443でSSLが有効になっている場合は、次のURLがLifecycleServiceの場所になります。

https://ovm.example.com:4443/OVSWS/LifecycleService.wsdl

LifecycleServiceのテスト・ページの場所は、次のとおりです。

https://ovm.example.com:4443/OVSWS/LifecycleServiceSoapHttpPort

対応するLifecycleServiceのドキュメントのURLは、次のとおりです。

https://ovm.example.com:4443/OVSWS/LifecycleServiceSoapHttpPort?LifecycleServiceSoapHttpPortstub.html

C.5 Webサービス

使用可能なOracle VM ManagerのWebサービスは、次のとおりです。

C.5.1 LifecycleService

LifecycleService Webサービスは、仮想マシンのライフ・サイクルを管理します。 このWebサービスを使用して、仮想マシンの作成、HAの有効化、ライブ移行の実行、CDおよびディスクの接続などを実行できます。

LifecycleService Webサービスは、次の場所にあります。

http[s]://ovm_manager_host:port/OVSWS/LifecycleService.wsdl

このWebサービスで使用可能なメソッドは、次のとおりです。

  • addDisk

  • addNIC

  • attachCDtoVM

  • attachSharedVirtualDisk

  • changeNetworkType

  • clone

  • configDisk

  • configNIC

  • configVMGroup

  • createVmBasedOnISO

  • createVmBasedOnPXE

  • createVmBasedOnTemplate

  • deploy

  • detachCD

  • detachSharedVirtualDisk

  • disableHA

  • enableHA

  • getConsolePassword

  • getKeyboardLayoutArray

  • getVMGroupByVMId

  • liveMigrate

  • liveMigrateAll

  • removeDisk

  • removeNIC

  • resetStatus

  • setBootPriority

  • setConsolePassword

  • setCpuCores

  • setDynamicMemory

  • setGuestCredential

  • setMaximumMemory

  • setNetworkInsideGuest

  • setOperatingSystem

  • setPreferredServers

  • setVCPUCapByVMID

  • setVCPUPriorityByVMID

  • setVMConfigParam

  • setVMDescription

  • setVMKeyboardLayout

このWebサービスで使用可能な機能の詳細は、『Oracle VM Manager Web Services API Reference』を参照してください。

C.5.2 ResourceService

ResourceService Webサービスは、リソースを管理します。 このWebサービスを使用して、ISOファイル、テンプレート、仮想マシンおよび共有仮想ディスクをインポートおよび管理できます。

ResourceService Webサービスは、次の場所にあります。

http[s]://ovm_manager_host:port/OVSWS/ResourceService.wsdl

このWebサービスで使用可能なメソッドは、次のとおりです。

  • ValidateVMConfig

  • approveISOResource

  • approveImage

  • approveTemplate

  • deleteISO

  • deleteImage

  • deleteSharedVirtualDisk

  • deleteTemplate

  • getAllDiscoverableISO

  • getAllDiscoverableImages

  • getAllDiscoverableTemplates

  • getAllISOResources

  • getAllImageResources

  • getAllSharedVirtualDisks

  • getAllTemplateResources

  • getISOResource

  • getISOResourceByGroupName

  • getISOResourceByGroupNameAndISOName

  • getISOResourceByISOName

  • getImageResource

  • getImageResourceByName

  • getRegisteredMultipathDevices

  • getRegisteredSharedVirtualDisks

  • getSharedDiskResource

  • getSharedDiskResourceByName

  • getTemplateResource

  • getTemplateResourceByName

  • getUnregisteredMultipathDevices

  • getUnregisteredSharedVirtualDisks

  • registerExternalISO

  • registerExternalImage

  • registerExternalTemplate

  • registerISO

  • registerInternalISO

  • registerInternalImage

  • registerInternalSharedVirtualDisk

  • registerInternalTemplate

  • registerMultipathDevice

  • registerSharedVirtualDisk

このWebサービスで使用可能な機能の詳細は、『Oracle VM Manager Web Services API Reference』を参照してください。

C.5.3 PluginService

PluginService Webサービスは、プラグインを管理します。このWebサービスを使用して、プラグインの有効範囲プロパティを設定または取得できます。

PluginService Webサービスは、次の場所にあります。

http[s]://ovm_manager_host:port/OVSWS/PluginService.wsdl

このWebサービスで使用可能なメソッドは、次のとおりです。

  • disposePlugin

  • getDaemonManager

  • preparePlugin

このWebサービスで使用可能な機能の詳細は、『Oracle VM Manager Web Services API Reference』を参照してください。

C.5.4 ServerPoolService

ServerPoolService Webサービスは、サーバーおよびサーバー・プールを管理します。 このWebサービスを使用して、サーバーおよびサーバー・プールを作成および管理できます。

ServerPoolService Webサービスは、次の場所にあります。

http[s]://ovm_manager_host:port/OVSWS/ServerPoolService.wsdl

このWebサービスで使用可能なメソッドは、次のとおりです。

  • addMembers

  • blackoutServer

  • checkHAAbility4ServerPoolById

  • checkServerConnection

  • checkVirtualServerCompatibility

  • createServerPool

  • deleteServerPool

  • endBlackoutServer

  • getAgentVersion

  • getAllHVMServerPools

  • getAllHVMServerPoolsByUserId

  • getAllMembers

  • getAllServerPools

  • getClusterRootByServerPoolId

  • getMasterAgentStatus

  • getMasterServer

  • getMinSupportedOVSAgentVersion

  • getMinimumAgentVersion

  • getNetworkBridges

  • getNetworkBridgesByServerIP

  • getServer

  • getServerByName

  • getServerPool

  • getServerPoolById

  • getServerPoolByName

  • getServerPoolMetricsByServerPoolId

  • getServerPools

  • get StorageResositoriesByServerPoolId

  • getVirtualServerById

  • getVirtualServerByName

  • getVirtualServerByServerPool

  • getVirtualServerMetrics

  • getVirtualServers

  • rebootServer

  • refreshServerPool

  • removeMember

  • restoreVirtualServerPoolByManagerData

  • shutdownServer

  • updateServerPool

  • updateUserList4ServerPool

  • updateUtilityServerPassword

  • updateVirtualServer

  • updateVirtualServerAgentPassword

  • updateVirtualServerById

  • validateAddMembers

  • validateBlackoutServer

  • validateCreateServerPool

  • validateDeleteServerPool

  • valicateRebootServer

  • validateRemoveMember

  • validateShutdownServer

  • validateUpdateUtilityServerPassword

  • validateUpdateVSAgentPassword

このWebサービスで使用可能な機能の詳細は、『Oracle VM Manager Web Services API Reference』を参照してください。

C.5.5 VirtualMachineService

VirtualMachineService Webサービスは、仮想マシンを管理します。 このWebサービスを使用して、仮想マシンを作成および管理できます。

VirtualMachineService Webサービスは、次の場所にあります。

http[s]://ovm_manager_host:port/OVSWS/VirtualMachineService.wsdl

このWebサービスで使用可能なメソッドは、次のとおりです。

  • createPropertiesFileOnVirtualMachine

  • deleteVMByVMId

  • getAllAlertAssociatedWithImg

  • getAllOperatingSystemArray

  • getAllVMs

  • getAssociatedPool

  • getAssociatedServer

  • getLastAlertAssociatedWithDisk

  • getLastAlertAssociatedWithImg

  • getRealPath

  • getVM

  • getVMByName

  • getVncPassword

  • pauseVMByVMId

  • powerOffVMByVMId

  • powerOnVMByVMId

  • queryCdromArray

  • queryLocalDiskInfo

  • queryLocalDisks

  • queryNetworkInterfaceCardArray

  • queryPreferredServer

  • queryPreferredServerArray

  • querySharedDiskInfo

  • querySharedDisks

  • querySharedVirtualDiskArray

  • queryVMMetricArrayVyVMIds

  • queryVMMetricByVMId

  • queryVMStatusArrayByVMIds

  • queryVMStatusByVMId

  • rebootVMByVMId

  • resumeVMByVMId

  • saveAsTemplate

  • saveAsTemplateAsync

  • setVMName

  • suspendVMByVMId

  • unpauseVMByVMId

  • unregisterVMByVMId

  • update

  • uploadVirtualMachine

このWebサービスで使用可能な機能の詳細は、『Oracle VM Manager Web Services API Reference』を参照してください。

C.5.6 AdminService

AdminService Webサービスは、ユーザーおよびグループを管理します。 このWebサービスを使用して、ユーザーおよびグループを作成および管理できます。

AdminService Webサービスは、次の場所にあります。

http[s]://ovm_manager_host:port/OVSWS/AdminService.wsdl

このWebサービスで使用可能なメソッドは、次のとおりです。

  • createGroup

  • createUser

  • createUserGroup

  • createUserSite

  • findAllOVMGroup

  • findAllOVMRole

  • finalAllOVMUser

  • findAllOVMUserGroup

  • findAllOVMUserRole

  • findAllOVMUserSite

  • findUserById

  • getOVMVersion

  • isAdminUser

  • login

  • logout

  • searchUsers

このWebサービスで使用可能な機能の詳細は、『Oracle VM Manager Web Services API Reference』を参照してください。