Updated on 2024-07-16 GMT+08:00

Querying Disks Attached to an ECS

Function

This API is used to query the disks that have been and are being attached to an ECS.

URI

GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments

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

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the ID, see Obtaining a Project ID.

server_id

Yes

Specifies the ECS ID.

Request

None

Response

Response parameters

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.

Table 3 volumeAttachments field description

Parameter

Type

Description

device

String

Specifies the attached directory.

id

String

Specifies the ID of the attached resource.

serverId

String

Specifies the ECS ID.

volumeId

String

Specifies the ID of the attached disk.

Example Request

Query details about disks attached to an ECS.

GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-volume_attachments

Example Response

{
    "volumeAttachments": [
        {
            "device": "/dev/sdd",
            "id": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
            "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
            "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803"
        },
        {
            "device": "/dev/sdc",
            "id": "a26887c6-c47b-4654-abb5-dfadf7d3f804",
            "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0",
            "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f804"
        }
    ]
}