云服务器内容精选

  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 type String 登录类型: novnc vnc url String 远程登录控制台地址。 protocol String 登录协议。 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 405 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 503 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 name 否 String 服务器名称,名称需满足如下规则: 由中文,英文大小写,数字,_-组成。 长度范围1~64个字符。 description 否 String 服务器描述。 maintain_status 否 Boolean 服务器维护状态标识: true - 添加标记 false - 移除标记
  • 响应参数 状态码: 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 401 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 403 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 404 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 405 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 503 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。
  • 响应示例 状态码: 200 成功响应。 { "items" : [ { "server_id" : "84d5dd05-2977-4e37-8409-cf0b027f6a5b", "job_id" : "84d5dd05-2977-4e37-8409-cf0b027f6a5b", "error_code" : "", "error_message" : "" }, { "server_id" : "84d5dd05-2977-4e37-8409-cf0b027f6a5b", "job_id" : "", "error_code" : "WKS.00129901", "error_message" : "The service is now unavailable to process the request." } ] }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 items Array of ServerJobInfo objects 服务器任务信息。 表5 ServerJobInfo 参数 参数类型 描述 server_id String 服务器ID。 job_id String 任务ID。 error_code String 失败时的错误码。 error_message String 失败原因。 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 405 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 500 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 状态码: 503 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 server_ids 否 Array of strings 应用服务器id集合。 image_id 是 String 镜像id,要求与服务器原有镜像id不相同。 image_type 是 String 镜像类型: gold - 云市场镜像 public - 公共镜像 private - 私有镜像 shared - 共享镜像 other - 其他 os_type 是 String 系统类型,当前仅支持Windows。 Linux - Windows - Other - image_product_id 否 String 镜像的产品id,当镜像是市场镜像时候,该字段必传。 update_access_agent 否 Boolean 是否自动升级hda版本。
  • 请求示例 POST /v1/a4da8115c9d8464ead3a38309130523f/app-servers/actions/batch-change-image { "server_ids" : [ "25b1dd14-0c84-4558-aa57-03a6c54b8e75" ], "image_id" : "35998d9a-14f2-48fc-832b-6fc0074dc8f8", "image_type" : "private", "os_type" : "Windows", "image_product_id" : "35998d9a-14f2-48fc-832b-6fc0074dc8f8", "update_access_agent" : true }
  • 请求示例 变更服务器的规格 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 } }
  • 请求参数 表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 :不自动付款
  • 背景信息 VR云渲游平台中涉及的云服务器状态如表1所示。 表1 云服务器状态一览 云服务器状态 说明 正常 设备与该云服务器正在连接中。 闲置 处于该状态的云服务器可以被设备连接。 初始化 云服务器正在做运行环境安装等工作。 异常 云服务器处于失联/错误等情况。 关机 云服务器处于关机状态。 重启中 云服务器正在重启。 VR云渲游平台中涉及的会话状态如表2所示。 表2 会话状态一览 会话状态 说明 正常 设备与该会话正在连接中。 闲置 处于该状态的会话可以被设备连接。 初始化 会话正在做运行环境安装等工作。 异常 会话处于失联/错误等情况。 未运行 云服务器处于“关机”或“重启中”时,会话未运行。
  • 响应参数 状态码为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 错误的英文描述。
  • 响应示例 状态码为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" }
  • 操作步骤 登录 主机迁移服务 管理控制台。 在左侧导航树中,单击“迁移服务器”,进入迁移服务器列表页面。 在迁移服务器列表页面找到待迁移的服务器,单击“迁移阶段/实时状态”或“操作”列的“开始”,右侧弹出“开始”窗口,单击“确定”,开始全量复制。 或勾选待迁移的服务器,单击服务器列表上方的“开始”,右侧弹出“开始”窗口,单击“确定”,开始全量复制。 图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"}}'