云服务器内容精选

  • 请求参数 表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 :不自动付款
  • 请求示例 变更服务器的规格 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 } }
  • 背景信息 VR云渲游平台中涉及的云服务器状态如表1所示。 表1 云服务器状态一览 云服务器状态 说明 正常 设备与该云服务器正在连接中。 闲置 处于该状态的云服务器可以被设备连接。 初始化 云服务器正在做运行环境安装等工作。 异常 云服务器处于失联/错误等情况。 关机 云服务器处于关机状态。 重启中 云服务器正在重启。 VR云渲游平台中涉及的会话状态如表2所示。 表2 会话状态一览 会话状态 说明 正常 设备与该会话正在连接中。 闲置 处于该状态的会话可以被设备连接。 初始化 会话正在做运行环境安装等工作。 异常 会话处于失联/错误等情况。 未运行 云服务器处于“关机”或“重启中”时,会话未运行。
  • 响应示例 状态码为200时 OK { "applications":[ { "id": "4d00636c-6540-11eb-b54a-fa1640a9b002", "name": "testcxcx", "status": "unlaunch", "create_time": "2021-02-02T10:20:42Z", "package_size": "99.27MB", "install_progress": "0.56" } } 状态码为400时 { "error_code" : "string", "error_msg" : "string" }
  • 响应参数 状态码为200时 表2 响应Body参数 参数 参数类型 描述 applications Array of objects 应用列表信息,详情请参见表3。 表3 application字段数据结构说明 参数 参数类型 描述 id String 应用ID。 应用的唯一标识,格式为UUID。 name String 应用名称。 status String 云服务器上应用的安装状态。 安装状态枚举值: waitinstall:等待安装 installing:安装中 failure:安装失败 launch:运行中 unlaunch:未运行 create_time String 应用创建时间。 时间格式例如:2020-05-20T03:30:52Z package_size String 在云服务器上应用的安装包大小。 install_progress String 在云服务器上应用的安装任务进度。 如:0.86 说明:总进度为1。 状态码为400时 表4 响应Body参数 参数 参数类型 描述 error_code String 返回的错误码,如CVR.0001。 error_msg String 错误的英文描述。
  • 操作步骤 登录 主机迁移服务 管理控制台。 在左侧导航树中,单击“迁移服务器”,进入迁移服务器列表页面。 在迁移服务器列表页面找到待迁移的服务器,单击“迁移阶段/实时状态”或“操作”列的“开始”,右侧弹出“开始”窗口,单击“确定”,开始全量复制。 或勾选待迁移的服务器,单击服务器列表上方的“开始”,右侧弹出“开始”窗口,单击“确定”,开始全量复制。 图1 开始全量复制 在全量复制过程中,系统默认将您的目的端锁定并不可操作,迁移完成后将自动解锁目的端服务器。如您在迁移过程中,需要操作目的端,可解锁目的端,具体操作参见解锁目的端。 迁移过程中,您可以服务器列表中,单击源端服务器名称,查看迁移进度。 全量复制完成。 在设置迁移目的端“持续同步”选择“否”时,全量复制完成后系统会自动进入下一步:启动目的端,并且启动目的端无需手动操作,系统会自动启动目的端。 在设置迁移目的端“持续同步”选择“是”时,“迁移实时状态”为“持续同步”,说明全量复制已完成。在“启动目的端”之前,系统会自动把源端新增或修改的磁盘数据持续同步到目的端。“启动目的端”需要手动操作,您可参考启动目的端来启动目的端。 在 主机迁移 并割接完成后,通常还需要您根据业务需要对目的端服务器进行一些额外的配置调整。详细介绍请参考主机迁移完成后还需要手动修改哪些配置项?
  • 操作步骤 登录主机迁移服务管理控制台。 在左侧导航树中,选择“迁移服务器”,进入迁移服务器列表页面。 在迁移服务器列表页面找到已复制完成并持续同步的服务器,在“迁移阶段/实时状态”列,单击“启动目的端”。 或勾选已复制完成并持续同步的服务器,单击服务器名称/ID上方的“启动目的端”。 图1 启动目的端 在弹出的“启动目的端”窗口,单击“是”。 图2 确定启动 “迁移阶段/实时状态”为“已完成”,说明已启动目的端,整个迁移操作已完成。 图3 迁移完成 在主机迁移并割接完成后,通常还需要您根据业务需要对目的端服务器进行一些额外的配置调整。详细介绍请参考主机迁移完成后还需要手动修改哪些配置项?
  • 调用API更换弹性公网IP 解绑弹性公网IP。 请在管理控制台或者调用查询云手机服务器详情接口,查询服务器的EIP的ip地址(例如 122.9.102.xxx)。 在弹性公网IP的管理控制台或者调用全量查询弹性公网IP列表接口,通过ip地址查询EIP的id。 调用解绑弹性公网IP的解绑弹性公网IP接口进行解绑。 调用示例如下: curl -i -k -X POST https://{Endpoint}/v3/{project_id}/eip/publicips/{eip_id}/disassociate-instance -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" 绑定弹性公网IP。 严格来讲弹性公网IP实际是绑定到port的,存在空闲port的机器可以进行绑定操作。 根据第1步的指导查询到要绑定的弹性公网IP的id,这个弹性公网IP需要是未绑定状态。 根据CPH的server_id调用查询端口列表接口,查询出服务器的所有port。 调用示例如下: curl -i -k -X GET https://{Endpoint}/v1/{project_id}/ports?instance_id={cph_server_id} -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" 根据port_id调用查询EIP列表接口查询弹性公网IP,可以一次传入一个或多个port_id进行查询,如果哪个port查不到弹性公网IP,则说明它可以绑定弹性公网IP。 调用示例如下: curl -i -k -X GET https://{Endpoint}/v1/{project_id}/publicips?port_id={port_id1}\&port_id={port_id2}\&port_id={port_id3} -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" 对于没有绑定弹性公网IP的port,可以调用绑定弹性公网IP接口,绑定弹性公网IP。 调用示例如下: curl -i -k -X POST https://{Endpoint}/v3/{project_id}/eip/publicips/{eip_id}/associate-instance -H "Content-Type: application/json" -H "X-Auth-Token: ${token}" -d '{"publicip":{"associate_instance_id":"{port_id}","associate_instance_type":"PORT"}}'
  • 报文样例 该接口的请求消息体举例如下: { "limit":10, "offset":0 } 该接口的响应消息体举例如下: { "returnCode": "0200000", "server": [ { "port": null, "ip": null, "filePath": null, "userName": "10", "serverId": "164681924997097701747271557174" }, { "port": "22", "ip": "10.21.124.175", "filePath": "/home/sftp", "userName": "isales", "serverId": "164690088271159234793429225848" }, { "port": "22", "ip": "192.168.0.1", "filePath": "/home/sftp", "userName": "huawei", "serverId": "164697340198671566909690908237" }, { "port": "8888", "ip": "1.1.1.1", "filePath": "/sftp/file", "userName": "isales", "serverId": "164765479785832713595318363505" }, { "port": "22", "ip": "10.1.1.1", "filePath": "/home/sftp", "userName": "zhangsan", "serverId": "164765490069279981932006087306" } ], "resultCode": "0200000", "resultDesc": "success", "returnDesc": "success" }
  • 错误结果码 表6 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200033 外呼数据不存在。 3 0200034 子状态与业务结果不匹配。 4 02000001 参数值为空 5 02000002 参数包含非法字符 6 02000003 参数长度不能大于规定长度 7 02000004 参数长度不能小于规定长度 8 02000005 参数长度需要介于规定长度之间 9 02000006 参数值类型不正确 10 02000007 参数值大小不正确 11 02000008 参数转换异常,请检查请求参数 12 02000009 参数组合不正确,请检查请求参数 13 02000010 hour和minute必须同时存在 14 02000011 参数个数不能大于规定个数
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/file/queryServer 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。
  • 错误结果码 表6 错误原因码说明 序号 错误码 说明 1 0200001 参数异常,异常详情在resultDesc中描述。 2 0200006 服务器配置信息不存在。 2 0200033 外呼数据不存在。 3 0200034 子状态与业务结果不匹配。 4 02000001 参数值为空 5 02000002 参数包含非法字符 6 02000003 参数长度不能大于规定长度 7 02000004 参数长度不能小于规定长度 8 02000005 参数长度需要介于规定长度之间 9 02000006 参数值类型不正确 10 02000007 参数值大小不正确 11 02000008 参数转换异常,请检查请求参数 12 02000009 参数组合不正确,请检查请求参数 13 02000010 hour和minute必须同时存在 14 02000011 参数个数不能大于规定个数
  • 报文样例 该接口的请求消息体举例如下: { "userName":"WANGWU", "serverInfo":{ "ip":"5.9.11.11", "port":"22", "filePath":"/home/sftp" }, "serverPwd":"******" } 该接口的响应消息体举例如下: { "returnCode": "0200000", "resultCode": "0200000", "resultDesc": "success", "returnDesc": "success" }
  • 请求说明 表2 请求消息头参数 序号 名称 参数类型 是否必选 说明 1 Content-Type String True 固定填 application/json; charset=UTF-8。 2 Authorization String True 生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。 表3 请求消息体参数说明 序号 参数名 参数类型 是否必选 说明 1 serverInfo Object True 文件服务器信息。 2 userName String True 用户名 3 serverPwd String False 服务密码。明文传递,后台密文保存,当serviceInfo.IP与原有IP值不一致时,必传 表4 serverInfo参数说明 序号 参数名 参数类型 是否必选 说明 1 ip String True 文件服务器IP。 2 port String True port 3 filePath String True 文件服务器默认路径 示例:/home/sftp
  • 接口URI https://ip:port/rest/isales/v1/openapi/campaigns/{vdnId}/file/{serverId}/updateServer 其中,ip为CC-iSales服务器地址,port为CC-iSales服务器的HTTPS端口号。 表1 URL中携带的参数说明 序号 参数名 参数类型 是否必选 说明 1 vdnId int True 虚拟呼叫中心ID。 取值的类型为整数,取值范围为1~9999。 2 serverId String True 文件服务器ID