Host Connectionの削除

DELETE /connection/host/{host_id}/volume/{volume_id}

概要説明

host_id, volume_idで指定したHostに関するConnectionを削除します。

注意

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

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

  • 以下のHostを指定したConnectionの削除はできません。削除したい場合は、ETERNUS SF Storage Cruiser を使用してください。

    • Storage Clusterの設定があるHost

    • VVOL Access Pathの設定があるHost

  • 指定Hostに対するConnectionをすべて削除する場合は DELETE /connection/host/{host_id}を使用してください。

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

リクエスト例

  • Host ID 2 のHostについて、Volume ID 100000のConnectionを強制指定で削除する場合の例です。

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X DELETE "https://192.168.1.1:5665/api/v1/connection/host/2/volume/100000?force=true"

レスポンス例

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

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID。
volume_id

(required)

integer

Volume ID。

QUERY PARAMETERS

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。