• Elastic Cloud Server

ecs
  1. Help Center
  2. Elastic Cloud Server
  3. API Reference
  4. Extension ECS APIs
  5. Disk Management
  6. Querying a Single Disk Attached to an ECS

Querying a Single Disk Attached to an ECS

Function Description

This interface is used to query a single disk attached to an ECS.

URI

GET /v2.1/servers/{server_id}/block_device/{volume_id}

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

server_id

Yes

Specifies the ECS ID in UUID format.

volume_id

Yes

Specifies the EVS disk ID in UUID format.

Request

N/A

Response

Response parameters

Table 2 describes the response parameters.
Table 2 Response parameters

Parameter

Type

Description

volumeAttachment

Dict

Specifies the disk attached to an ECS. For details, see Table 3.

Table 3 volumeAttachment parameters

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

Bool

Specifies the EVS disk boot sequence.

  • 0 indicates the system disk.
  • Non-0 indicates a data disk.

bus

String

Specifies the disk bus type.

Options: virtio and scsi

Examples

  • Example request
    GET /v2.1/servers/4d8c3732-a248-40ed-bebc-539a6ffd25c0/block_device/a26887c6-c47b-4654-abb5-dfadf7d3f803
  • 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

See General Request Returned Values.

Error Code

See Error Code Description.