Hitachi

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


11.7 特定のThin Imageペアの情報を取得する

指定したThin Imageペアの情報を取得します。取得した情報からペアの状態など、ペアの操作に必要な情報を確認します。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

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

pvolLdevId>,<muNumber

属性

説明

pvolLdevId

int

(必須)Thin ImageペアのP-VOLのLDEV番号

0以上の10進数で指定します。

muNumber

int

(必須)Thin ImageペアのP-VOLのMU番号

01023の値を指定します。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "snapshotGroupName": "snapshotGroup",
  "primaryOrSecondary": "P-VOL",
  "status": "PSUS",
  "pvolLdevId": 100,
  "muNumber": 3,
  "svolLdevId": 101,
  "snapshotPoolId": 10,
  "concordanceRate": 100,
  "isConsistencyGroup": true,
  "isWrittenInSvol": false,
  "isClone": false,
  "canCascade": false,
  "splitTime": "2015-03-20T09:27:35",
  "snapshotId": "100,3",
  "pvolProcessingStatus": "N",
  "snapshotDataReadOnly": false 
}

属性

説明

snapshotGroupName

string

Thin Imageペアが所属するスナップショットグループ名称

スナップショットグループ名称に半角スペースが含まれている場合、ペアの情報を取得できません。

primaryOrSecondary

string

対象となるLDEVの属性

status

string

ペアの状態

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

pvolLdevId

int

P-VOLのLDEV番号

muNumber

int

P-VOLのMU番号

svolLdevId

int

S-VOLのLDEV番号

snapshotPoolId

int

スナップショットデータが作成されているプールID

concordanceRate

int

ペアの一致率

次のどれかの条件が該当する場合に表示されます。

  • isClone属性がfalse、かつcanCascade属性がfalse
  • isClone属性がtrue、かつstatus属性がCOPYRCPYSMPPPSUPのどれでもない
  • canCascade属性がtrue、かつstatus属性がCOPYRCPYSMPPPSUPのどれでもない

progressRate

int

処理の進捗率

次のどちらかの条件を満たす場合に表示されます。

  • isClone属性がtrue、かつstatus属性がCOPYRCPYSMPPPSUPのどれか
  • canCascade属性がtrue、かつstatus属性がCOPYRCPYSMPPPSUPのどれか

isConsistencyGroup

boolean

ペアがコンシステンシーグループモード(CTGモード)で作成されたかどうかが表示されます。

  • true:CTGモードで作成されている
  • false:CTGモードで作成されていない

isWrittenInSvol

boolean

ペアの状態がPSUS/PFUSのとき、ホストからS-VOLへデータ書き込みがあったかどうかが表示されます。

  • true:S-VOLへの書き込みあり
  • false:S-VOLへの書き込みなし

S-VOLなしのThin Imageペアの場合はfalseが表示されます。

isClone

boolean

クローン属性のペアかどうかが表示されます。

  • true:クローン属性のペア
  • false:クローン属性でないペア

canCascade

boolean

ペアをカスケード構成にできるかどうかが表示されます。

  • true:カスケード構成にできる
  • false:カスケード構成にできない

splitTime

string

スナップショットデータの作成時刻

YYYY-MM-DDThh:mm:ss形式でストレージシステムのローカルタイムが表示されます。

VSP G1000VSP G1500VSP F1500Virtual Storage Platform、またはHUS VMで、外部認証サーバまたは鍵管理サーバを使用するための設定を保守員に依頼している場合、ストレージシステムのタイムゾーンの設定が変更されていることがあります。この場合、グリニッジ標準時(GMT)が表示されます。

snapshotId

string

Thin ImageペアのオブジェクトID

次の属性をコンマで連結した形式で表示されます。
  • pvolLdevId
  • muNumber

pvolProcessingStatus

string

ペアに対する処理の状態

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

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP G1000VSP G1500VSP F350、F370、F700、F900VSP F1500の場合、かつprimaryOrSecondary属性がP-VOLのときに出力されます。

svolProcessingStatus

string

ペアに対する処理の状態

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

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP G1000VSP G1500VSP F350、F370、F700、F900VSP F1500の場合、かつprimaryOrSecondary属性がS-VOLのときに出力されます。

snapshotDataReadOnly

boolean

スナップショットデータが読み取り専用属性のペアかどうか出力されます。

  • true:読み取り専用
  • false:読み取り専用ではない

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

ステータスコード

この操作のリクエストに対するステータスコードについては、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/snapshots/100,3