Files

wanghuijuan738 8f024b87ae ECS API 20251204 version. Adding an API Document.

Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: wanghuijuan738 <wanghuijuan738@huawei.com>
Co-committed-by: wanghuijuan738 <wanghuijuan738@huawei.com>

2025-12-17 11:05:14 +00:00

9.5 KiB

Raw Blame History

Listing Details About Disks Attached to an ECS

Function

This API is used to list details about disks that have been and are being attached to an ECS.

URI

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

GET /v2/{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.
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

List details about disks attached to an ECS.

GET https://{endpoint}/v2/{project_id}/servers/{server_id}/os-volume_attachments
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"
        }
    ]
}

Returned Values

See Returned Values for General Requests.

Parent topic: Disk Management

9.5 KiB Raw Blame History