Thin Provisioning Pool情報の取得

GET /tpp/{tpp_id}

概要説明

Thin Provisioning Pool情報を取得します。

注意

Automated Storage Tieringで使用されているThin Provisioning Pool (Flexible Tier Sub Pool)の情報は応答しません。

リクエスト例

  • Thin Provisioning Pool ID 5 の情報を取得する場合の例です。

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/tpp/5"

レスポンス例

{
  "tpp_id": 0,
  "tpp_href": "/api/v1/tpp/0",
  "name": "DataStore#0",
  "number": 0,
  "status": "Normal",
  "detail_status": "Available",
  "used_status": "Normal",
  "is_data_reduction_error": false,
  "physical_capacity": 2097152,
  "provisioned_capacity": 1048576,
  "used_capacity": 524288,
  "used_rate": 20,
  "provisioned_rate": 50,
  "warning_threshold": 90,
  "attention_threshold": 75,
  "is_cm_encryption_enabled": false,
  "chunk_size": 21,
  "drive_type": "Online",
  "level": "RAID5",
  "raidgroup_href_list": [
    "/api/v1/raidgroup/0",
    "/api/v1/raidgroup/1"
  ],
  "is_compression_enabled": true,
  "is_deduplication_enabled": false,
  "data_reduction_rate": 90,
  "data_size_before_reduction": 3145728,
  "data_size_after_reduction": 314572,
  "gc_speed": 0,
  "volume_href_list": [
    "/api/v1/volume/3",
    "/api/v1/volume/100001",
    "/api/v1/volume/200001",
    "/api/v1/volume/300000",
    "/api/v1/volume/400000"
  ]
}

Parameters

PATH PARAMETERS

tpp_id

(required)

integer

Thin Provisioning Pool ID。

QUERY PARAMETERS

fields

Array of strings

表示したいParameter。

指定したParameter名(Response Body Parameter)の情報のみを抜き出して取得します。

指定方法の詳細は、表示する項目の絞り込みを参照してください。
is_response_volume_id_list

boolean

Thin Provisioning Poolに属するVolume情報をVolume ID List型式で応答するかどうか。

trueを指定した場合、Thin Provisioning Poolに属するVolume情報を、Volume Href ListではなくVolume ID List型式で応答します。

falseを指定した場合または指定を省略した場合、Volume Href List型式で応答します。

1つのThin Provisioning PoolにVolumeが16384以上存在する場合、Volume Href List型式ではすべてのVolume情報を応答することができません。

大量にVolumeが存在するThin Provisioning Poolに属するVolume情報をすべて取得したい場合は、本Parameterでtrueを指定してください。

Responses

正常に取得できた場合、HTTPステータスコードが200 (OK)となりレスポンスボディを応答します。

RESPONSE BODY

tpp_id

integer

Thin Provisioning Poolを識別するID。
tpp_href

string

Thin Provisioning PoolのResourceへのLink。
name

string

Thin Provisioning PoolのFriendly Name。
number

integer

Thin Provisioning Pool Number。

ETERNUS Web GUI またはETERNUS CLIで使われるThin Provisioning Poolの識別子です。
status

string

ステータス。
項目 説明
Normal 正常状態です。
Maintenance 保守状態です。
Warning 予防保守が必要な状態です。
Error 異常が発生し、保守が必要な状態です。
detail_status

string

Thin Provisioning Poolの詳細ステータス。
項目 説明
Available 正常状態です。
Maintenance 強制復旧を実行中です。
Readying 全物理割り当て領域が未フォーマット状態です。
Partially_Readying 一部の物理割り当て領域が未フォーマット状態です。
Exposed 使用可能ですが、構成Driveの冗長性を失った状態です。
Blockade 閉塞状態です。
Broken 故障状態です。
Data_Lost データが失われた状態です。
used_status

string

Thin Provisioning Poolの使用状況。
項目 説明
Normal 使用率が注意閾値未満です。
Attention 使用率が注意閾値以上、警告閾値未満です。データコンテナボリュームがある場合、その容量が閾値(80%)以上となったときもAttentionになります。
Warning 使用率が警告閾値以上です。
is_data_reduction_error

boolean

Data Reduction機能(Deduplication and/or Compression)に異常が発生しているかどうか。

trueの場合、Hardware故障などの理由でData Container Volumeに異常が発生し、Data Reductionが正常に動作していない状態です。
physical_capacity

integer

Thin Provisioning Poolの総物理容量。

単位はMBです。
provisioned_capacity

integer

Thin Provisioning Poolに属するVolumeの総論理容量。

単位はMBです。

Data Container Volumeの容量は総論理容量に含まれません。
used_capacity

integer

Thin Provisioning Poolに属するVolumeの物理割り当て済み容量の総和。

単位はMBです。
used_rate

integer

Thin Provisioning Poolの使用率。

単位は%です。

総物理容量(Physical Capacity)に対する使用容量(Used Capacity)の割合を表します。
provisioned_rate

integer

Thin Provisioning PoolのProvisioning率。

単位は%です。

総物理容量(Physical Capacity)に対する総論理容量(Provisioned Capacity)の割合を表します。

Data Reductionが有効の場合、本項目は応答しません。
warning_threshold

integer

警告閾値。

単位は%です。

Thin Provisioning Poolの使用率(総物理容量に対する使用容量の割合)が本閾値を超えた場合、使用状況がWarningに遷移します。
attention_threshold

integer

注意閾値。

単位は%です。

Thin Provisioning Poolの使用率(総物理容量に対する使用容量の割合)が本閾値を超えた場合、使用状況がAttentionに遷移します。

注意閾値設定がない場合は、0が表示されます。
is_cm_encryption_enabled

boolean

CMによる暗号化が有効かどうか。

trueの場合、Thin Provisioning Pool内のデータはCMによって暗号化されています。
chunk_size

integer

Thin Provisioning PoolのChunk Size。

単位はMBです。

Volumeに割り当てる物理領域の最小単位です。
drive_type

string

Thin Provisioning Poolを構成するDriveの種別。
項目 説明
Online Online HDD
Nearline Nearline HDD
SSD SAS SSD
NVMe_SSD NVMe SSD
Online_SED Online HDD SED
Nearline_SED Nearline HDD SED
SSD_SED SAS SSD SED
NVMe_SSD_SED NVMe SSD SED
level

string

Thin Provisioning Poolを構成するRAID GroupのRAID Level。
項目 説明
RAID0 Striping
RAID1 Mirroring
RAID5 High Capacity
RAID6 High Reliability
RAID10 High Performance
RAID6FR RAID6 (Fast Recovery)
raidgroup_href_list

Array of strings

Thin Provisioning Poolを構成するRAID GroupのResourceへのLink。
is_compression_enabled

boolean

Compressionが有効かどうか。

trueの場合、Thin Provisioning Pool内のVolumeに書き込まれたDataに対してCompressionが行われます。
is_deduplication_enabled

boolean

Deduplicationが有効かどうか。

trueの場合、Thin Provisioning Pool内のVolumeに書き込まれたDataに対してDeduplicationが行われます。
data_reduction_rate

integer

容量削減率。

単位は%です。

書き込まれたデータサイズと、Data Reduction (Deduplication and/or Compression)によって削減されたデータサイズの割合です。

取得が失敗した場合、またはData Reductionが無効の場合は応答されません。
data_size_before_reduction

integer

削減前データサイズ。

単位はMBです。

Volumeに書き込まれたデータ削減前のサイズの総和です。

取得が失敗した場合、またはData Reductionが無効の場合は応答されません。
data_size_after_reduction

integer

削減後データサイズ。

単位はMBです。

Volumeに書き込まれたデータ削減後のサイズの総和です。

取得が失敗した場合、またはData Reductionが無効の場合は応答されません。
gc_speed

integer

Garbage Collectionの動作速度。

単位はMB/秒です。

Data Reductionにより不要となった物理割り当て済み領域の解放処理の動作速度を応答します。

取得が失敗した場合、またはData Reductionが無効の場合は応答されません。
volume_href_list

Array of strings

Thin Provisioning Poolに属するVolumeのResourceへのLink。

is_response_volume_id_listがtrueの場合は応答しません。

16384までのVolume情報を応答します。
volume_id_list

Array of integers

Thin Provisioning Poolに属するVolumeのID。

is_response_volume_id_listがtrueの場合に応答します。