Unpublish an RBS volume

POST/v1/remote_block_storage/volumes/{volume_id}/unpublish

A POST request to /v1/remote_block_storage/volumes/{volume_id}/unpublish will unpublish an RBS volume, removing its exposure as an iSCSI target without deleting it. This lets you disconnect a volume from a server (useful for tools like Terraform or the Kubernetes CSI driver). Specify a volume in the path parameter. The volume must be active to be unpublished.

This is an asynchronous operation: the volume's operational status moves to unpublishing and then to unpublished.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

FieldDetails
volume_id
string

A unique identifier of an RBS volume. Use this request to list all volume IDs.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/remote_block_storage/volumes/KQe1RaJY/unpublish"
{  "id": "KQe1RaJY",  "name": "name2116",  "size": 100,  "status": "active",  "location_id": 2020,  "location_code": "AMS2020",  "flavor_id": 3098,  "flavor_name": "RBS Flavor name2114",  "iops": 25156,  "bandwidth": 8750,  "labels": {},  "ip_address": null,  "target_iqn": null,  "operational_status": "unpublishing",  "created_at": "2025-12-31T00:00:00.000Z",  "updated_at": "2025-12-31T00:00:00.000Z"}