功能介绍

• 接口名称

  ChangeCloudPhoneServerModel

• 功能描述

  变更云手机服务器规格。

• 约束
  • 只有能使用physical.rx1.xlarge.special私有规格的租户才可使用本接口。
  • 变更的目标规格也必须为特殊的规格才可变更。
  • 接口调用成功后，大约2分钟左右规格会变更结束，在订单中心可以查看到变更的订单状态为成功，且查询服务器的详细信息，可以查看到服务器规格名称已经变成新的规格名称。

URI

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

参数说明请参见表5-23。

请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  server_id	是	String	云手机服务器的唯一标识。只有特定的服务器才能操作变更规格。
  server_model_name	是	String	要变更为的目标云手机服务器规格，不超过64个字节。 当前只支持填写physical.rx1.xlarge.special
  extend_param	否	extend_param结构体	购买模式参数，详情请参见表2 extend_param数据结构说明。

  表2 extend_param数据结构说明

  参数	是否必选	参数类型	描述
  is_auto_pay	否	Integer	是否自动付款。默认不自动付款。如果是规格升配的变更，则需要支付额外的费用，如果是降配的变更，则会自动退款。 1 表示自动付款 0 表示不自动付款

• 请求样例

  POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/servers/change-server-model 
   {
      "server_id": "a176d8625981453bbafbc0a321d8d6a1",
      "server_model_name": "physical.rx1.xlarge.special",
      "extend_param": {
          "is_auto_pay": 1
      }
  }

响应消息

• 响应参数

  参数	参数类型	描述
  request_id	String	请求的唯一标识ID。不超过32个字节。
  order_id	Stirng	订单ID，不超过64个字节。
  product_id	String	产品ID，不超过64个字节。

• 响应样例

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

返回值

请参考返回值。

错误码

请参考错误码。