扩容磁盘
功能介绍
扩容磁盘。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/desktops/{desktop_id}/volumes/{volume_id}/expand
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
desktop_id |
是 |
String |
桌面ID。 |
volume_id |
是 |
String |
磁盘ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
否 |
String |
发送的实体的MIME类型。 |
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
new_size |
是 |
Integer |
扩容后的磁盘大小,单位为GB。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
job_id |
String |
扩容磁盘任务id。 |
getJobEndpoint |
String |
云运营平台CBC获取到JobId后,会使用getJobEndpoint当做URL,调用云服务,查询获取Job结果。 |
maxProvisionTime |
Integer |
在线开通最大时间。 |
minProvisionTime |
Integer |
开通最小时间(云服务最快开通时长,或一般开通时长)。 |
periodicQueryTime |
Integer |
Job周期性查询时间,默认1分钟查询一次。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 409
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
请求示例
POST /v2/9565be6e740941c493b38a1f46ecae6f/desktops/3ec05f83-b8a3-4c72-857f-b33f55943320/volumes/474e1bd3-8862-457a-bfaf-e381f873146f/expand { "order_id" : "a25e3d3f-8a8e-4789-bd3f-a04e230640fd", "new_size" : 120 }
响应示例
状态码: 200
正常。
{ "job_id" : "string", "bssJobId" : "string", "getJobEndpoint" : "string", "maxProvisionTime" : 20, "minProvisionTime" : 2, "periodicQueryTime" : 1 }
状态码
状态码 |
描述 |
---|---|
200 |
正常。 |
400 |
由于包含语法错误,当前请求无法被服务器理解。 |
401 |
鉴权失败。 |
403 |
没有操作权限。 |
404 |
找不到资源。 |
409 |
操作冲突。 |
500 |
服务内部错误,具体返回错误码请参见错误码说明。 |
错误码
请参见错误码。