複数Host Connectionの削除

DELETE /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を設定する必要があります。

  • 以下の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、100001のConnectionを削除する場合の例です。

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X DELETE "https://192.168.1.1:5665/api/v1/connection/host/2/volume"
-d
'{"volume_id_list": [100000,100001]}'

レスポンス例

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

Parameters

PATH PARAMETERS

host_id

(required)

integer

Host ID。

REQUEST BODY

volume_id_list

(required)

Array of integers

削除するVolumeのID。

入力条件：

  • 256個まで指定可能です。
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。