16.9　外部ボリュームをマッピングする

重要

外部ボリュームをマッピングするAPIは、ファイバーチャネルポートの場合だけ使用できます。iSCSIポートの場合は使用できません。

iSCSIポートの場合でローカルストレージシステムがVSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900のときは、Hitachi Storage Advisor Embeddedガイドに記載されているREST APIを使用してください。上記以外の機種のときは、RAID Managerなどのストレージ管理ソフトウェアを使用してください。

メモ

ローカルストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP Fx00 モデルの場合、外部接続用のポートを、外部ストレージシステムからローカルストレージシステムに対するI/Oパスの終点として使用しているとき、I/Oパスが切断されるおそれがあります。外部パスとして使用できる経路を使用してください。外部パスに関する詳細については、マニュアルUniversal Volume Managerユーザガイドを参照してください。

実行権限

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

リクエストライン

POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/external-parity-groups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

{   "externalParityGroupId":"1-1",
    "externalPathGroupId":1,
    "portId":"CL7-A",
    "externalWwn":"50060e80222fd141",
    "lunId":0,
    "emulationType":"OPEN-V",
    "clprId":0
}

属性	型	説明
externalParityGroupId	string	（必須）外部パリティグループ番号 <gno>-<sgno>形式で指定します。
externalPathGroupId	int	（必須）外部パスグループID 指定したパスグループIDが存在しない場合は、新たに作成されます。
portId	string	（必須）ローカルストレージシステム側のポート番号
externalWwn	string	（必須）外部ストレージシステム側のWWN
lunId	int	（必須）外部ストレージシステム側のポートのLUN
emulationType	string	（任意）エミュレーションタイプ 次の値を指定できます。 OPEN-3 , OPEN-8 , OPEN-9 , OPEN-E , OPEN-K , OPEN-L , OPEN-V , 3380-3 , 3380-3A , 3380-3B , 3380-3C , 3390-1 , 3390-2 , 3390-3 , 3390-A , 3390-3A , 3390-3B , 3390-3C , 3390-3R , 3390-9 , 3390-9A , 3390-9B , 3390-9C , 3390-L , 3390-LA , 3390-LB , 3390-LC , 3390-M , 3390-MA , 3390-MB , 3390-MC , 3390-V , 6586-G , 6586-J , 6586-K , 6586-KA , 6586-KB , 6586-KC , 6588-1 , 6588-3 , 6588-9 , 6588-A , 6588-3A , 6588-3B , 6588-3C , 6588-9A , 6588-9B , 6588-9C , 6588-L , 6588-LA , 6588-LB , 6588-LC 省略した場合、OPEN-Vが設定されます。
clprId	int	（任意）外部パリティグループが使用するCLPR番号 0～31の10進数を指定します。 省略した場合、0が設定されます。
isExternalAttributeMigration	boolean	（任意）外部パリティグループの属性にnondisruptive migration を設定するかどうか true：設定する false：設定しない 省略した場合、falseが設定されます。
commandDeviceLdevId	int	（任意）リモートコマンドデバイスのLDEV番号 外部ストレージシステムのコマンドデバイスをマッピングする場合に指定します。 指定したLDEV番号がリモートコマンドデバイスに付与されます。 ストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に指定できます。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。このAPIの実行結果が正しく反映されているかどうかは、外部パスの情報を取得するAPIを実行して確認してください。

属性	説明
affectedResources	マッピングした外部パリティグループのURL

ステータスコード

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

コード例

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