挂载云盘--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

挂载云盘

最近更新时间：2024.07.02 10:27:10首次发布时间：2024.03.12 19:08:29

本接口用于将云盘挂载到边缘实例。您可以一次指定一个或多个云盘。

使用说明

使用限制：

边缘实例仅能挂载与其处于同一节点的云盘。
不同规格的边缘实例可挂载的云盘的数量有所不同。详情请参见配额说明。
如果边缘实例创建时间较早，您需要先重启实例后再执行挂载云盘的操作。系统会进行校验、判断是否需要通过重启来升级实例。

前提条件：

云盘处于未挂载（detached）状态。
边缘实例处于运行中（running）或已停止（stopped）状态。

注意事项：
云盘挂载到边缘实例后，您还无法直接使用增加的云盘容量。您需要登录边缘实例对云盘进行初始化操作。详细步骤，请参考初始化数据盘（Linux）和初始化数据盘（Windows）。

请求说明

请求方式：POST
请求地址：https://veenedge.volcengineapi.com?Action=AttachEbs&Version=2021-04-30

请求参数

下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。其他公共参数，请参见公共参数。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	AttachEbs	公共参数。该参数表示接口名称。取值：AttachEbs。
Version	String	是	2021-04-30	公共参数。该参数表示接口版本。取值：2021-04-30。

Body

参数	类型	是否必选	示例值	描述
ebs_ids	[]String	是	["disk-tvs2gmln****"]	云盘的 ID 的列表。
res_type	String	是	veen	云盘挂载到的资源的类型： veen：边缘实例
res_id	String	是	veen1020125208252511****	云盘挂载到的资源的 ID。
delete_with_res	Boolean	否	true	是否随挂载的边缘实例一起删除。取值范围： true：边缘实例被删除时，云盘也会一起被删除。 false （默认值）：边缘实例被删除时，云盘会被保留。

返回参数

该接口无特有的返回参数。

请求示例

POST https://veenedge.volcengineapi.com/?Action=AttachEbs&Version=2021-04-30
&<其他公共参数>
{
    "ebs_ids": [
        "disk-dfr29n996bl****"
    ],
    "res_type": "veen",
    "res_id": "veen0522220112101114****",
    "delete_with_res": true
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240125174000A313A377FE1E2D63****",
        "Action": "ScaleEbsInstanceCapacity",
        "Version": "2021-04-30",
        "Service": "veenedge",
        "Region": "cn-north-1"
    }
}

错误码

如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。