链接复制成功!
扩容文件系统 - ExpandShare
功能介绍
扩容文件系统。
接口约束
该接口不适用于100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/sfs-turbo/shares/{share_id}/action
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于标识资源所属的IAM项目空间,实现项目级资源隔离与权限管控。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| share_id | 是 | String | 参数解释: 文件系统ID,用于唯一标识SFS Turbo文件系统实例。获取方法请参见1.4 获取文件系统列表 - ListShares。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权认证。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| Content-Type | 是 | String | 参数解释: 请求消息体MIME类型,用于标识请求正文的数据格式。 约束限制: 不涉及。 取值范围: application/json 默认取值: application/json |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| extend | 是 | Extend object | 参数解释: 扩容请求参数对象,包含扩容后的目标容量等配置信息。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| new_size | 是 | Integer | 参数解释: 扩容后文件系统的新容量,以GiB为单位。 约束限制:
取值范围: 默认取值: 不涉及。 |
| new_bandwidth | 否 | Long | 参数解释: 扩容后文件系统的带宽目标值,单位为Gbps。 约束限制: 仅HPC缓存型支持带宽扩缩。 取值范围: 默认取值: 不涉及。 |
| bss_param | 否 | BssInfoExtend object | 参数解释: 包周期扩容计费详情,用于指定包周期文件系统扩容时的计费和支付相关参数。 约束限制: 仅包周期计费模式的文件系统扩容时需要填写。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:202
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: SFS Turbo文件系统的ID。 取值范围: 不涉及。 |
| name | String | 参数解释: SFS Turbo文件系统的名称。 取值范围: 不涉及。 |
请求示例
扩容一个文件系统,扩容后的文件系统目标容量是1000GB。
{
"extend" : {
"new_size" : 1000
}
} 响应示例
状态码:202
{
"id" : "67d4bd5e-7b2f-4c24-9a0b-c0038940c6f8",
"name" : "sfs-turbo-test"
} 状态码
| 状态码 | 描述 |
|---|---|
| 202 | 扩容文件系统请求下发成功返回body |
错误码
请参见错误码。