Hitachi

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


7.3 ストレージシステムの合計効果の情報を取得する

ストレージシステムの利用効率を上げるための機能(容量削減機能(dedupe and compression)、容量拡張機能、スナップショットによるバックアップ、Dynamic Provisioningによる容量仮想化)による容量消費の節減効果(合計効果)について情報を取得します。
メモ

このAPIは、ストレージシステムがVSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900の場合に使用できます。

実行権限

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

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/total-efficiencies/instance

リクエストメッセージ

オブジェクトID
instanceを指定します。instanceは、単一のインスタンスしか持たないオブジェクトの場合に、オブジェクトID として指定する固定の値です。
クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "isCalculated" : true,
  "totalRatio" : "8.46",
  "compressionRatio" : "1.18",
  "snapshotRatio" : "97.21",
  "provisioningRate" : "85",
  "calculationStartTime" : "2016-07-31T16:55:07Z",
  "calculationEndTime" : "2016-07-31T17:06:35Z",
  "dedupeAndCompression" : {
    "totalRatio" : "1.47",
    "compressionRatio" : "1.08",
    "dedupeRatio" : "1.35",
    "reclaimRatio" : "1.00"
  },
  "acceleratedCompression" : {
    "totalRatio" : "1.11",
    "compressionRatio" : "1.10",
    "reclaimRatio" : "1.00"
  }
}

属性

説明

isCalculated

boolean

合計効果の集計状態

合計効果の集計がされているかどうかが出力されます。

  • true:集計済
  • false:未集計

trueの場合だけ、ほかの属性の情報が出力されます。

calculationStartTime

ISO8601string

合計効果の集計を開始した日時(UTC)

YYYY-MM-DDThh:mm:ssZ形式で出力されます。

calculationEndTime

ISO8601string

合計効果の集計が終了した日時(UTC)

YYYY-MM-DDThh:mm:ssZ形式で出力されます。

totalRatio

string

ストレージシステム全体での合計効果

ストレージシステムが生成するメタデータやガベージデータなどは含まれません。

集計対象のボリュームが存在しない場合は、無効な値を示す-(ハイフン)が出力されます。

集計対象のボリュームが閉塞状態などの理由で集計できなかった場合は、前回計算時の値が出力されます。

プールからボリュームを作成したあと、データが書き込まれる前は、最大値92233720368547758.07が出力されます。

compressionRatio

string

容量削減機能(dedupe and compression)または容量拡張機能による容量の削減効果

ストレージシステムが生成するメタデータやガベージデータなどは含まれません。

集計対象のボリュームが存在しない場合は、無効な値を示す-(ハイフン)が出力されます。

集計対象のボリュームが閉塞状態などの理由で集計できなかった場合は、前回計算時の値が出力されます。

snapshotRatio

string

スナップショットのバックアップによる容量の節減効果

ストレージシステムが生成するメタデータやガベージデータなどは含まれません。

集計対象のボリュームが存在しない場合は、無効な値を示す-(ハイフン)が出力されます。

集計対象のボリュームが閉塞状態などの理由で集計できなかった場合は、前回計算時の値が出力されます。

provisioningRate

string

Dynamic Provisioningでの容量仮想化による容量消費の節減効果の比率(%)

ストレージシステムが生成するメタデータやガベージデータなどは含まれません。

集計対象のボリュームが存在しない場合は、無効な値を示す-(ハイフン)が出力されます。

集計対象のボリュームが閉塞状態などの理由で集計できなかった場合は、前回計算時の値が出力されます。

dedupeAndCompression

object

容量削減機能(dedupe and compression)での容量削減効果に関する属性が出力されます。

ストレージシステムが生成するメタデータやガベージデータなどは含まれません。

集計対象のボリュームが存在しない場合は、無効な値を示す-(ハイフン)が出力されます。

集計対象のボリュームが閉塞状態などの理由で集計できなかった場合は、前回計算時の値が出力されます。

  • totalRatio(string)

    容量削減機能全体での容量の削減効果

  • compressionRatio(string)

    圧縮による容量の削減効果

  • dedupeRatio(string)

    重複排除による容量の削減効果

  • reclaimRatio(string)

    固定パターン排除による容量の削減効果

acceleratedCompression

object

容量拡張機能での容量削減効果に関する属性が出力されます。

ストレージシステムが生成するメタデータやガベージデータなどは含まれません。

集計対象のボリュームが存在しない場合は、無効な値を示す-(ハイフン)が出力されます。

集計対象のボリュームが閉塞状態などの理由で集計できなかった場合は、前回計算時の値が出力されます。

  • totalRatio(string)

    容量拡張機能全体での容量の削減効果

  • compressionRatio(string)

    圧縮による容量の削減効果

  • reclaimRatio(string)

    固定パターン排除による容量の削減効果

注※ 削減後の容量を1とした場合の、削減前の容量の割合が出力されます。

ステータスコード

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

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/total-efficiencies/instance