Create

POST v1/pools

Description

Creates a pool with given attributes.

Normal Response Codes

201

HTTP Error Codes

400 401 403 404 409 500 503

Detail Codes

SM_array_flash_mismatch

SM_array_not_assigned

SM_array_not_found

SM_cannot_read_object

SM_invalid_arg_value

SM_invalid_path_variable

SM_invalid_query_param

SM_malformed_url

SM_missing_arg

SM_no_method_for_URL_pattern

SM_no_operation_found

SM_no_path_found

SM_pool_exists

SM_too_many

SM_unexpected_arg

SM_unexpected_child

SM_unexpected_query_param

SM_version_name

Request

Parameter Type JSON Type Description Default Mandatory Deprecated
name NsObjectName string Name of pool. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.   true  
description NsDescription string Text description of pool. String of up to 255 printable ASCII characters. Example: '99.9999% availability'. '' false  
array_list NsArrayDetailList Array of NsArrayDetail List of arrays in the pool with detailed information. When create/update array list, only arrays' id is required. List of arrays' detailed information.   true  
dedupe_all_volumes NsBoolean boolean Indicates if dedupe is enabled by default for new volumes on this pool. Possible values: 'true', 'false'. 'false' false  

JSON Request


            

{
   "data" : {
      "array_list" : [
         {
            "id" : "0900000000000004d3000000000000000000000003",
            "array_id" : "0900000000000004d3000000000000000000000003"
         }
      ],
      "name" : "pool0.0645689306120438"
   }
}

      
         

Response

Parameter Type JSON Type Description Deprecated
id NsObjectID string Identifier for the pool. A 42 digit hexadecimal number. Example: '2a0df0fe6f7dc7bb16000000000000000000004817'.  
name NsObjectName string Name of pool. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.  
full_name NsObjectName string Fully qualified name of pool. String of up to 64 alphanumeric characters, - and . and : are allowed after first character. Example: 'myobject-5'.  
search_name NsSearchName string Name of pool used for object search. Alphanumeric string, up to 64 characters including hyphen, period, colon. Example: 'vol:1'.  
description NsDescription string Text description of pool. String of up to 255 printable ASCII characters. Example: '99.9999% availability'.  
creation_time NsTime number Time when this pool was created. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
last_modified NsTime number Time when this pool was last modified. Seconds since last epoch i.e. 00:00 January 1, 1970. Example: '3400'.  
capacity NsBytes number Total storage space of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
usage NsBytes number Used space of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
unused_reserve NsBytes number Unused reserve space of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
free_space NsBytes number Free space of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
cache_capacity NsBytes number Total usable cache capacity of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
pinnable_cache_capacity NsBytes number Total pinnable cache capacity of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
pinned_cache_capacity NsBytes number Total pinned cache capacity of the pool in bytes. Unsigned 64-bit integer. Example: '1234'.  
dedupe_capacity_bytes NsBytes number The dedupe capacity of a hybrid pool. Does not apply to all-flash pools. Unsigned 64-bit integer. Example: '1234'.  
dedupe_usage_bytes NsBytes number The dedupe usage of a hybrid pool. Does not apply to all-flash pools. Unsigned 64-bit integer. Example: '1234'.  
compression_ratio NsRatio number Compression savings for the pool expressed as ratio. Fraction expressed as floating point number. Example: '9.18'.  
dedupe_ratio NsRatio number Dedupe savings for the pool expressed as ratio. Fraction expressed as floating point number. Example: '9.18'.  
clone_ratio NsRatio number Clone savings for the pool expressed as ratio. Fraction expressed as floating point number. Example: '9.18'.  
vol_thin_provisioning_ratio NsRatio number Thin provisioning savings for volumes in the pool expressed as ratio. Fraction expressed as floating point number. Example: '9.18'.  
snapcoll_count NsUnsignedLong number Snapshot collection count. Unsigned 64-bit integer. Example: 1234.  
snap_count NsUnsignedLong number Snapshot count. Unsigned 64-bit integer. Example: 1234.  
array_count NsUnsignedLong number Number of arrays in the pool. Unsigned 64-bit integer. Example: 1234.  
vol_count NsUnsignedLong number Number of volumes assigned to the pool. Unsigned 64-bit integer. Example: 1234.  
array_list NsArrayDetailList Array of NsArrayDetail List of arrays in the pool with detailed information. When create/update array list, only arrays' id is required. List of arrays' detailed information.  
unassigned_array_list NsArraySummaryList Array of NsArraySummary List of arrays being unassigned from the pool. List of arrays' information. Each item contains array_name and array_id for the array name and its ID respectively.  
vol_list NsVolumeList Array of NsVolumeSummary The list of volumes in the pool. List of volumes.  
pinned_vol_list NsPinnedVolumeInfoList Array of NsPinnedVolumeInfo The list of pinned volumes in the pool. List of pinned volumes in a pool.  
folder_list NsFolderList Array of NsFolderSummary The list of fully qualified names of folders in the pool. List of fully qualified names of folders in a pool.  
usage_valid NsBoolean boolean Indicates whether the usage of pool is valid. Possible values: 'true', 'false'.  
all_flash NsBoolean boolean Indicate whether the pool is an all_flash pool. Possible values: 'true', 'false'.  
dedupe_capable NsBoolean boolean Indicates whether the pool is capable of hosting deduped volumes. Possible values: 'true', 'false'.  
dedupe_all_volumes NsBoolean boolean Indicates if dedupe is enabled by default for new volumes on this pool. Possible values: 'true', 'false'.  
is_default NsBoolean boolean Indicates if this is the default pool. Possible values: 'true', 'false'.  

JSON Response


            

{
   "data" : {
      "snapcoll_count" : 0,
      "array_list" : [
         {
            "id" : "0900000000000004d3000000000000000000000003",
            "array_id" : "0900000000000004d3000000000000000000000003",
            "name" : "g1a3",
            "array_name" : "g1a3",
            "usage" : 0,
            "usage_valid" : true,
            "migrate" : "none",
            "evac_usage" : 0,
            "evac_time" : 0,
            "snap_usage_compressed_bytes" : 0,
            "usable_capacity" : 3983343616,
            "vol_usage_compressed_bytes" : 0
         }
      ],
      "array_count" : 1,
      "unassigned_array_list" : null,
      "free_space" : 0,
      "vol_list" : null,
      "pinned_cache_capacity" : 0,
      "snap_count" : 0,
      "id" : "0a00000000000004d3000000000000000000000002",
      "creation_time" : 1430267343,
      "usage" : 0,
      "usage_valid" : false,
      "pinned_vol_list" : null,
      "unused_reserve" : 0,
      "pinnable_cache_capacity" : 0,
      "search_name" : "pool0.0645689306120438",
      "last_modified" : 1430267343,
      "name" : "pool0.0645689306120438",
      "cache_capacity" : 0,
      "capacity" : 3983343616,
      "description" : "",
      "full_name" : "pool0.0645689306120438",
      "vol_count" : 0
   }
}