13.3. メソッド

13.3.1. 新規ストレージ接続の作成

新規ストレージ接続を作成するには、POST 要求が必要です。
ストレージドメインを追加せずに新規ストレージ接続を作成することが可能です。ホストの id または name はオプションです。指定した場合には、そのホストを介してストレージへの接続を試みます。

例13.2 新規ストレージ接続の作成

POST /api/storageconnections HTTP/1.1
Accept: application/xml
Content-type: application/xml

<storage_connection>
   <type>nfs</type>
   <address>domain.example.com</address>
   <path>/export/storagedata/username/data</path>
   <host>
     <name>Host_Name</name>
   </host>
</storage_connection>

13.3.2. ストレージ接続の削除

ストレージ接続の削除には DELETE 要求が必要です。ストレージ接続は、ストレージドメインと LUN ディスクのどちらもそのストレージ接続を参照していない場合にのみ削除することができます。
ホストの name と id はオプションです。指定した場合には、接続はそのホストからアンマウントされます。

例13.3 ストレージ接続の削除

DELETE /api/storageconnections/Storage_Connection_ID HTTP/1.1
Accept: application/xml
Content-type: application/xml

<host>
  <name>Host_Name</name>
</host>

13.3.3. ストレージ接続の更新

既存のストレージ接続を更新するには PUT 要求が必要です。接続を正しく更新するには、ストレージドメインはメンテナンスモードに入っているか、デタッチされている状態でなければなりません。
ホストの name または id の指定はオプションです。指定した場合には、ホストが更新されたストレージ情報への接続を試みます。

例13.4 ストレージ接続の更新

PUT /api/storageconnections/Storage_Connection_ID HTTP/1.1
Accept: application/xml
Content-type: application/xml

<storage_connection>   
  <address>updated.example.domain.com</address>
  <host>
      <name>Host_name</name>
   </host>
</storage_connection>

13.3.4. iSCSI ストレージ接続の更新

既存の iSCSI ストレージ接続を更新するには PUT 要求が必要です。接続を正しく更新するには、iSCSI ストレージドメインはメンテナンスモードに入っているか、デタッチされている状態でなければなりません。

例13.5 ストレージ接続の更新

PUT /api/storageconnections/Storage_Connection_ID HTTP/1.1
Accept: application/xml
Content-type: application/xml

<storage_connection>   
  <port>3456</port>
</storage_connection>

13.3.5. 既存のストレージ接続を使用する新規ストレージドメインの追加

既存のストレージ接続を使用する新規ストレージドメインを追加するには、POST 要求が必要です。これはファイルベースのストレージドメイン (NFS、POSIX、および local) にのみ適用することができます。

例13.6 既存のストレージ接続を使用する新規ストレージドメインの追加

POST /api/storagedomains HTTP/1.1
Accept: application/xml
Content-type: application/xml

<storage_domain>
  <name>New_Domain</name>
  <type>data</type>
 <storage id="Storage_Connection_ID"/>
  <host>
    <name>Host_Name</name>
  </host>
</storage_domain>

13.3.6. iSCSI ストレージへの追加ストレージ接続のアタッチ

iSCSI ストレージドメインに追加のストレージ接続をアタッチするには POST 要求が必要です。

例13.7 iSCSI ストレージへの追加ストレージ接続のアタッチ

POST /api/storagedomains/iSCSI_Domain_ID/storageconnections HTTP/1.1
Accept: application/xml
Content-type: application/xml

<storage_connection id="Storage_Connection_ID">
</storage_connection>

13.3.7. iSCSI ストレージからのストレージ接続のデタッチ

iSCSI ストレージドメインからストレージ接続をデタッチするには DELETE 要求が必要です。

例13.8 iSCSI ストレージからのストレージ接続のデタッチ

DELETE /api/storagedomains/iSCSI_Domain_ID/storageconnections/Storage_Connection_ID HTTP/1.1
Accept: application/xml
Content-type: application/xml

13.3.8. iSCSI ターゲットへの認証情報の定義

管理ポータルを使用して iSCSI ストレージドメインを追加すると、ユーザー名とパスワード 1 つずつしかそのドメインに指定できませんが、設定によっては、クラスター内のホストごとに別のユーザー名とパスワードが必要なものもあります。storageconnectionextensions 要素を使用すると、ホストごとに、固有の認証情報を各 iSCSI ターゲットに適用することができます。

例13.9 iSCSI ターゲットへの認証情報の定義

POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/storageconnectionextensions HTTP/1.1
Accept: application/xml
Content-type: application/xml

<storageconnectionextension>
    <target>iqn.2010.05.com.example:iscsi.targetX</target>
    <username>jimmy</username>
    <password>p@55w0Rd!</password>
</storageconnectionextension>