You need to enable JavaScript to run this app.
导航
挂载云盘
最近更新时间: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 请求失败。关于错误码的更多信息,参见错误码