Creating a Thin Provisioning Pool
POST /tppIntroduction
Creates a new Thin Provisioning Pool.
You cannot create a Thin Provisioning Pool in any of the following conditions.
The Thin Provisioning function is not enabled.
The sum of the physical capacities of Thin Provisioning Pools and Flexible Tier Pools exceeds the Maximum Pool Capacity.
The maximum number of Thin Provisioning Pools for the device have been created.
The device does not have enough resources (RAID Groups, Volumes, etc.) to create a Thin Provisioning Pool.
You can find the Href of the created Thin Provisioning Pool in resource_href_list of GET /job/{job_id}.
Tenant users cannot execute this command.
Request Examples
This is an example of creating a RAID 5 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"]}] }'This is an example of creating a RAID 6 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"}'This is an example of creating a RAID 5 Thin Provisioning Pool using the Drive Auto-Selection feature.
$ 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}'
Response Examples
{
"job_id": 8192001,
"job_href": "/api/v1/job/8192001"
}
Parameters
REQUEST BODY
| name
(required) |
string Thin Provisioning Pool name. Input criteria:
|
||||||||||||||||||
| level
(required) |
string The RAID Level of the RAID Groups that configure the Thin Provisioning Pool.
|
||||||||||||||||||
| warning_threshold | integer Default: 90 Warning threshold. The unit is %. If the Thin Provisioning Pool utilization (percentage of used capacity to the total physical capacity) exceeds this threshold, the TPP usage will transition to Warning. Input criteria:
|
||||||||||||||||||
| attention_threshold | integer Default: 75 Attention threshold. The unit is %. If the Thin Provisioning Pool utilization (percentage of used capacity to the total physical capacity) exceeds this threshold, the usage will transition to Attention. If this item is set to 0, the Attention threshold is not set. Input criteria:
|
||||||||||||||||||
| is_cm_encryption_enabled | boolean Default: false Encryption via CM. If true, the data in the Thin Provisioning Pool is encrypted by the CM. Input criteria:
|
||||||||||||||||||
| is_compression_disabled | boolean Default: false Whether Compression is disabled. If true, the data in the TPP will not be compressed. Input criteria:
|
||||||||||||||||||
| is_deduplication_disabled | boolean Default: false Whether Deduplication is disabled. If true, the data in the TPP will not be deduplicated. Input criteria:
|
||||||||||||||||||
| is_auto_drive_selection | boolean Default: false Whether the system automatically determines which drives comprise the Thin Provisioning Pool. If true, the Drive will be automatically selected to create a Thin Provisioning Pool. Input criteria:
Caution
For automatic drive selection, a TPP is created without distinguishing between AF compatible and non-AF compatible drives. If both drives are used, select Drives manually. |
||||||||||||||||||
| raidgroup_list | Array of objects Input criteria:
|
||||||||||||||||||
| raid6fr_configuration_priority | string RAID 6-FR Drive configuration priority.
Input criteria:
|
||||||||||||||||||
| drive_type | string The type of Drive to be selected when Drives are automatically selected. Required if is_auto_drive_selection is true.
Input criteria:
|
||||||||||||||||||
| minimum_capacity | integer Minimum capacity of Thin Provisioning Pool. The unit is MB. When selecting Drive automatically, determine the Drive configuration that meets the minimum amount of space set in this item. Required if is_auto_drive_selection is true. Input criteria:
|
Responses
If successful, the HTTP status code is 202 (Accepted) and the response body is returned.
RESPONSE BODY
| job_id | integer Job ID. |
| job_href | string Resource link of the job. |