Hitachi

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

11.6　Thin Imageペアの情報を取得する

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

実行権限

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

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/snapshots

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

パラメータ

型

フィルタ条件

snapshotGroupName

string

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

1～32文字で指定します。

pvolLdevId

int

（任意）Thin ImageペアのP-VOLのLDEV番号

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

svolLdevId

int

（任意）Thin ImageペアのS-VOLのLDEV番号

S-VOLがある場合、0以上の10進数で指定します。

muNumber

int

（任意）Thin ImageペアのP-VOLのMU番号

0～1023の値を指定します。

パラメータの指定方法を次に示します。

  • プライマリボリュームのLDEV番号、およびスナップショットグループ名称
  • プライマリボリュームのLDEV番号、およびプライマリボリュームのMU番号
  • プライマリボリュームのLDEV番号だけ
  • セカンダリボリュームがある場合、セカンダリボリュームのLDEV番号だけ

何も指定されていない場合は、エラーになります。

ボディ

なし。

レスポンスメッセージ

ボディ

取得したThin Imageペアの情報が複数の場合、プライマリボリュームのLDEV番号およびMU番号の昇順で出力されます。

プライマリボリュームのLDEV番号およびスナップショットグループ名称を指定してThin Imageペアの情報を取得した場合の出力例を次に示します。

{
  "data": [
    {
      "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
    }
  ]
}

プライマリボリュームのLDEV番号およびプライマリボリュームのMU番号を指定してThin Imageペアの情報を取得した場合の出力例を次に示します。

{
  "data": [
    {
      "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
    }
  ]
}

プライマリボリュームのLDEV番号だけを指定してThin Imageペアの情報を取得した場合の出力例を次に示します。

{
  "data": [
    {
      "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
    }
  ]
}

セカンダリボリュームのLDEV番号だけを指定してThin Imageペアの情報を取得した場合の出力例を次に示します。

{
  "data": [
    {
      "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属性がCOPY、RCPY、SMPP、PSUPのどれでもない
  • canCascade属性がtrue、かつstatus属性がCOPY、RCPY、SMPP、PSUPのどれでもない

progressRate

int

処理の進捗率

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

  • isClone属性がtrue、かつstatus属性がCOPY、RCPY、SMPP、PSUPのどれか
  • canCascade属性がtrue、かつstatus属性がCOPY、RCPY、SMPP、PSUPのどれか

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 G1000、VSP G1500、VSP F1500、Virtual 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、G900、VSP G1000、VSP G1500、VSP F350、F370、F700、F900、VSP F1500の場合、かつprimaryOrSecondary属性がP-VOLのときに出力されます。

svolProcessingStatus

string

ペアに対する処理の状態

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

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

snapshotDataReadOnly

boolean

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

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

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

ステータスコード

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

コード例

プライマリボリュームのLDEV番号、およびスナップショットグループ名称を指定する場合

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?pvolLdevId=100&snapshotGroupName=snapshotGroup"

プライマリボリュームのLDEV番号、およびプライマリボリュームのMU番号を指定する場合

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?pvolLdevId=100&muNumber=3"

プライマリボリュームのLDEV番号だけを指定する場合

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?pvolLdevId=100

セカンダリボリュームがある場合、セカンダリボリュームのLDEV番号だけを指定するとき

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?svolLdevId=101

関連項目

ページの先頭へ

All Rights Reserved. Copyright© 2016, 2021, Hitachi, Ltd.