6.205. StorageDomain

ストレージドメインの説明を取得します。

ストレージサーバーの一部である is_attached ブール値フィールドを使用して、ストレージドメインがすでにデータセンターにアタッチされているかどうかをクエリーするために使用されます。重要: この API を実行すると、ホストがストレージドメインから切断されます。

この操作により、ストレージドメインから論理ユニットが削減されます。

そのために、提供された論理ユニットに保存されているデータは、ストレージドメインの他の論理ユニットに移動され、その後、ストレージドメインから削減されます。

たとえば、ストレージドメインから 2 つの論理ユニットを削減するには、次のようなリクエストを送信します。

POST /ovirt-engine/api/storageDomains/123/reduceluns

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

 <action>
   <logical_units>
     <logical_unit id="1IET_00010001"/>
     <logical_unit id="1IET_00010002"/>
   </logical_units>
 </action>

Note that this operation is only applicable to block storage domains (i.e., storage domains with the
xref:types-storage_type[storage type] of iSCSI or FCP).

この操作により、LUN サイズが更新されます。

ストレージサーバーの基盤となる LUN のサイズを増やした後、ユーザーは LUN サイズを更新できます。このアクションは、提供された LUN の再スキャンを強制し、必要に応じて新しいサイズでデータベースを更新します。

たとえば、2 つの LUN のサイズを更新するには、以下のようなリクエストを送信します。

POST /ovirt-engine/api/storageDomains/262b056b-aede-40f1-9666-b883eff59d40/refreshluns

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

 <action>
   <logical_units>
     <logical_unit id="1IET_00010001"/>
     <logical_unit id="1IET_00010002"/>
   </logical_units>
 </action>

ストレージドメインを削除します。

特別なパラメーターがない場合、ストレージドメインはシステムから切り離され、データベースから削除されます。その後、ストレージドメインは、同じセットアップまたは別のセットアップに、すべてのデータとともにインポートできます。ストレージにアクセスできない場合、操作は失敗します。

destroy パラメーターが true の場合、ストレージにアクセスできない場合でも、操作は常に成功し、失敗は無視され、いずれにせよストレージドメインはデータベースから削除されます。

format パラメーターが true の場合、実際のストレージがフォーマットされ、LUN またはディレクトリーからメタデータが削除されるため、同じセットアップまたは異なるセットアップにインポートできません。

DELETE /ovirt-engine/api/storageDomains/123?destroy=true

DELETE /ovirt-engine/api/storageDomains/123?host=myhost

ストレージドメインを更新します。

StorageDomain の属性のすべてが、作成後に更新可能なわけではありません。更新できるのは、name、description、comment、warning_low_space_indicator、critical_space_action_blocker、および wipe_after_delete です。(wipe_after_delete 属性を変更しても、すでに存在するディスクの wipe after delete プロパティーは変更されないことに注意してください)。

識別子 123 を持つストレージドメインの name 属性と wipe_after_delete 属性を更新するには、以下のようにリクエストを送信する。

PUT /ovirt-engine/api/storageDomains/123

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

<storage_domain>
  <name>data2</name>
  <wipe_after_delete>true</wipe_after_delete>
</storage_domain>

この操作により、このストレージドメインの OVF_STORE が強制的に更新されます。

OVF_STORE は、ストレージドメインに存在する仮想マシンとディスクのメタデータを格納したディスクイメージです。このメタデータは、ドメインが別のデータセンターまたは別のインストールとの間でインポートまたはエクスポートされる場合に使用されます。

デフォルトでは、OVF_STORE は定期的に更新されますが (デフォルトでは 60 分に設定)、重要な変更後や OVF_STORE が破損していると思われる場合に、ユーザーは更新を強制する必要があることもあります。

ユーザーによって開始された場合、OVF_STORE 更新は、更新の必要性の有無にかかわらず実行されます。