Function

This API is used to query a disk attached to an ECS based on the disk ID.

URI

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

GET /v2/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id}

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.
volume_id	Yes	Specifies the disk ID.

Request

None

Response

Table 2 describes the response parameters.

**Table 2** Response parameters
Parameter	Type	Description
volumeAttachment	Object	Specifies the disks attached to an ECS. For details, see Table 3.

**Table 3** **volumeAttachment** 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

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

Example Response

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

Returned Values

See Returned Values for General Requests.