文档首页 > > API参考> API> 生命周期管理> 购买云手机服务器

购买云手机服务器

分享
更新时间: 2019/06/14 GMT+08:00

功能介绍

  • 接口名称

    CreateCloudPhoneServer

  • 功能描述

    购买云手机服务器。

URI

  • URI格式

    POST /v1/{project_id}/cloud-phone/phones

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID

    获取项目ID请参考获取项目ID

请求

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    server_name

    String

    云手机服务器名称。

    不超过60字符,只支持英文字母、数字、汉字、下划线和中划线。

    批量购买会在服务器名称后自动添加序号,比如server-1。该服务器创建的云手机服务器名称会自动依次增加“0001”的序号,比如为server-1-0001。

    server_model_name

    String

    支持的云服务器规格。不超过64byte。

    可通过查询云手机服务器规格列表查询支持的云服务器规格。

    phone_model_name

    String

    不超过64byte。可通过查询云手机规格列表,查询支持的云手机规格。

    image_id

    String

    不超过32byte,通过查询手机镜像,查询云手机规格对应的镜像ID。

    count

    int

    购买的服务器个数。最多可购买10台。

    band_width

    band_width结构体

    云手机使用的带宽信息。独占带宽按流量计费,共享带宽可选择带宽大小。请参考表1

    extend_param

    extend_param结构体

    购买模式参数,详情请参考表2

    keypair_name

    String

    不超过64 byte,用于云手机ADB登录。

    获取密钥对的方式如下:

    1. 登录华为云。在服务列表,选择“计算 > 弹性云服务器”。
    2. 在左侧导航栏选择“密钥对”。

    vnc_enable

    String

    是否开启VNC方式登录云手机。

    • 为"true"时开启(忽略大小写)。
    • 为其他,则不开启。

    ports

    port结构体数组

    云手机实例启用的服务。云手机服务会做端口转发。请参考表3

    表1 band_width结构体

    名称

    是否必选

    参数类型

    说明

    band_width_id

    String

    共享带宽ID, 优先用该参数为手机绑定带宽。

    可通过查询带宽信息获取带宽ID。

    band_width_share_type

    否,band_width_id不存在时必选

    int

    带宽类型。

    • 0 表示独享带宽
    • 1 表示共享带宽

    band_width_size

    否,当band_width_share_type为共享带宽时必选

    int

    大于0,小于或等于300。(单位是Mbit/s)

    独享带宽的默认带宽是300Mbit/s。

    表2 extend_param结构体

    名称

    是否必选

    参数类型

    说明

    charging_mode

    int

    计费类型。

    • 0 表示包周期

    period_type

    int

    订购周期类型。

    • 2 表示月
    • 3 表示年

    period_num

    int

    订购周期数。

    当订购周期为月时,取值范围[1,9]。

    当订购周期为年时,取值范围[1,10]

    is_auto_pay

    int

    是否自动付款。默认不自动付款。

    • 1 表示自动付款
    • 0 表示不自动付款
    表3 port结构体数组

    名称

    是否必选

    参数类型

    说明

    name

    String

    16 byte,系统关键服务名称不能使用"adb"和"vnc"。

    listen_port

    int

    大于等于10000,小于等于50000

    internet_accessible

    String

    • 为"true"则映射出公网访问(忽略大小写)。
    • 为其他则不映射。
  • 请求样例
    POST https://{CPH_Endpoint}/v1/{project_id}/cloud-phone/phones
    {
        "server_name": "myPhoneServer",
        "server_model_name": "physical.rx1.xlarge",  
        "phone_model_name": "aphs1.medium.4.aosp",  
        "image_id": "88b8449b896f3a4f0ad57222dd919899", 
        "count": 3,   
        "keypair_name": "mykeypair",
        "vnc_enable": "true",
        "ports": [         
            {
              "name": "myServer1",
              "listen_port":20000,
              "internet_accessible": "false"
            },
            {
              "name": "myServer2",
              "listen_port":20001,
              "internet_accessible": "true"
            }
        ],
       "band_width":{
            "band_width_share_type": 0 
       },
       "extend_param": {
           "charging_mode": 0,
           "period_type": 2, 
           "period_num": 1, 
           "is_auto_pay": 1
        }
    }

响应

  • 要素说明

    名称

    参数类型

    说明

    request_id

    String

    请求的唯一标识ID。不得超过32 byte。

    order_id

    Stirng

    订单ID,不得超过64 byte。

    product_id

    String

    产品ID,不得超过64 byte。

  • 响应样例
    {   
        "request_id": "1564567b8bab40f34711234cb80d8574",
        "order_id": "CS1710111105S8IPB", 
        "product_id": "00301-25217-0--0"
    }

返回值

请参考返回值

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区