基于磁盘ID查询云硬盘

GET

/v4/ebs/info-ebs

基于磁盘ID查询云硬盘详情。
** 注意**：此接口原始接口支持GET body 请求模式从1.14.28 版本修改为支持GET Query模式并对老版本进行了兼容，公有云同步修改为GET Query模式。如您使用的版本低于1.14.28 请使用GET body 请求模式进行请求
增加diskId兼容

请求参数

Authorization

在 header 添加参数

userID

示例：

userID: ********************

Query 参数

Header 参数

Body 参数application/json

示例

{
    "diskID": "01645b4a-2575-4755-a9bd-86584835c32a",
    "regionID": "nm8"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://ct-global.ctapi-internal.ctyun.local:31111/v4/ebs/info-ebs?diskID=bacaeaf4-0dd9-4adf-be76-87c13017d139&regionID=nm8' \
--header 'x-ctyun-user-id: {{userID}}' \
--header 'Accept-Language: zh-CN' \
--header 'userId: ef378f73-1c52-435e-90f2-6a9cd2258c8e' \
--header 'userID: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "diskID": "01645b4a-2575-4755-a9bd-86584835c32a",
    "regionID": "nm8"
}'

返回响应

🟢200successful operation

application/json

Body

示例

{
    "description": "成功",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "attachments": [
            {
                "attachmentID": "9681",
                "device": "/dev/vdb",
                "instanceID": "26844427-258f-b67f-5603-adc3466b37d4"
            }
        ],
        "azName": "az3",
        "createTime": 1703038792961,
        "cycleType": "M",
        "diskID": "3d681eff-ffc3-410a-866d-53d17572a0b9",
        "diskId": "3d681eff-ffc3-410a-866d-53d17572a0b9",
        "diskName": "ebs-wgqu11",
        "diskSize": 10,
        "diskStatus": "in-use",
        "diskType": "SATA",
        "expireTime": 1705717197000,
        "instanceID": "26844427-258f-b67f-5603-adc3466b37d4",
        "instanceName": "ecs-6shrh",
        "instanceStatus": "ACTIVE",
        "isEncrypt": false,
        "isPackaged": true,
        "isSystemVolume": false,
        "multiAttach": false,
        "onDemand": false,
        "projectID": "",
        "regionID": "nm8",
        "updateTime": 1705273943465
    },
    "statusCode": 800
}

修改于 2026-03-12 09:52:00

基于资源ID查询云硬盘

VPC 绑定扩展网段