7.35. Cluster 構造体
クラスターのタイプの表現。
クラスターの JSON の表現。
{
"cluster" : [ {
"ballooning_enabled" : "false",
"cpu" : {
"architecture" : "x86_64",
"type" : "Intel SandyBridge Family"
},
"custom_scheduling_policy_properties" : {
"property" : [ {
"name" : "HighUtilization",
"value" : "80"
}, {
"name" : "CpuOverCommitDurationMinutes",
"value" : "2"
} ]
},
"error_handling" : {
"on_error" : "migrate"
},
"fencing_policy" : {
"enabled" : "true",
"skip_if_connectivity_broken" : {
"enabled" : "false",
"threshold" : "50"
},
"skip_if_gluster_bricks_up" : "false",
"skip_if_gluster_quorum_not_met" : "false",
"skip_if_sd_active" : {
"enabled" : "false"
}
},
"gluster_service" : "false",
"firewall_type" : "iptables",
"ha_reservation" : "false",
"ksm" : {
"enabled" : "true",
"merge_across_nodes" : "true"
},
"memory_policy" : {
"over_commit" : {
"percent" : "100"
},
"transparent_hugepages" : {
"enabled" : "true"
}
},
"migration" : {
"auto_converge" : "inherit",
"bandwidth" : {
"assignment_method" : "auto"
},
"compressed" : "inherit",
"policy" : {
"id" : "00000000-0000-0000-0000-000000000000"
}
},
"required_rng_sources" : {
"required_rng_source" : [ "random" ]
},
"switch_type" : "legacy",
"threads_as_cores" : "false",
"trusted_service" : "false",
"tunnel_migration" : "false",
"version" : {
"major" : "4",
"minor" : "1"
},
"virt_service" : "true",
"data_center" : {
"href" : "/ovirt-engine/api/datacenters/123",
"id" : "123"
},
"mac_pool" : {
"href" : "/ovirt-engine/api/macpools/456",
"id" : "456"
},
"scheduling_policy" : {
"href" : "/ovirt-engine/api/schedulingpolicies/789",
"id" : "789"
},
"actions" : {
"link" : [ {
"href" : "/ovirt-engine/api/clusters/234/resetemulatedmachine",
"rel" : "resetemulatedmachine"
} ]
},
"name" : "Default",
"description" : "The default server cluster",
"href" : "/ovirt-engine/api/clusters/234",
"id" : "234",
"link" : [ {
"href" : "/ovirt-engine/api/clusters/234/permissions",
"rel" : "permissions"
}, {
"href" : "/ovirt-engine/api/clusters/234/cpuprofiles",
"rel" : "cpuprofiles"
}, {
"href" : "/ovirt-engine/api/clusters/234/networkfilters",
"rel" : "networkfilters"
}, {
"href" : "/ovirt-engine/api/clusters/234/networks",
"rel" : "networks"
}, {
"href" : "/ovirt-engine/api/clusters/234/affinitygroups",
"rel" : "affinitygroups"
}, {
"href" : "/ovirt-engine/api/clusters/234/glusterhooks",
"rel" : "glusterhooks"
}, {
"href" : "/ovirt-engine/api/clusters/234/glustervolumes",
"rel" : "glustervolumes"
}, {
"href" : "/ovirt-engine/api/clusters/234/enabledfeatures",
"rel" : "enabledfeatures"
}, {
"href" : "/ovirt-engine/api/clusters/234/externalnetworkproviders",
"rel" : "externalnetworkproviders"
} ]
} ]
}| 名前 | タイプ | 概要 |
|---|---|---|
|
| ||
|
| チップセットと BIOS タイプの組み合わせ。 | |
|
| このオブジェクトに関するコメントを含むフリーテキスト。 | |
|
| ||
|
| クラスターのカスタムスケジューリングポリシーのプロパティー。 | |
|
| プレーンテキストでの人間が判読できる説明。 | |
|
| ||
|
| ||
|
| クラスターに対してカスタムフェンシングポリシーを定義できます。 | |
|
| クラスターの FIPS モード。 | |
|
| このクラスター内のホストで使用されるファイアウォールのタイプ。 | |
|
| ||
|
| 調整済みプロファイルの名前。 | |
|
| ||
|
| 一意の ID | |
|
| ||
|
| 監査ログイベントを記録するためのメモリー消費のしきい値。 | |
|
| 監査ログイベントをログに記録するためのメモリー消費しきい値のタイプ。 | |
|
| このプロパティーは関連性がなくなり、非推奨になりました。 | |
|
| ||
|
| 実行中の仮想マシンを別のホストに移行するためのクラスター全体の設定への参照。 | |
|
| 人間が判読できるプレーンテキストでの名前。 | |
|
| このプロパティーは関連性がなくなり、非推奨になりました。 | |
|
| クラスター内の各ホストに必要な乱数ジェネレーター (RNG) ソースのセット。 | |
|
| ||
|
| ||
|
| 指定されたクラスター内のすべてのネットワークで使用されるスイッチのタイプ。 | |
|
| ||
|
| ||
|
| ||
|
| アップグレード相関識別子。 | |
|
| クラスターのアップグレードが開始されたかどうかを示します。 | |
|
| アップグレードが進行中の場合、報告されたアップグレードの完了率。 | |
|
| クラスターの互換バージョン。 | |
|
| ||
|
| VNC 暗号化を有効にします。 |
7.35.1. bios_type
チップセットと BIOS タイプの組み合わせ。
この値は、biosType が CLUSTER_DEFAULT に設定されているクラスター内のすべての仮想マシンのデフォルトとして使用されます。
7.35.2. custom_scheduling_policy_properties
クラスターのカスタムスケジューリングポリシーのプロパティー。これらのオプションのプロパティーは、scheduling_policy リンクで指定されたスケジューリングポリシーのプロパティーをオーバーライドし、この特定のクラスターにのみ適用されます。
たとえば、クラスターのカスタムプロパティーを更新するには、以下のリクエストを送信します。
PUT /ovirt-engine/api/clusters/123
リクエスト本文は以下のようになります。
<cluster>
<custom_scheduling_policy_properties>
<property>
<name>HighUtilization</name>
<value>70</value>
</property>
</custom_scheduling_policy_properties>
</cluster>
custom_scheduling_policy_properties 属性を使用した更新操作では、scheduling_policy リンクで指定されたスケジューリングポリシーのプロパティーは更新されず、この特定のクラスターにのみ反映されます。
7.35.3. fencing_policy
クラスターに対してカスタムフェンシングポリシーを定義できます。
以下はその例です。
PUT /ovirt-engine/api/cluster/123
リクエスト本文は以下のようになります。
<cluster>
<fencing_policy>
<enabled>true</enabled>
<skip_if_sd_active>
<enabled>false</enabled>
</skip_if_sd_active>
<skip_if_connectivity_broken>
<enabled>false</enabled>
<threshold>50</threshold>
</skip_if_connectivity_broken>
</fencing_policy>
</cluster>7.35.4. fips_mode
クラスターの FIPS モード。
FIPS モードは、ホストに対するクラスターのポリシーを表します。クラスターに追加されたホストは、クラスターの FIPS モードを満たしているかどうかがチェックされ、満たしていない場合は操作不能になります。値が明示的に指定されない限り、新しいクラスターはデフォルトで UNDEFINED に初期化されます。この値は、クラスターに追加された最初のホストの FIPS モードに自動的に変更されます。
7.35.5. gluster_tuned_profile
調整済みプロファイルの名前。
クラスター内のすべてのホストに設定するように 調整 されたプロファイル。これは必須ではなく、Gluster サービスを使用するクラスターにのみ関連します。
7.35.6. log_max_memory_used_threshold
監査ログイベントを記録するためのメモリー消費のしきい値。
パーセンテージの場合、使用メモリーが指定された値を超えると、監査ログイベントがログに記録されます。絶対値の場合、空きメモリーが MB で指定された値を下回ると、監査ログイベントがログに記録されます。
7.35.7. log_max_memory_used_threshold_type
監査ログイベントをログに記録するためのメモリー消費しきい値のタイプ。
percentage と absolute_value_in_mb のいずれかを選択できます。
7.35.8. maintenance_reason_required
このプロパティーは関連性がなくなり、非推奨になりました。デフォルト値は true です。
7.35.9. migration
実行中の仮想マシンを別のホストに移行するためのクラスター全体の設定への参照。
このメソッドが返す ID で移行ポリシーを照会する API はまだ実装されていません。/ovirt-engine/api/options/MigrationPolicies を使用して、すべての移行ポリシーとその ID のリストを取得します。
7.35.10. optional_reason
このプロパティーは関連性がなくなり、非推奨になりました。デフォルト値は true です。
7.35.11. required_rng_sources
クラスター内の各ホストに必要な乱数ジェネレーター (RNG) ソースのセット。
読み取られると、暗黙的な urandom (クラスターバージョン 4.1 以降の場合) または random (クラスターバージョン 4.0 以前の場合) に加えて、選択された RNG ソースが追加で返されます。書き込まれると、暗黙的な urandom と random RNG ソースは削除できません。
エンジンのバージョン 4.1 より前では、必要な乱数ジェネレーターのセットは管理者によって完全に制御可能で、random ソースを含む任意のソースを追加または削除できます。しかし、バージョン 4.1 以降では、urandom と random ソースは常にセットの一部となり、削除することはできません。
エンジンバージョン 4.1 では、クラスター内の random RNG ソースを互換バージョン 4.1 以降に置き換える新しい RNG ソース urandom が導入されています。
7.35.12. upgrade_correlation_id
アップグレード相関識別子。クラスターのアップグレードの詳細を示すイベントをアップグレード自体に関連付けるために使用します。
7.35.13. version
クラスターの互換バージョン。
このクラスター内のすべてのホストは、少なくともこの互換バージョンをサポートする必要があります。
以下はその例です。
GET /ovirt-engine/api/clusters/123
次のように応答します。
<cluster>
...
<version>
<major>4</major>
<minor>0</minor>
</version>
...
</cluster>互換バージョンを更新するには、以下を使用します。
PUT /ovirt-engine/api/clusters/123
リクエスト本文は以下のようになります。
<cluster>
<version>
<major>4</major>
<minor>1</minor>
</version>
</cluster>クラスター互換バージョンを更新するには、クラスター内のすべてのホストが新しい互換バージョンをサポートする必要があります。
7.35.14. vnc_encryption
VNC 暗号化を有効にします。このプロパティーのデフォルト値は false です。
| 名前 | タイプ | 概要 |
|---|---|---|
|
| ||
|
| ||
|
| ||
|
| クラスターで有効になっているカスタム機能。 | |
|
| クラスターで利用可能な外部ネットワークプロバイダーへの参照。 | |
|
| ||
|
| ||
|
| このクラスターによって使用される MAC プールへの参照。 | |
|
| ||
|
| ||
|
| ||
|
| ||
|
| このクラスターによって使用されるデフォルトのスケジューリングポリシーへの参照。 |
7.35.15. external_network_providers
クラスターで利用可能な外部ネットワークプロバイダーへの参照。
外部ネットワークプロバイダーの自動デプロイメントがサポートされる場合には、参照されるネットワークプロバイダーのネットワークはクラスター内のすべてのノードで利用可能になります。クラスターの外部ネットワークプロバイダーは、クラスターの追加 時にのみ設定できます。この値は ホストの追加 時に個々のホストに対して上書きされる場合があります。
7.35.16. scheduling_policy
このクラスターによって使用されるデフォルトのスケジューリングポリシーへの参照。
スケジューリングポリシープロパティーは、デフォルトで参照されるスケジューリングポリシーから取得されますが、このクラスターの custom_scheduling_policy_properties 属性で指定されたプロパティーで上書きされます。
