16.13　外部パスグループから外部パスを削除する

実行権限

ストレージ管理者（プロビジョニング）

リクエストライン

PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/external-path-groups/＜オブジェクトID＞/actions/remove-path/invoke

このAPIはPOSTメソッドでも実行できます。

リクエストメッセージ

オブジェクトID

外部パスグループの情報取得で取得したexternalPathGroupIdの値を指定します。

属性	型	説明
externalPathGroupId	int	（必須）外部パスグループ番号

クエリパラメータ

なし。

ボディ

ファイバーチャネルポートの場合のコード例を次に示します。

{
"parameters": {
    "portId":"CL7-A",
    "externalWwn":"50060E801033C2F0"
}
}

ファイバーチャネルポートの場合

属性	型	説明
portId	string	（必須）ローカルストレージシステム側のポート番号
externalWwn	string	（必須）外部ストレージシステム側のWWN

iSCSIポートの場合のコード例を次に示します。

{
  "parameters": {
    "portId":"CL1-C",
    "iscsiIpAddress": "192.168.0.100",
    "iscsiName": "iqn.rest.example.of.iscsi1"
  }
}

iSCSIポートの場合

属性	型	説明
portId	string	（必須）ローカルストレージシステム側のポート番号
iscsiIpAddress	string	（必須）外部ストレージシステム側のiSCSIターゲットのIPアドレス IPv4またはIPv6のIPアドレスを指定します。
iscsiName	string	（必須）外部ストレージシステム側のiSCSIターゲットのiSCSIネーム iqn形式またはeui形式で指定します。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性	説明
affectedResources	ファイバーチャネルポートの場合： 外部パスを削除した外部パスグループのURLを返します。 iSCSIポートの場合： このAPIはaffectedResources を表示しません。 外部パスグループが削除されたかどうかは、次の方法で確認してください。 ローカルストレージシステムがVSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900のときは、Hitachi Storage Advisor Embeddedガイドに記載されているREST APIで確認してください。 上記以外の機種のときは、RAID Managerなどのストレージ管理ソフトウェアで確認してください。

Actionテンプレート

なし。

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X PUT --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/external-path-groups/1/actions/remove-path/invoke