| Enterprise Edition Functionality This feature is available in Abiquo Enterprise Edition |
| Cloud Admin | Enterprise Admin | User |
|---|---|---|
| |
|
|
Contents:
- Actions related with the Storage system monitor
- Retrieve the storage system monitor resource
- Retrieve the detailed information about the storage system
- Retrieve the list of the available pools into the storage system
- Resources related with the storage pools managed by Abiquo
- Retrieve the list of the managed pools
- Create a managed storage pool
- Retrieve a managed storage pool
- Modify a storage pool
- Delete a managed storage pool
- Actions related with the storage pools managed by Abiquo
Storage system monitor is the remote service in charge of manage the storage pools that Abiquo defines. In this section we are going to explain how to use the actions that the resource exposes and how to manage the pools that it defines.
Actions related with the Storage system monitor
Retrieve the storage system monitor resource
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/{$type}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve the Storage system monitor service
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 200, 401, 403.
Example Response: Response of the GET over the storage system monitor resource
Retrieve the detailed information about the storage system
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/actions/storageInfo
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve the information about the storage system
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 200, 401, 403.
Example Response: Response of the GET over the information of the storage system
Retrieve the list of the available pools into the storage system
Retrive the list of all available pools, managed and non managed by Abiquo.
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/actions/availablePools
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve the list of the available pools
Response Headers: Content-Length, Content-Type.
Response Message Body: Pools
Response Status: 200, 401, 403.
Example Response: Response of the GET over the list of the available pools
Resources related with the storage pools managed by Abiquo
Each Storage system monitor has a list of managed pools attached. This sections describes how to retrive and manage them.
Retrieve the list of the managed pools
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve the list of the managed pools
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 200, 401, 403.
Example Response: Response of the GET over the list of the storage pools
Create a managed storage pool
Once we get the list of the available storage pools we can asociate them to Abiquo creating a storage pool resource.
Synopsis: POST http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Create a new managed pool
Response Headers: Content-Length, Content-Type, Location.
Response Message Body: RemoteService
Response Status: 201, 401, 403.
Example Response: Response of the POST over the list of the storage pools
Retrieve a managed storage pool
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools/{$poolId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve a managed pool
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 201, 401, 403.
Example Response: Response of the POST over the list of the storage pools
Modify a storage pool
Synopsis: PUT http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools/{$poolId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Update managed pool
Response Headers: Content-Length, Content-Type, Location.
Response Message Body: RemoteService
Response Status: 200, 401, 403.
Example Response: Response of the PUT over a storage pool
Delete a managed storage pool
Synopsis: DELETE http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools/{$poolId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Delete a managed pool
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 204, 401, 403.
Example Response: Response of the DELETE over a storage pool
Actions related with the storage pools managed by Abiquo
Add ISCSI Initiator IQN
Synopsis: POST http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools/{$storagePoolId}/actions/addInitiator?iqn={$iqn}&osType={$ostype}. The parameter iqn is required and ostype is optional.
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Add ISCSI Initiator IQN
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 200, 401, 403.
Example Response: Response of the POST add ISCSI Initiator IQN
Remove ISCSI Initiator IQN
Synopsis: POST http://example.com/api/admin/datacenters/{$datacenterId}/remoteServices/storage_system_monitor/storagePools/{$storagePoolId}/actions/removeInitiator?iqn={$iqn}&ostype={$ostype}. The parameter iqn is required and ostype is optional.
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Remove ISCSI Initiator IQN
Response Headers: Content-Length, Content-Type.
Response Message Body: RemoteService
Response Status: 200, 401, 403.
Example Response: Response of the POST remove ISCSI Initiator IQN
OSType enumeration values
| solaris | Solaris raw disk in a single-slice partition |
| windows | A raw disk device in a single-partition Windows disk |
| pux | HP-UX data |
| aix | AIX data |
| linux | A Linux raw disk without anypartition table |
| netware | NetWare data |
| vmware | VMWARE data |
| windows_gpt | Windows data using the GPT (GUID Partiton Type) partitioning style |
| windows_2008 | Windows data on Windows 2008 systems |
| openvms | OpenVMS data |
| xen | Xen data |
| hyper_v | Hyper-V data |


Comments (1)
Dec 06, 2010
Anonymous says:
For the "Create a managed storage pool" command, the response doesn't contain th...For the "Create a managed storage pool" command, the response doesn't contain the ID value, as in all other Creation Commands?