Block storage APIs
Contributors
Download PDF of this page
You can use Block Storage APIs to view and manage your block storage.
Before you create disks, you have to create block stores. When you create a disk, you have to a create host group or select an existing host group to access the disk. For more information, see Work with block storage.
Block stores
You can use Block Store APIs to retrieve and manage your block stores.
| HTTP Verb | Path | Description | Mandatory parameters/Request body |
|---|---|---|---|
|
|
You can retrieve the details of all your block stores. Retrieves details of the block stores, such as block store ID, IP address, region, zone, subnet ID, and tags. |
|
|
|
You can retrieve the details of a specific block store. Retrieves details of the block store, such as IP address, region, zone, subnet ID, and tags based on the entered ID. |
|
|
|
You can create a block store. Add the values in the request body to create a block store with the specified parameters, such as service protocol, subtenant ID, zone, subnet ID, and tags. |
|
|
|
You can create or replace tags for a block store. Add the ID of the block store, and the values for the tags in the "key:value pair" format in the request body. |
|
|
|
You can modify any block store based on its ID. Add the ID of the block store, and the values that you want to modify in the request body, such as zone, service protocol, and tags. |
|
|
|
You can delete any block store by its ID. |
|
| Before you delete a block store, you should delete all the disks mapped to it. |
Disks
You can use Disks APIs to retrieve and manage your disks.
| HTTP Verb | Path | Description | Mandatory parameters/Request body |
|---|---|---|---|
|
|
You can retrieve the details of all your disks. Retrieves details of the disks, such as block store ID, name, disk path, protocol, snapshot policy, and tags. |
|
|
|
You can retrieve the details of a specific disk. Retrieves details of the disk, such as block store ID, name, disk path, protocol, snapshot policy, and tags based on the entered ID. |
|
|
|
You can create a disk. Add the values in the request body to create a disk with the specified parameters, such as subtenant ID, zone, name, disk path, snapshot policy, backup policy, and tags. |
|
|
|
You can create a snapshot of a disk. |
|
|
|
You can create or replace tags for a disk. Add the ID of the disk and the values for the tags in the "key:value pair" format in the request body. |
|
|
|
You can modify any disk based on its ID. Add the ID of the disk, and the values that you want to modify in the request body, such as such as name, service level, snapshot policy, backup policy, and tags. |
|
|
|
You can delete any disk by its ID. |
|
|
|
You can delete any snapshot of a disk by the ID of the disk and the name of the snapshot. |
|
Host groups
Access control to disks is managed with host groups. You can retrieve and manage host groups using Host Groups APIs.
| HTTP Verb | Path | Description | Mandatory parameters/Request body |
|---|---|---|---|
|
|
You can retrieve the details of all your host groups. Retrieves details of the host groups, such as name, subtenant details, tenant details, zone, protocol, initiators, disks using the host group, and tags. |
|
|
|
You can retrieve the details of a specific host group. Retrieves details of the host group, such as name, subtenant details, tenant details, zone, protocol, initiators, disks using the host groups, and tags based on the entered ID. |
|
|
|
You can create a host group. Add the values in the request body to create a host group with the specified parameters, such as name, subtenant ID, zone, protocol, initiators, and tags. |
|
|
|
You can create or replace tags for a host group. Add the ID of the host group and the values for the tags in the "key:value pair" format in the request body. |
|
|
|
You can delete any host group by its ID. |
|
Initiators in a host group
You can use Host Groups APIs to retrieve and manage the initiators mapped to your host groups.
| HTTP Verb | Path | Description | Mandatory parameters/Request body |
|---|---|---|---|
|
|
You can retrieve the details of all your initiators. Retrieves initiators and their aliases. |
|
|
|
You can retrieve the details of a specific initiator. Retrieves the initiator based on the entered ID and alias. |
|
|
|
You can create an initiator for a host group. Add the values for the initiator and its alias in the request body to create an initiator for the host group. |
|
|
|
You can modify an initiator. Add the new initiator in the request body. |
|
|
|
You can delete an initiator by the ID of the host group and the alias of the initiator. |
|
|
When adding initiators to a host group, the initiator should match the host group protocol. You should use IQNs for host groups with iSCSI protocol, and WWPNs for host groups with FC protocol. Deleting an initiator from a host group affects all the disks to which the host group is mapped to. |
Edit on GitHub