Querying a Single Disk Attached to an ECS
Function
This API is used to query a single disk attached to an ECS.
URI
GET /v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
Parameter |
Mandatory |
Description |
---|---|---|
server_id |
Yes |
Specifies the ECS ID in UUID format. |
project_id |
Yes |
Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
volume_id |
Yes |
Specifies the EVS disk ID in UUID format. |
Request
None
Response
Parameter |
Type |
Description |
---|---|---|
volumeAttachment |
Object |
Specifies the disk attached to an ECS. For details, see Table 3. |
Parameter |
Type |
Description |
---|---|---|
serverId |
String |
Specifies the ECS ID in UUID format. |
volumeId |
String |
Specifies the EVS disk ID in UUID format. |
id |
String |
Specifies the mount ID, which is the same as the EVS disk ID. The value is in UUID format. |
size |
Integer |
Specifies the EVS disk size in GB. |
device |
String |
Specifies the drive letter of the EVS disk, which is the device name of the EVS disk. |
pciAddress |
String |
Specifies the PCI address. |
bootIndex |
Integer |
Specifies the EVS disk boot sequence.
|
bus |
String |
Specifies the disk bus type. Options: virtio and scsi |
Example Request
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/block_device/{volume_id}
Example Response
{ "volumeAttachment": { "pciAddress": "0000:02:01.0", "volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r", "device": "/dev/vda", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "id": "a26887c6-c47b-4654-abb5-asdf234r234r", "size": "40", "bootIndex": 0, "bus":"virtio" } }
Returned Values
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.