扩容云盘--边缘计算节点-火山引擎

文档中心

立即注册

导航

边缘计算节点

扩容云盘

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

本接口用于扩容云盘的容量。

使用说明

前提条件：

如果需要被扩容的云盘已经挂载到了边缘实例，该边缘实例在云盘扩容时必须处于运行中（running）或已停止（stopped）状态。
云盘需处于已挂载（attached）或未挂载（detached）状态。

注意事项：

如果云盘还未挂载到边缘实例，扩容云盘后您可以接着执行以下操作：
1. 挂载云盘。详细步骤，请参考挂载云盘。
2. 初始化云盘。详细步骤，请参考初始化数据盘（Windows）和初始化数据盘（Linux）。
如果云盘已挂载到边缘实例，扩容云盘后您需要接着执行以下操作：
扩容分区和文件系统。详细步骤，请参考扩容分区和文件系统（Linux）和扩容分区和文件系统（Windows）。

请求说明

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

请求参数

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

Query

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

Body

参数	类型	是否必选	示例值	描述
ebs_id	String	是	disk-tvs2gmln****	云盘的 ID。您可以通过调用 ListEbsInstances 接口查询云盘的 ID。
capacity	String	是	100	扩容后的云盘的容量。取值范围：20~1000。单位：GB。取值须是 10 的倍数。
with_reboot	Boolean	否	true	是否重启实例。取值范围： true：重启实例。 false（默认值）：不重启实例。说明该参数仅适用于已挂载到了边缘实例的云盘。如果云盘挂载到了 x86 实例，您无需重启实例。如果云盘挂载到了 ARM 实例，您必须重启实例使扩容配置生效。

参数

类型

是否必选

示例值

描述

ebs_id

String

是

disk-tvs2gmln****

云盘的 ID。您可以通过调用 ListEbsInstances 接口查询云盘的 ID。

capacity

String

是

100

扩容后的云盘的容量。取值范围：20~1000。单位：GB。取值须是 10 的倍数。

with_reboot

Boolean

否

true

是否重启实例。取值范围：

true：重启实例。
false（默认值）：不重启实例。

说明

该参数仅适用于已挂载到了边缘实例的云盘。

如果云盘挂载到了 x86 实例，您无需重启实例。
如果云盘挂载到了 ARM 实例，您必须重启实例使扩容配置生效。

返回参数

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

请求示例

POST https://veenedge.volcengineapi.com/?Action=ScaleEbsInstanceCapacity&Version=2021-04-30
&<其他公共参数>
{
    "ebs_id": "disk-25mdrqmd5nd****",
    "capacity": "100"
}

返回示例

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

错误码

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