複数Host Connectionの作成

POST /connection/host/{host_id}/volume

概要説明

host_idで指定したHostに関するConnectionを作成します。

注意

  • 指定Hostに複数のLUN GroupがAffinity設定されている場合は、RESTful API非サポートな構成のためエラー応答します。

  • Hostの情報にshared_host_href_listが応答されるHostの場合、Connectionの設定を行うとほかのHostのConnectionにも影響が出ます。それでもConnectionを設定したい場合は、forceパラメーターにtrueを設定する必要があります。

  • 接続するCA Portの指定はできません。以下の条件のCA Portと自動でConnection設定します。

    • Affinity ModeがEnableである。

    • 指定Hostと接続されている。

    • Portの動作ModeがCAまたはCARAである。

    • Storage Cluster機能で使用されていない。

  • CA Portに接続可能なHost数には上限があります。上限を超えたCA PortとはConnection設定を行わず、正常終了します。どのCA PortとConnection設定されているかは、応答Resourceの情報を参照ください。

  • 以下のConnectionを作成することはできません。作成したい場合は、ETERNUS SF Storage Cruiser を使用してください。

    • Storage Clusterで使用するConnection

    • VVOLで使用するConnection (VVOL Access Pathの設定)

  • 一度の操作で同時に接続可能なVolume数の最大は128です。

  • 使用可能なHLUNは0から255です。256以上のHLUNを使用したい場合、または256個以上のVolumeをHostに接続したい場合は、Host ResponseのLUN AddressingをFlat Space AddressingであるHost Responseに変更してください。

  • LUN Group作成完了後にAffinity設定がエラーした場合は、作成されたLUN Groupが残ります。その場合、そのLUN Groupに登録されたVolumeはLUN Groupから削除しないとVolume自体の削除ができません。ETERNUS Web GUI またはETERNUS CLI からLUN Groupの削除をお願いします。

  • 作成したHost ConnectionのHrefは、「GET /job/{job_id}」のresource_href_listで確認できます。

  • 複数のテナントが1つのLUN Groupを参照するようなHost Affinityが設定されていた場合、自テナントのVolumeが別テナントに参照できる状態になる可能性があります。

    LUN Groupを共有するHostのテナントが混在するようなHost Affinityは設定しないでください。

  • テナントユーザーの場合、自テナントに属するHostとVolumeのみを指定できます。

リクエスト例

  • Host ID 2 のHostについて、Volume ID 100000、100001、200003にConnectionを作成する場合の例です。

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/connection/host/2/volume"
-d
'{"volume_list": [{"hlun": 0,"volume_id": 100000},{"hlun": 1,"volume_id": 100001},{"hlun": 2,"volume_id": 200003}]}'

レスポンス例

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID。

REQUEST BODY

volume_list

(required)

Array of objects

追加するVolumeのhlunとvolume_idのペア。

hlunを指定しない場合は、未使用なhlunの小さい番号から順番に付与されます。

入力条件：

  • 128個まで指定可能です。

  • hlunはすべて指定するか、すべて指定しないかのどちらかにしてください。

hlun

integer

Hostから見えるVolumeの番号。
volume_id

integer

VolumeのID。
force

boolean

強制操作かどうか。

入力条件：

  • Hostの情報にshared_host_href_listが応答されるHostの場合、Connectionの追加を行うと応答されたHostからも指定Volumeへのアクセスが可能となります。

    本ケースにおいてConnectionを追加したい場合は、forceパラメーターにtrueを設定する必要があります。指定がないまたはfalseの場合はエラー応答します。

Responses

正常にジョブ登録できた場合、HTTPステータスコードが202 (Accepted)となりレスポンスボディを応答します。

RESPONSE BODY

job_id

integer

Job ID。
job_href

string

JobのResourceへのLink。