指定Hostに関するHost Connectionの更新

POST /connection/host/{host_id}/reconnect

概要説明

host_idで指定したHostに関するConnectionを、追加されたCA Portにも接続します。

Connection作成後にCAの増設を行い、そのCA Portに既存のConnectionを接続したい場合に実行してください。

注意

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

  • 指定Hostに設定されているAffinityがない場合はエラー応答します。

  • 指定Hostに設定されているAffinityに新たに追加するCA Portがない場合はエラー応答します。

  • 接続する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の情報を参照ください。

  • 指定HostとCA Portの接続がなくなったConnectionの削除は行いません。削除したい場合は、ETERNUS Web GUI またはETERNUS CLI から操作してください。

  • 以下のHostを指定したConnectionの再作成はできません。接続Portの変更をしたい場合は、ETERNUS SF Storage Cruiser を使用してください。

    • Storage Clusterの設定があるHost

    • VVOL Access Pathの設定があるHost

  • テナントユーザーの場合、自テナントに属するHostに関するConnectionのみ設定できます。

リクエスト例

  • Host ID 2 のHostについて、追加されたCA PortにConnectionを作成する場合の例です。

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/connection/host/2/reconnect"

レスポンス例

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

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID。

Responses

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

RESPONSE BODY

job_id

integer

Job ID。
job_href

string

JobのResourceへのLink。