文档首页/ 云手机服务器 CPH/ API参考/ 云手机服务器API/ 云手机服务器管理/ 变更云手机服务器规格
更新时间：2024-04-19 GMT+08:00
查看PDF
分享

变更云手机服务器规格

功能介绍

变更云手机服务器规格。变更的目标规格也必须为特殊的规格才可变更。接口调用成功后，大约2分钟左右规格会变更结束，在订单中心可以查看到变更的订单状态为成功，且查询服务器的详细信息，可以查看到服务器规格名称已经变成新的规格名称。

URI

POST /v1/{project_id}/cloud-phone/servers/change-server-model

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
表3 请求Body参数

参数

是否必选

参数类型

描述

server_id

是

String

云手机服务器的唯一标识。只有特定的服务器才能操作变更规格。

server_model_name

是

String

目标云手机服务器规格，不超过64个字节。仅允许相同代系服务器之间的规格切换。

phone_model_name

是

String

目标云手机规格。要求与变更前云手机规格路数相同，与目标云手机服务器规格匹配。

extend_param

否

extend_param object

购买模式参数。
表4 extend_param

参数

是否必选

参数类型

描述

is_auto_pay

否

Integer

否自动付款。默认不自动付款。如果是规格升配的变更，则需要支付额外的费用，如果是降配的变更，则会自动退款。

  • 1 ：自动付款

  • 0 ：不自动付款

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

order_id

String

订单ID，不超过64个字节。

product_id

String

产品ID，不超过64个字节。

请求示例

变更服务器的规格

POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/servers/change-server-model

{
  "server_id" : "a176d8625981453bbafbc0a321d8d6a1",
  "server_model_name" : "physical.rx1.xlarge.special",
  "phone_model_name" : "rx1.cp.sp.c105.d8.e5v5",
  "extend_param" : {
    "is_auto_pay" : 1
  }
}

响应示例

状态码： 200

OK

{
  "request_id" : "1564567b8bab40f34711234cb80d8574",
  "order_id" : "CS1710111105S8IPB",
  "product_id" : "00301-25217-0--0"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。