6.108. ホスト

ホストを管理するサービス

Expand

表6.322 メソッドの概要
名前	Summary
`activate`	仮想マシンを実行するなど、使用するホストをアクティベートします。
`approve`	仮想化環境で使用するために事前にインストールされたハイパーバイザーホストを承認します。
`commitnetconfig`	ネットワーク設定を正常としてマークし、ホスト内にその設定を持続させます。
`copyhostnetworks`	指定したホストのネットワーク設定を現在のホストにコピーします。
`deactivate`	ホストを無効にして、メンテナンスタスクを実行します。
`discoveriscsi`	イニシエーターの詳細を使用して、ホスト上の iSCSI ターゲットを検出します。
`enrollcertificate`	ホストの証明書を登録します。
`fence`	ホストの電源管理デバイスを制御します。
`forceselectspm`	ホストを Storage Pool Manager (SPM) として手動で設定します。
`get`	ホストの詳細を取得します。
`install`	最新バージョンの VDSM と関連ソフトウェアをホストにインストールします。
`iscsidiscover`	このメソッドは、Engine バージョン 4 以降非推奨となりました。
`iscsilogin`	ターゲットの詳細を使用して、ホストの iSCSI ターゲットにログインします。
`refresh`	ホストデバイスと機能を更新します。
`remove`	システムからホストを削除します。
`setupnetworks`	この方法は、ホストのネットワークインターフェイスの設定を変更するために使用されます。
`syncallnetworks`	ホスト上の全ネットワークを同期するには、以下のような要求を送信します。 [source] ---- POST /ovirt-engine/api/hosts/123/syncallnetworks ---- リクエスト本文は以下のようになります。 [source,xml] ---- <action/> ----
`unregisteredstoragedomainsdiscover`	設定にインポートする候補であるブロックストレージドメインを検出します。
`update`	ホストのプロパティーを更新します。
`upgrade`	ホストで VDSM および選択したソフトウェアをアップグレードします。
`upgradecheck`	ホストにアップグレードが利用可能であるかどうかを確認します。

6.108.1. activate POST
リンクのコピー

仮想マシンを実行するなど、使用するホストをアクティベートします。

Expand

表6.323 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アクティベーションを非同期で実行する必要があるかどうかを示します。

6.108.2. approve POST
リンクのコピー

仮想化環境で使用するために事前にインストールされたハイパーバイザーホストを承認します。

このアクションは、このホストのターゲットクラスターを定義するためのオプションのクラスター要素も受け入れます。

Expand

表6.324 パラメーターの概要
名前	型	方向	Summary
`activate`	ブール値	In	'true' に設定すると、このホストは承認の完了後にアクティベートされます。
`async`	ブール値	In	承認を非同期的に実行するかどうかを指定します。
`cluster`	クラスター	In	ホストが承認後に追加されるクラスター。
`host`	ホスト	In	承認するホスト。
`reboot`	ブール値	In	インストールに成功した後にホストを再起動するかどうかを示します。

6.108.2.1. activate
リンクのコピー

'true' に設定すると、このホストは承認の完了後にアクティベートされます。'false' に設定すると、ホストは承認後も 'maintenance' ステータスのままになります。このパラメーターがない場合は 'true' と解釈されます。これは、望ましいデフォルトの動作が承認後にホストをアクティブ化するからです。

6.108.2.2. reboot
リンクのコピー

インストールに成功した後にホストを再起動するかどうかを示します。デフォルト値は true です。

6.108.3. commitnetconfig POST
リンクのコピー

ネットワーク設定を正常としてマークし、ホスト内にその設定を持続させます。

API ユーザーは、ネットワーク設定をコミットして、ホストネットワークインターフェイスのアタッチメントまたはデタッチメントを永続化するか、ボンディングされたインターフェイスの作成と削除を永続化します。

重要

ネットワーク設定は、設定の変更によってホスト接続が失われないことをエンジンが確認した後にのみ、コミットされます。ホストの接続が失われた場合、ホストを再起動する必要があり、自動的に以前のネットワーク設定に戻ります。

たとえば、ID が 123 のホストのネットワーク設定をコミットするには、次のようなリクエストを送信します。

POST /ovirt-engine/api/hosts/123/commitnetconfig

POST /ovirt-engine/api/hosts/123/commitnetconfig

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<action/>

<action/>

Copy to Clipboard

Toggle word wrap

重要

Red Hat Virtualization Manager 4.3 以降、setupnetworks リクエストで commit_on_success を指定することもできます。この場合、セットアップが完了し、{hypervisor-name} と Red Hat Virtualization Manager 間の接続が再確立され、個別の commitnetconfig リクエストを待つことなく、新しい設定が {hypervisor-name} に自動的に保存されます。

Expand

表6.325 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アクションを非同期で実行する必要があるかどうかを示します。

6.108.4. copyhostnetworks POST
リンクのコピー

指定したホストのネットワーク設定を現在のホストにコピーします。

重要

ソースホストに存在しないネットワークアタッチメントは、コピー操作によってターゲットホストから消去されます。

別のホストからネットワークをコピーするには、次のようなリクエストを送信します。

POST /ovirt-engine/api/hosts/123/copyhostnetworks

POST /ovirt-engine/api/hosts/123/copyhostnetworks

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<action>
   <source_host id="456"/>
</action>

<action>
   <source_host id="456"/>
</action>

Copy to Clipboard

Toggle word wrap

Expand

表6.326 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アクションを非同期で実行する必要があるかどうかを示します。
`source_host`	ホスト	In	ネットワークのコピー元となるホスト。

6.108.5. deactivate POST
リンクのコピー

ホストを無効にして、メンテナンスタスクを実行します。

Expand

表6.327 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	非アクティブ化を非同期で実行する必要があるかどうかを示します。
`reason`	String	In
`stop_gluster_service`	ブール値	In	ホストの非アクティブ化の一環として gluster サービスを停止する必要があるかどうかを示します。

6.108.5.1. stop_gluster_service
リンクのコピー

ホストの非アクティブ化の一環として gluster サービスを停止する必要があるかどうかを示します。gluster ホストのメンテナンス操作中に使用できます。この変数のデフォルト値は false です。

6.108.6. discoveriscsi POST
リンクのコピー

イニシエーターの詳細を使用して、ホスト上の iSCSI ターゲットを検出します。検出されたデータを含む IscsiDetails オブジェクトのリストを返します。

たとえば、myiscsi.example.com で利用可能な iSCSI ターゲットをホスト 123 から検出するには、次のようなリクエストを送信します。

POST /ovirt-engine/api/hosts/123/discoveriscsi

POST /ovirt-engine/api/hosts/123/discoveriscsi

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<action>
  <iscsi>
    <address>myiscsi.example.com</address>
  </iscsi>
</action>

<action>
  <iscsi>
    <address>myiscsi.example.com</address>
  </iscsi>
</action>

Copy to Clipboard

Toggle word wrap

結果は以下のようになります。

<discovered_targets>
  <iscsi_details>
    <address>10.35.1.72</address>
    <port>3260</port>
    <portal>10.35.1.72:3260,1</portal>
    <target>iqn.2015-08.com.tgt:444</target>
  </iscsi_details>
</discovered_targets>

<discovered_targets>
  <iscsi_details>
    <address>10.35.1.72</address>
    <port>3260</port>
    <portal>10.35.1.72:3260,1</portal>
    <target>iqn.2015-08.com.tgt:444</target>
  </iscsi_details>
</discovered_targets>

Copy to Clipboard

Toggle word wrap

重要

このメソッドを使用して、iSCSI ターゲットを検出する場合には、FQDN または IP アドレスを使用できますが、REST API メソッドを使用してログインするには、検出された iSCSI ターゲットの詳細を使用する必要があります。

Expand

表6.328 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	検出を非同期で実行する必要があるかどうかを示します。
`discovered_targets`	IscsiDetails[]	Out	すべての接続情報を含む検出されたターゲット。
`iscsi`	IscsiDetails	In	ターゲット iSCSI デバイス。

6.108.7. enrollcertificate POST
リンクのコピー

ホストの証明書を登録します。有効期限が近づいている、またはすでに有効期限が切れているという警告が表示された場合に便利です。

Expand

表6.329 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	登録を非同期で実行する必要があるかどうかを示します。

6.108.8. fence POST
リンクのコピー

ホストの電源管理デバイスを制御します。

たとえば、ホストを起動するとします。これは、以下の方法で実行できます。

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<action>
  <fence_type>start</fence_type>
</action>
' \
"${url}/hosts/123/fence"

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<action>
  <fence_type>start</fence_type>
</action>
' \
"${url}/hosts/123/fence"

Copy to Clipboard

Toggle word wrap

Expand

表6.330 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	フェンシングを非同期で実行する必要があるかどうかを示します。
`fence_type`	String	In
`maintenance_after_restart`	ブール値	In	再起動後にホストをメンテナンスする必要があるかどうかを示します。
`power_management`	PowerManagement	Out

6.108.9. forceselectspm POST
リンクのコピー

ホストを Storage Pool Manager (SPM) として手動で設定します。

POST /ovirt-engine/api/hosts/123/forceselectspm

POST /ovirt-engine/api/hosts/123/forceselectspm

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<action/>

<action/>

Copy to Clipboard

Toggle word wrap

Expand

表6.331 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アクションを非同期で実行する必要があるかどうかを示します。

6.108.10. get GET
リンクのコピー

ホストの詳細を取得します。

GET /ovirt-engine/api/hosts/123

GET /ovirt-engine/api/hosts/123

Copy to Clipboard

Toggle word wrap

Expand

表6.332 パラメーターの概要
名前	型	方向	Summary
`all_content`	ブール値	In	ホストのすべての属性を応答に含めるかどうかを指定します。
`filter`	ブール値	In	ユーザーのパーミッションにしたがって、結果をフィルターする必要があるかどうかを示します。
`follow`	String	In	たどる必要のある内部リンクを指定します。
`host`	ホスト	Out	クエリーされたホスト。

6.108.10.1. all_content
リンクのコピー

ホストのすべての属性を応答に含めるかどうかを指定します。

デフォルトでは、以下の属性が除外されます。

hosted_engine

たとえば、ホスト '123' の完全な表現を取得するには、以下を実行します。

GET /ovirt-engine/api/hosts/123?all_content=true

GET /ovirt-engine/api/hosts/123?all_content=true

Copy to Clipboard

Toggle word wrap

注記

これらの属性は、取得後にパフォーマンスに影響を及ぼすため、デフォルトでは含まれていません。これらはめったに使用されず、データベースへの追加のクエリーを必要とします。このパラメーターは、特に必要な場合にのみ注意して使用してください。

6.108.10.2. follow
リンクのコピー

たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちらを参照してください。

6.108.11. install POST
リンクのコピー

最新バージョンの VDSM と関連ソフトウェアをホストにインストールします。

このアクションは、ホストをエンジンに追加するときに実行されるホスト上のすべての設定ステップ (kdump 設定、ホスト型エンジンのデプロイ、カーネルオプションの変更など) も実行します。

ホストタイプは、アクションの追加パラメーターを定義します。

curl と JSON を使用してホストをインストールする例、プレーン:

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--request PUT \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Version: 4" \
--user "admin@internal:..." \
--data '
{
  "root_password": "myrootpassword"
}
' \
"https://engine.example.com/ovirt-engine/api/hosts/123"

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--request PUT \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Version: 4" \
--user "admin@internal:..." \
--data '
{
  "root_password": "myrootpassword"
}
' \
"https://engine.example.com/ovirt-engine/api/hosts/123"

Copy to Clipboard

Toggle word wrap

ホスト型エンジンコンポーネントで curl と JSON を使用してホストをインストールする例:

curl \
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--request PUT \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Version: 4" \
--user "admin@internal:..." \
--data '
{
  "root_password": "myrootpassword"
"deploy_hosted_engine" : "true"
}
' \
"https://engine.example.com/ovirt-engine/api/hosts/123"

curl \
curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--request PUT \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Version: 4" \
--user "admin@internal:..." \
--data '
{
  "root_password": "myrootpassword"
"deploy_hosted_engine" : "true"
}
' \
"https://engine.example.com/ovirt-engine/api/hosts/123"

Copy to Clipboard

Toggle word wrap

重要

エンジンのバージョン 4.1.2 以降、ホストが再インストールされると、デフォルトでホストファイアウォールの定義をオーバーライドするようになりました。

Expand

表6.333 パラメーターの概要
名前	型	方向	Summary
`activate`	ブール値	In	'true' に設定すると、このホストはインストールの完了後にアクティブになります。
`async`	ブール値	In	インストールを非同期で実行する必要があるかどうかを示します。
`deploy_hosted_engine`	ブール値	In	`true` に設定すると、このホストは自己ホスト型エンジンコンポーネントもデプロイします。
`host`	ホスト	In	`override_iptables` プロパティーは、ファイアウォール設定をデフォルトの設定に置き換える必要があるかどうかを示すために使用されます。
`image`	String	In	{hypervisor-name} をインストールする場合、ISO イメージファイルが必要です。
`reboot`	ブール値	In	インストールに成功した後にホストを再起動するかどうかを示します。
`root_password`	String	In	SSH 経由でホストに接続するために使用される `root` ユーザーのパスワード。
`ssh`	Ssh	In	ホストへの接続に使用される SSH の詳細。
`undeploy_hosted_engine`	ブール値	In	`true` に設定すると、このホストは自己ホスト型エンジンコンポーネントをアンデプロイし、このホストは高可用性クラスターの一部として機能しなくなります。

6.108.11.1. activate
リンクのコピー

'true' に設定すると、このホストはインストールの完了後にアクティブになります。'false' に設定すると、ホストはインストール後も 'maintenance' ステータスのままになります。このパラメーターがない場合は 'true' と解釈されます。これは、望ましいデフォルトの動作がインストール後にホストをアクティブ化するからです。

6.108.11.2. deploy_hosted_engine
リンクのコピー

true に設定すると、このホストは自己ホスト型エンジンコンポーネントもデプロイします。欠落している値は true、つまりデプロイとして扱われます。このパラメーターを省略すると、false を意味し、セルフホスト型エンジン領域での操作は一切行われません。

6.108.11.3. reboot
リンクのコピー

インストールに成功した後にホストを再起動するかどうかを示します。デフォルト値は true です。

6.108.11.4. undeploy_hosted_engine
リンクのコピー

true に設定すると、このホストは自己ホスト型エンジンコンポーネントをアンデプロイし、このホストは高可用性クラスターの一部として機能しなくなります。欠落している値は true、つまりアンデプロイとして扱われます。このパラメーターを省略すると、false を意味し、セルフホスト型エンジン領域での操作は一切行われません。

6.108.12. iscsidiscover POST
リンクのコピー

このメソッドは、Engine バージョン 4.4.6 以降非推奨となりました。代わりに DiscoverIscsi を使用する必要があります。

イニシエーターの詳細を使用して、ホスト上の iSCSI ターゲットを検出します。検出されたデータを含む文字列の配列を返します。

たとえば、myiscsi.example.com で利用可能な iSCSI ターゲットをホスト 123 から検出するには、次のようなリクエストを送信します。

POST /ovirt-engine/api/hosts/123/iscsidiscover

POST /ovirt-engine/api/hosts/123/iscsidiscover

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<action>
  <iscsi>
    <address>myiscsi.example.com</address>
  </iscsi>
</action>

<action>
  <iscsi>
    <address>myiscsi.example.com</address>
  </iscsi>
</action>

Copy to Clipboard

Toggle word wrap

Expand

表6.334 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	検出を非同期で実行する必要があるかどうかを示します。
`iscsi`	IscsiDetails	In	ターゲット iSCSI デバイス。
`iscsi_targets`	String[]	Out	iSCSI ターゲット。

6.108.12.1. iscsi_targets
リンクのコピー

iSCSI ターゲット。*

6.108.13. iscsilogin POST
リンクのコピー

ターゲットの詳細を使用して、ホストの iSCSI ターゲットにログインします。

重要

このメソッドを使用してログインする場合は、discoveriscsi メソッドで検出された iSCSI ターゲットの詳細を使用する必要があります。

Expand

表6.335 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	ログインを非同期で実行する必要があるかどうかを示します。
`iscsi`	IscsiDetails	In	ターゲット iSCSI デバイス。

6.108.14. refresh POST
リンクのコピー

ホストデバイスと機能を更新します。

Expand

表6.336 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	リフレッシュを非同期で実行する必要があるかどうかを示します。

6.108.15. remove DELETE
リンクのコピー

システムからホストを削除します。

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request DELETE \
--header "Version: 4" \
"${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc"

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request DELETE \
--header "Version: 4" \
"${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc"

Copy to Clipboard

Toggle word wrap

Expand

表6.337 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	削除を非同期的に実行するかどうかを指定します。
`force`	ブール値	In	ホストが応答しない場合、またはホストが Gluster Storage クラスターの一部であり、ボリュームブリックがある場合でも、ホストを削除する必要があることを示します。

6.108.16. setupnetworks POST
リンクのコピー

この方法は、ホストのネットワークインターフェイスの設定を変更するために使用されます。

たとえば、3 つのネットワークインターフェイス eth0、eth1、および eth2 を持つホストがあり、eth0 と eth1 を使用して新しいボンディングを設定し、その上に VLAN を配置するとします。簡単なシェルスクリプトと curl コマンドライン HTTP クライアントを使用すると、以下のように実行できます。

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<action>
  <modified_bonds>
    <host_nic>
      <name>bond0</name>
      <bonding>
        <options>
          <option>
            <name>mode</name>
            <value>4</value>
          </option>
          <option>
            <name>miimon</name>
            <value>100</value>
          </option>
        </options>
        <slaves>
          <host_nic>
            <name>eth1</name>
          </host_nic>
          <host_nic>
            <name>eth2</name>
          </host_nic>
        </slaves>
      </bonding>
    </host_nic>
  </modified_bonds>
  <modified_network_attachments>
    <network_attachment>
      <network>
        <name>myvlan</name>
      </network>
      <host_nic>
        <name>bond0</name>
      </host_nic>
      <ip_address_assignments>
        <ip_address_assignment>
          <assignment_method>static</assignment_method>
          <ip>
            <address>192.168.122.10</address>
            <netmask>255.255.255.0</netmask>
          </ip>
        </ip_address_assignment>
      </ip_address_assignments>
      <dns_resolver_configuration>
        <name_servers>
          <name_server>1.1.1.1</name_server>
          <name_server>2.2.2.2</name_server>
        </name_servers>
      </dns_resolver_configuration>
    </network_attachment>
  </modified_network_attachments>
 </action>
' \
"${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc/setupnetworks"

#!/bin/sh -ex

url="https://engine.example.com/ovirt-engine/api"
user="admin@internal"
password="..."

curl \
--verbose \
--cacert /etc/pki/ovirt-engine/ca.pem \
--user "${user}:${password}" \
--request POST \
--header "Version: 4" \
--header "Content-Type: application/xml" \
--header "Accept: application/xml" \
--data '
<action>
  <modified_bonds>
    <host_nic>
      <name>bond0</name>
      <bonding>
        <options>
          <option>
            <name>mode</name>
            <value>4</value>
          </option>
          <option>
            <name>miimon</name>
            <value>100</value>
          </option>
        </options>
        <slaves>
          <host_nic>
            <name>eth1</name>
          </host_nic>
          <host_nic>
            <name>eth2</name>
          </host_nic>
        </slaves>
      </bonding>
    </host_nic>
  </modified_bonds>
  <modified_network_attachments>
    <network_attachment>
      <network>
        <name>myvlan</name>
      </network>
      <host_nic>
        <name>bond0</name>
      </host_nic>
      <ip_address_assignments>
        <ip_address_assignment>
          <assignment_method>static</assignment_method>
          <ip>
            <address>192.168.122.10</address>
            <netmask>255.255.255.0</netmask>
          </ip>
        </ip_address_assignment>
      </ip_address_assignments>
      <dns_resolver_configuration>
        <name_servers>
          <name_server>1.1.1.1</name_server>
          <name_server>2.2.2.2</name_server>
        </name_servers>
      </dns_resolver_configuration>
    </network_attachment>
  </modified_network_attachments>
 </action>
' \
"${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc/setupnetworks"

Copy to Clipboard

Toggle word wrap

注記

これは、API のバージョン 4 で有効です。以前のバージョンでは、一部の要素は XML 要素ではなく XML 属性として表されていました。特に、options と ip 要素は次のように表されました。

<options name="mode" value="4"/>
<options name="miimon" value="100"/>
<ip address="192.168.122.10" netmask="255.255.255.0"/>

<options name="mode" value="4"/>
<options name="miimon" value="100"/>
<ip address="192.168.122.10" netmask="255.255.255.0"/>

Copy to Clipboard

Toggle word wrap

次のコードで Python SDK を使用しても、同じことができます。

Find the service that manages the collection of hosts:
Find the host:
Find the service that manages the host:
Configure the network adding a bond with two slaves and attaching it to a
network with an static IP address:
After modifying the network configuration it is very important to make it
persistent:

# Find the service that manages the collection of hosts:
hosts_service = connection.system_service().hosts_service()

# Find the host:
host = hosts_service.list(search='name=myhost')[0]

# Find the service that manages the host:
host_service = hosts_service.host_service(host.id)

# Configure the network adding a bond with two slaves and attaching it to a
# network with an static IP address:
host_service.setup_networks(
    modified_bonds=[
        types.HostNic(
            name='bond0',
            bonding=types.Bonding(
                options=[
                    types.Option(
                        name='mode',
                        value='4',
                    ),
                    types.Option(
                        name='miimon',
                        value='100',
                    ),
                ],
                slaves=[
                    types.HostNic(
                        name='eth1',
                    ),
                    types.HostNic(
                        name='eth2',
                    ),
                ],
            ),
        ),
    ],
    modified_network_attachments=[
        types.NetworkAttachment(
            network=types.Network(
                name='myvlan',
            ),
            host_nic=types.HostNic(
                name='bond0',
            ),
            ip_address_assignments=[
                types.IpAddressAssignment(
                    assignment_method=types.BootProtocol.STATIC,
                    ip=types.Ip(
                        address='192.168.122.10',
                        netmask='255.255.255.0',
                    ),
                ),
            ],
            dns_resolver_configuration=types.DnsResolverConfiguration(
                name_servers=[
                    '1.1.1.1',
                    '2.2.2.2',
                ],
            ),
        ),
    ],
)

# After modifying the network configuration it is very important to make it
# persistent:
host_service.commit_net_config()

Copy to Clipboard

Toggle word wrap

重要

ネットワーク設定がホストに保存されていること、およびホストの再起動時に適用されることを確認するには、commitnetconfig を呼び出すことを忘れないでください。

重要

Expand

表6.338 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アクションを非同期で実行する必要があるかどうかを示します。
`check_connectivity`	ブール値	In
`commit_on_success`	ブール値	In	セットアップが完了し、{hypervisor-name} と Red Hat Virtualization Manager 間の接続が再確立され、個別の commitnetconfig リクエストを待つことなく、設定を {hypervisor-name} に自動的に保存するかどうかを指定します。
`connectivity_timeout`	Integer	In
`modified_bonds`	HostNic[]	In
`modified_labels`	NetworkLabel[]	In
`modified_network_attachments`	NetworkAttachment[]	In
`removed_bonds`	HostNic[]	In
`removed_labels`	NetworkLabel[]	In
`removed_network_attachments`	NetworkAttachment[]	In
`synchronized_network_attachments`	NetworkAttachment[]	In	同期されるネットワーク接続のリスト。

6.108.16.1. commit_on_success
リンクのコピー

セットアップが完了し、{hypervisor-name} と Red Hat Virtualization Manager 間の接続が再確立され、個別の commitnetconfig リクエストを待つことなく、設定を {hypervisor-name} に自動的に保存するかどうかを指定します。デフォルト値は false です。これは、設定が自動的に保存されないことを意味します。

6.108.17. syncallnetworks POST
リンクのコピー

ホスト上の全ネットワークを同期するには、以下のような要求を送信します。

POST /ovirt-engine/api/hosts/123/syncallnetworks

POST /ovirt-engine/api/hosts/123/syncallnetworks

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<action/>

<action/>

Copy to Clipboard

Toggle word wrap

Expand

表6.339 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アクションを非同期で実行する必要があるかどうかを示します。

6.108.18. unregisteredstoragedomainsdiscover POST
リンクのコピー

設定にインポートする候補であるブロックストレージドメインを検出します。FCP の場合は、引数は必要ありません。

Expand

表6.340 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	検出を非同期で実行する必要があるかどうかを示します。
`iscsi`	IscsiDetails	In
`storage_domains`	StorageDomain[]	Out

6.108.19. update PUT
リンクのコピー

ホストのプロパティーを更新します。

たとえば、ホストのカーネルコマンドラインを更新するには、以下のようなリクエストを送信します。

PUT /ovirt-engine/api/hosts/123

PUT /ovirt-engine/api/hosts/123

Copy to Clipboard

Toggle word wrap

リクエスト本文は以下のようになります。

<host>
  <os>
    <custom_kernel_cmdline>vfio_iommu_type1.allow_unsafe_interrupts=1</custom_kernel_cmdline>
  </os>
</host>

<host>
  <os>
    <custom_kernel_cmdline>vfio_iommu_type1.allow_unsafe_interrupts=1</custom_kernel_cmdline>
  </os>
</host>

Copy to Clipboard

Toggle word wrap

Expand

表6.341 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	更新を非同期的に実行するかどうかを指定します。
`host`	ホスト	In/Out

6.108.20. upgrade POST
リンクのコピー

ホストで VDSM および選択したソフトウェアをアップグレードします。

Expand

表6.342 パラメーターの概要
名前	型	方向	Summary
`async`	ブール値	In	アップグレードを非同期で実行する必要があるかどうかを示します。
`image`	String	In	Vintage Node はサポートされなくなり、非推奨になったため、このプロパティーは関連しなくなりました。
`reboot`	ブール値	In	アップグレード後にホストを再起動する必要があるかどうかを示します。
`timeout`	Integer	In	アップグレードのタイムアウト。

6.108.20.1. reboot
リンクのコピー

アップグレード後にホストを再起動する必要があるかどうかを示します。デフォルトでは、ホストは再起動されます。

注記

{hypervisor-name} の場合、このパラメーターは無視されます。{hypervisor-name} は、アップグレード後に常に再起動されます。

6.108.20.2. timeout
リンクのコピー

アップグレードのタイムアウト。

アップグレードが完了するまでの最大待機時間 (分単位)。デフォルト値は ANSIBLE_PLAYBOOK_EXEC_DEFAULT_TIMEOUT 設定オプションで指定します。

6.108.21. upgradecheck POST
リンクのコピー

ホストにアップグレードが利用可能であるかどうかを確認します。利用可能なアップグレードがある場合は、管理ポータルのホストステータスアイコンの横にアイコンが表示されます。また、アップグレードの可否を示す監査ログメッセージも追加されます。アップグレードは、webadmin から、またはアップグレードホストアクションを使用して開始できます。

トップに戻る

6.108. ホスト

6.108.1. activate POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.2. approve POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.2.1. activateリンクのコピーリンクがクリップボードにコピーされました!

6.108.2.2. rebootリンクのコピーリンクがクリップボードにコピーされました!

6.108.3. commitnetconfig POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.4. copyhostnetworks POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.5. deactivate POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.5.1. stop_gluster_serviceリンクのコピーリンクがクリップボードにコピーされました!

6.108.6. discoveriscsi POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.7. enrollcertificate POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.8. fence POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.9. forceselectspm POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.10. get GETリンクのコピーリンクがクリップボードにコピーされました!

6.108.10.1. all_contentリンクのコピーリンクがクリップボードにコピーされました!

6.108.10.2. followリンクのコピーリンクがクリップボードにコピーされました!

6.108.11. install POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.11.1. activateリンクのコピーリンクがクリップボードにコピーされました!

6.108.11.2. deploy_hosted_engineリンクのコピーリンクがクリップボードにコピーされました!

6.108.11.3. rebootリンクのコピーリンクがクリップボードにコピーされました!

6.108.11.4. undeploy_hosted_engineリンクのコピーリンクがクリップボードにコピーされました!

6.108.12. iscsidiscover POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.12.1. iscsi_targetsリンクのコピーリンクがクリップボードにコピーされました!

6.108.13. iscsilogin POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.14. refresh POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.15. remove DELETEリンクのコピーリンクがクリップボードにコピーされました!

6.108.16. setupnetworks POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.16.1. commit_on_successリンクのコピーリンクがクリップボードにコピーされました!

6.108.17. syncallnetworks POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.18. unregisteredstoragedomainsdiscover POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.19. update PUTリンクのコピーリンクがクリップボードにコピーされました!

6.108.20. upgrade POSTリンクのコピーリンクがクリップボードにコピーされました!

6.108.20.1. rebootリンクのコピーリンクがクリップボードにコピーされました!

6.108.20.2. timeoutリンクのコピーリンクがクリップボードにコピーされました!

6.108.21. upgradecheck POSTリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

6.108.1. activate POST
リンクのコピー

6.108.2. approve POST
リンクのコピー

6.108.2.1. activate
リンクのコピー

6.108.2.2. reboot
リンクのコピー

6.108.3. commitnetconfig POST
リンクのコピー

6.108.4. copyhostnetworks POST
リンクのコピー

6.108.5. deactivate POST
リンクのコピー

6.108.5.1. stop_gluster_service
リンクのコピー

6.108.6. discoveriscsi POST
リンクのコピー

6.108.7. enrollcertificate POST
リンクのコピー

6.108.8. fence POST
リンクのコピー

6.108.9. forceselectspm POST
リンクのコピー

6.108.10. get GET
リンクのコピー

6.108.10.1. all_content
リンクのコピー

6.108.10.2. follow
リンクのコピー

6.108.11. install POST
リンクのコピー

6.108.11.1. activate
リンクのコピー

6.108.11.2. deploy_hosted_engine
リンクのコピー

6.108.11.3. reboot
リンクのコピー

6.108.11.4. undeploy_hosted_engine
リンクのコピー

6.108.12. iscsidiscover POST
リンクのコピー

6.108.12.1. iscsi_targets
リンクのコピー

6.108.13. iscsilogin POST
リンクのコピー

6.108.14. refresh POST
リンクのコピー

6.108.15. remove DELETE
リンクのコピー

6.108.16. setupnetworks POST
リンクのコピー

6.108.16.1. commit_on_success
リンクのコピー

6.108.17. syncallnetworks POST
リンクのコピー

6.108.18. unregisteredstoragedomainsdiscover POST
リンクのコピー

6.108.19. update PUT
リンクのコピー

6.108.20. upgrade POST
リンクのコピー

6.108.20.1. reboot
リンクのコピー

6.108.20.2. timeout
リンクのコピー

6.108.21. upgradecheck POST
リンクのコピー