Help Center/ Elastic Cloud Server/ API Reference/ Out-of-Date APIs/ Disk Management/ Querying Disk Attachment of an ECS (Discarded)
Updated on 2022-09-05 GMT+08:00

Querying Disk Attachment of an ECS (Discarded)

Function

This API is used to query disk attachment of an ECS.

This API has been discarded. Use the API described in Querying Disk Attachments of an ECS.

URI

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

Table 1 lists the URI parameters.
Table 1 Parameter description

Parameter

Mandatory

Description

server_id

Yes

Specifies the ECS ID in UUID format.

Request

None

Response

Table 2 describes the response parameters.
Table 2 Response parameters

Parameter

Type

Description

volumeAttachments

Array of objects

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

attachableQuantity

Object

Specifies the number of disks that can be attached to an ECS. For details, see Table 4.

Table 3 volumeAttachments 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 attachment 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

Boolean

Specifies the EVS disk boot sequence.

  • 0 indicates the system disk.
  • Values other than 0 indicate a data disk.

bus

String

Specifies the disk bus type.

Value options: virtio and scsi

Table 4 attachableQuantity parameters

Parameter

Type

Description

free_scsi

Integer

Specifies the number of SCSI disks that can be attached to an ECS.

free_blk

Integer

Specifies the number of virtio_blk disks that can be attached to an ECS.

free_disk

Integer

Specifies the total number of disks that can be attached to an ECS.

Example Request

GET https://{endpoint}/v2.1/servers/4d8c3732-a248-40ed-bebc-539a6ffd25c0/block_device

Example Response

{
    "attachableQuantity": {
            "free_scsi": 23,
            "free_blk": 15,
            "free_disk": 23
     },
    "volumeAttachments": [
        {
            "pciAddress": "0000:02:01.0",
            "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
            "device": "/dev/vda",
            "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
            "id": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
            "size": "40",
            "bootIndex": 0,
            "bus":"virtio"
        },
        {
            "pciAddress": "0000:02:02.0",
            "volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r",
            "device": "/dev/vdb",
            "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
            "id": "a26887c6-c47b-4654-abb5-asdf234r234r",
            "size": "10",
            "bootIndex": 1,
            "bus":"virtio"
        }
    ]
}

Error Codes

See Error Codes.