Thin Provisioning Poolの作成

POST /tpp

概要説明

新規にThin Provisioning Poolを作成します。

注意
  • 以下の場合、Thin Provisioning Poolを作成できません。

    • Thin Provisioning機能を有効化していない場合。

    • Thin Provisioning PoolおよびFlexible Tier Poolの物理容量の総和がMaximum Pool Capacityを超過する場合。

    • 装置にThin Provisioning Poolが最大数作成されている場合。

    • 装置にThin Provisioning Poolの作成に必要なリソース(RAID Group数、Volume数など)が不足している場合。

  • 作成したThin Provisioning PoolのHrefは、「GET /job/{job_id}」のresource_href_listで確認できます。

  • テナントユーザーの場合、本コマンドを実行することはできません。

リクエスト例

  • RAID5のThin Provisioning Poolを作成する場合の例です。

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/tpp"
    -d
    '{"name" : "tpp_raid5","level" : "RAID5","raidgroup_list": [{   "drive_id_list": ["0000","0100","0200,"0300"]},{   "drive_id_list": ["0001","0101","0201","0301"]}]
    }'
  • RAID6FRのThin Provisioning Poolを作成する場合の例です。

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/tpp"
    -d
    '{  "name" : "tpp_raid6fr","level" : "RAID6FR" ,"raidgroup_list" : [{    "drive_id_list" : ["0000","0001","0102","0103","0204","0205","0306","0307","0408","0409","0510","0511","0612"]}],"raid6fr_configuration_priority" : "capacity"}'
  • RAID5のThin Provisioning PoolをDrive自動選択機能を使用して作成する場合の例です。

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/tpp"
    -d
    '{"name" : "tpp_raid5","level" : "RAID5","is_auto_drive_selection": true,"drive_type" : "SSD","minimum_capacity" : 307200}'

レスポンス例

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

Parameters

REQUEST BODY

name

(required)

string

Thin Provisioning Pool名。

入力条件:

  • 指定可能な文字数は1~16です。

  • 使用可能文字種は半角英数字記号です。ただし、","および"?"は除きます。

  • すでに存在するThin Provisioning Pool名を付けることはできません。

level

(required)

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)
warning_threshold

integer

Default: 90

警告閾値。

単位は%です。

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

入力条件:

  • 指定可能な範囲は5~99です。

  • 注意閾値以下の値を設定することはできません。

attention_threshold

integer

Default: 75

注意閾値。

単位は%です。

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

本項目に0を設定した場合、注意閾値は未設定となります。

入力条件:

  • 指定可能な範囲は5~80です。

  • 警告閾値以上の値を設定することはできません。

is_cm_encryption_enabled

boolean

Default: false

CMによる暗号化。

trueを指定した場合、Thin Provisioning Pool内のデータがCMによって暗号化されます。

入力条件:

  • Thin Provisioning Poolを構成するDriveがSAS HDD SED、SAS SSD SED、またはNVMe SSD SEDの場合、本項目は指定できません。

  • 装置の暗号化モードが有効な場合に限り、本設定項目を指定できます。

is_compression_disabled

boolean

Default: false

Compressionを無効化するかどうか。

trueを指定した場合、TPP内のデータに対するCompressionが行われなくなります。

入力条件:

  • 装置のData Reduction機能が有効な場合に限り指定可能です。

is_deduplication_disabled

boolean

Default: false

Deduplicationを無効化するかどうか。

trueを指定した場合、TPP内のデータに対するDeduplicationが行われなくなります。

入力条件:

  • 装置のData Reduction機能が有効な場合に限り指定可能です。

  • ETERNUS DX8900 S6/DX900 S6の場合、本項目は指定できません。

is_auto_drive_selection

boolean

Default: false

Thin Provisioning Poolを構成するDriveを自動で決定するかどうか。

trueを指定した場合、Driveを自動で選択してThin Provisioning Poolを作成します。

入力条件:

  • trueの場合、drive_typeおよびminimum_capacityの指定が必須です。

    raidgroup_listの指定はできません。

  • falseの場合、raidgroup_listの指定は必須です。

    drive_typeおよびminimum_capacityの指定はできません。

注意

自動Drive選択の場合、AF対応/非対応Driveを区別せずにTPPを作成します。AF対応Driveが混在している場合はDriveを手動で選択してください。

raidgroup_list

Array of objects

入力条件:

  • 1~5個まで指定可能です。

drive_id_list

Array of strings

RAID Groupを構成するDriveのID。

入力条件:

  • Drive IDのFormatは以下です。
    • CE搭載Drive w0yy
      • w - 16進 CE ID (0~b)

      • yy - 16進 Slot Id (00~17)

    • DE搭載Drive xxyy
      • xx - 16進 DE ID (00~ff)

      • yy - 16進 Slot Id (00~17)

  • 存在しないDriveは指定できません。

  • 指定できるDrive数は以下です。

    D:Data、M:Mirror、P:Parity を示します。

    • RAID10 : 4 (2D+2M)、8 (4D+4M)、16 (8D+8M)、24 (12D+12M)

    • RAID5 : 4 (3D+1P)、5 (4D+1P)、7 (6D+1P)、8 (7D+1P)、9 (8D+1P)、13 (12D+1P)

    • RAID6 : 6 (4D+2P)、8 (6D+2P)、9 (7D+2P)、10 (8D+2P)

    • RAID6FR : 13 ((4D+2P)x2+1HS)、17 ((6D+2P)x2+1HS)、31 ((8D+2P)x3+1HS or (4D+2P)x5+1HS))

    • RAID1 : 2 (1D+1M)

    • RAID0 : 4 (4D)

  • RAID Groupを構成するDriveの種別は同じである必要があります。ただし、Online DriveとNearlineの混在に限り可能です。

  • 同一Thin Provisioning Poolを構成するRAID GroupのMember Drive数は同じである必要があります。

  • ETERNUS DX8900 S6の場合、Driveの配置は以下の条件を満たす必要があります。

    RAID Level 制限
    RAID1

    同一DE内にRAID Groupを構成するDriveの半数を超えるDriveを指定できません。

    RAID10

    同一DE内にRAID Groupを構成するDriveの半数を超えるDriveを指定できません。

    RAID5 同一DEに2本以上のDriveを指定できません。
    RAID6、RAID6FR 同一DEに3本以上のDriveを指定できません。
  • RAID Levelが10または5の場合、6TB以上の容量のDriveを選択することはできません。

assigned_cm

string

Default: "Automatically selected."

RAID Groupの担当CMのID。

RAID Groupに割り当てられる担当CMを指定します。

通常は自動でCMごとの負荷が分散されるように決定するため、指定不要です。

特定のCMを担当CMとしたい場合に指定してください。

CE#0-CM#0を指定したい場合は'00'、CE#a-CM#1を指定したい場合は'a1'のように指定します。

CEが1つしかない場合はCE#0とみなして指定してください。

入力条件:

  • 存在しないCMは指定できません。

  • 異常状態のCMは指定できません。

raid6fr_configuration_priority

string

RAID6-FRのDrive構成の優先項目。
項目 説明
capacity 容量効率を優先してDrive構成を決定します。
rebuild Rebuild速度を優先してDrive構成を決定します。

入力条件:

  • 以下の条件をすべて満たす場合、指定する必要があります。

    • RAID LevelがRAID6FRである。

    • 以下の条件のいずれかを満たす。

      • is_auto_drive_selectionをtrueにしている。

      • drive_id_listで指定したDriveの本数が31である。

  • 上記条件を満たさない場合、指定することはできません。

drive_type

string

Driveを自動で選択する際の選択対象とするDriveのType。

is_auto_drive_selectionをtrueにしている場合は設定が必須です。
項目 説明
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

入力条件:

  • is_auto_drive_selectionをtrueにしている場合以外は設定できません。

minimum_capacity

integer

Thin Provisioning Poolの最小容量。

単位はMBです。

Driveを自動で選択する際に、本項目に設定された容量を最低限満たすような構成でDriveを決定します。

is_auto_drive_selectionをtrueにしている場合は設定が必須です。

入力条件:

  • 指定可能な範囲は24~50331648です。

  • is_auto_drive_selectionをtrueにしている場合以外は設定できません。

  • 装置に積載されている未使用のDriveが不足している場合は拡張処理が失敗します。

Responses

正常にジョブ登録できた場合、HTTPステータスコードが202 (Accepted)となりレスポンスボディを応答します。

RESPONSE BODY

job_id

integer

Job ID。

job_href

string

JobのResourceへのLink。