Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


10.7 特定のShadowImageペアの情報を取得する

指定したShadowImageペアの情報を取得します。ペアの状態からペア操作が完了したかを確認したり、ペア追加で使用するコンシステンシーグループIDなどの構成情報を取得したりできます。
重要
  • 対象のShadowImageペアを、ほかのREST APIサーバやREST API以外のソフトウェアを使用して作成したりまたは削除した場合、その情報が正しく取得できないことがあります。最新のペアの情報を取得したいときは、ShadowImageペアの一覧を取得するAPIを使用してください。
  • コピーグループ名、デバイスグループ名、またはコピーペア名に半角スペースが含まれている場合、その情報は取得できません。

実行権限

ストレージ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/local-clone-copypairs/<オブジェクトID

リクエストメッセージ

オブジェクトID

ShadowImageペアの情報から取得したlocalCloneCopypairIdの値を指定します。次に示す属性値を連結した形式でも指定できます。

copyGroupName>,<pvolDeviceGroupName>,<svolDeviceGroupName>,<copyPairName

属性

説明

copyGroupName

string

(必須)コピーグループ名を31文字以内で指定します。大文字と小文字を区別します。

pvolDeviceGroupName

string

(必須)P-VOLデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。

svolDeviceGroupName

string

(必須)S-VOLデバイスグループ名を31文字以内で指定します。大文字と小文字を区別します。

copyPairName

string

(必須)コピーペア名を31文字以内で指定します。大文字と小文字を区別します。

クエリパラメータ
なし。
ボディ
なし。

レスポンスメッセージ

ボディ
{
  "localCloneCopypairId" : "localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair1",
  "copyGroupName" : "localCopyGroup1",
  "copyPairName" : "pair1",
  "replicationType" : "SI",
  "copyMode" : "NotSnapshot",
  "copyProgressRate" : 100,
  "pvolLdevId" : 10,
  "pvolStatus" : "PAIR",
  "svolLdevId" : 20,
  "svolStatus" : "PAIR",
  "pvolMuNumber" : 0,
  "pvolProcessingStatus": "N",
  "svolProcessingStatus": "N"
}

属性

説明

copyGroupName

string

コピーグループ名

copyPairName

string

コピーペア名

replicationType

string

ペア種別

SIShadowImage

copyMode

string

コピーモード

NotSnapshotが表示されます。

copyProgressRate

int

コピーの進捗率(%)

情報が取得できない場合、この属性は出力しません。

pvolLdevId

int

P-VOLのLDEV番号(10進数)

svolLdevId

int

S-VOLのLDEV番号(10進数)

pvolMuNumber

int

P-VOLのMU番号

pvolStatus

string

P-VOLのペアボリューム状態

詳細については、ペアの状態遷移(ShadowImage)の説明を参照してください。

情報が取得できない場合、この属性は出力しません。

svolStatus

string

S-VOLのペアボリューム状態

詳細については、ペアの状態遷移(ShadowImage)の説明を参照してください。

情報が取得できない場合、この属性は出力しません。

consistencyGroupId

int

コンシステンシーグループID

コンシステンシーグループでない場合、この属性は出力しません。

localCloneCopypairId

string

ShadowImageペアのオブジェクトID

次の属性をコンマで連結した形式で出力します。

  • copyGroupName
  • pvolDeviceGroupName
  • svolDeviceGroupName
  • copyPairName

pvolProcessingStatus

string

ペアに対する処理の状態

  • E:拡張処理が実行中
  • N:拡張処理が実行中でない

svolProcessingStatusと同じ値が出力されます。

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP G1000VSP G1500VSP F350、F370、F700、F900VSP F1500の場合に出力されます。

svolProcessingStatus

string

ペアに対する処理の状態

  • E:拡張処理が実行中
  • N:拡張の処理が実行中でない

pvolProcessingStatusと同じ値が出力されます。

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP G1000VSP G1500VSP F350、F370、F700、F900VSP F1500の場合に出力されます。

ステータスコード

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

コード例

curl -v -H "Accept: application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/local-clone-copypairs/localCopyGroup1,localCopyGroup1P_,localCopyGroup1S_,pair1