Media Format

How does it work?

If the user inputs an id, the function returns information concerning the corresponding media format, regardless of the other parameters.
Else if the user only inputs a name, the id of the corresponding media format is returned.
Else (user leaves both fields blank), an array of supported formats is returned.

When inputting an ID

To get an media format by its id use GET method :

path : /storiqone-backend/api/v1/mediaformat/?id=<integer> 

Parameters

id	: id of an existing media format

Example of request :

GET http://api.storiqone/storiqone-backend/api/v1/mediaformat/?id=1 

Response :

 {
   "mediaformat" : {
      "blocksize" : 32768,
      "capacity" : 2620446998528,
      "datatype" : "data",
      "densitycode" : 90,
      "id" : 1,
      "lifespan" : "10 years",
      "maxloadcount" : 4096,
      "maxopcount" : 40960,
      "maxreadcount" : 40960,
      "maxwritecount" : 40960,
      "mode" : "linear",
      "name" : "LTO-6",
      "supportmam" : true,
      "supportpartition" : true
   },
   "message" : "Query succeeded"
}

When only inputting a name

To get an media format id by its name use GET method :

path : /storiqone-backend/api/v1/mediaformat/?name=<string> 

Parameters

name	: name of an existing media format

Example of request :

GET http://api.storiqone/storiqone-backend/api/v1/mediaformat/?name=LTFS 

Response :

 {
    "message":"Query succeeded",
    "mediaformat id":2
 }

Returning an array of supported formats

To get media format id list, use GET method : without reference to specific id or ids

path : /storiqone-backend/api/v1/mediaformat/ 

Optional parameters

Name	Type	Description	Constraint
order_by	enum	order by column	value in : 'id', 'name'
order_asc	boolean	TRUE will perform an ascending order and FALSE will perform an descending order. order_asc is ignored if order_by is missing.
limit	integer	specifies the maximum number of rows to return.	limit > 0
offset	integer	specifies the number of rows to skip before starting to return rows.	offset >= 0

Warning

To get multiple media ids list do not pass an id or ids as parameter

Returns

HTTP status codes :

• 200 Query succeeded

Media format id list is returned
{
   "media formats" : [
      1,
      2,
      3,
      4,
      5,
      6,
      7
   ],


   "message":"Query successful",
   "total_rows" : 7

}

• 400 Incorrect input
• 401 Not logged in
• 500 Query failure