Hitachi

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


11.5 特定のスナップショットグループを指定してThin Imageペアの情報を取得する

指定したスナップショットグループ単位でThin Imageペアの情報を取得します。取得した情報からペアの状態など、ペアの操作に必要な情報を確認します。

実行権限

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

リクエストライン

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

リクエストメッセージ

オブジェクトID

スナップショットグループの情報取得で取得したsnapshotGroupIdの値を指定します。

属性

説明

snapshotGroupId

string

(必須)スナップショットグループのオブジェクトID

1~32文字で指定します。大文字と小文字を区別します。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "snapshotGroupName" : "snapshotGroup",
  "snapshotGroupId" : "snapshotGroup",
  "snapshots" : [ {
    "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": "snapshotGroup",
    "primaryOrSecondary": "P-VOL",
    "status": "PSUS",
    "pvolLdevId": 100,
    "muNumber": 4,
    "snapshotPoolId": 10,
    "concordanceRate": 100,
    "isConsistencyGroup": true,
    "isWrittenInSvol": false,
    "isClone": false,
    "canCascade": false,
    "splitTime": "2015-03-20T09:27:35",
    "snapshotId": "100,4",
    "pvolProcessingStatus": "N",
    "snapshotDataReadOnly": false
  } ]
}

属性

説明

snapshotGroupName

string

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

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

snapshotGroupId

string

スナップショットグループのオブジェクトID

snapshots

object[]

スナップショットグループに含まれるThin Imageペアに関する、次の属性が出力されます。

  • snapshotGroupName(string)

    スナップショットグループの名称

  • 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/snapshot-groups/snapshotGroup