16.6　ローカルストレージシステム側ポートに登録された外部ストレージシステムのiSCSIターゲットにログインテストする

ログインに失敗した場合は、ログインできるように設定を見直すか、そのiSCSIターゲットを削除してください。ログインできないiSCSIターゲットを残しておくと、外部ストレージシステム側ポートのiSCSIターゲットを探索するときに、ネットワークや外部ストレージシステムに負荷がかかり情報取得に失敗するおそれがあります。

メモ

• このAPIは、VSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデルまたはVSP F1500の場合に使用できます。

• ローカルストレージシステムの仮想ポートモードが有効な場合、仮想ポートIDは0が設定されていると見なします。

実行権限

ストレージ管理者（参照）

リクエストライン

PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/iscsi-ports/＜オブジェクトID＞/actions/check/invoke

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

リクエストメッセージ

オブジェクトID

ポートの情報取得で取得したportIdの値を指定します。

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

クエリパラメータ

なし。

ボディ

{
    "parameters": {
        "iscsiIpAddress": "192.168.0.100",
        "iscsiName": "iqn.rest.example.of.iscsi1"
    }
}

属性	型	説明
iscsiIpAddress	string	（必須）外部ストレージシステムのiSCSIターゲットのIPアドレス IPv4またはIPv6のIPアドレスを指定します。
iscsiName	string	（必須）外部ストレージシステムのiSCSIターゲットのiSCSIネーム iqn形式またはeui形式で指定します。 大文字小文字を区別します。

レスポンスメッセージ

ボディ

{
    "portId": "CL1-A",
    "externalIscsiTargets": [
        {
            "iscsiIpAddress": "192.168.0.100",
            "iscsiName": "iqn.rest.example.of.iscsi1",
            "isLoginSucceeded": true
        }
    ]
}

属性	型	説明
portId	string	ローカルストレージシステムのポート番号
externalIscsiTargets	object[]	外部ストレージシステムのiSCSIターゲットに関する次の属性が出力されます。 iscsiIpAddress（string） iSCSIターゲットのIPアドレス iscsiName（string） iSCSIターゲットのiSCSIネーム isLoginSucceeded（boolean） iSCSIターゲットへのログイン結果 true：ログイン成功 false：ログイン失敗

Actionテンプレート

なし。

ステータスコード

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

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session f76884c29fff4dfaa664aa6981087b71" -X PUT "https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/iscsi-ports/CL1-A/actions/check/invoke"