云服务器内容精选

  • 响应参数 状态码: 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 401 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 404 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 500 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 502 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述 状态码: 504 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述
  • 功能介绍 变更单台云服务器规格。 对于运行中的弹性云服务器,系统会自动关机,并将弹性云服务器中的数据拷贝到目标节点(目标节点可与源节点相同)后重新启动弹性云服务器。 底层资源不足时,该接口会自动回滚。 该接口不单独使用,需要轮询判断虚拟机状态,当虚拟机同时满足"status"为"VERIFY_RESIZE"、"OS-EXT-STS:task_state"为""、"OS-EXT-STS:vm_state"为"RESIZED"时,配合“确认变更云服务器规格(POST /v2.1/{project_id}/servers/{server_id}/action)”或“回退变更云服务器规格(POST /v2.1/{project_id}/servers/{server_id}/action)”两个接口一起使用。 当前API已废弃,请使用变更云服务器规格(按需)。
  • 功能介绍 当您创建的弹性云服务器规格无法满足业务需要时,可以变更云服务器规格,升级vCPU、内存。具体接口的使用,请参见本节内容。 本接口为异步接口,当前变更弹性云服务器规格请求下发成功后会返回job_id,此时变更弹性云服务器规格并没有立即完成,需要通过调用查询任务的执行状态查询job状态,当Job状态为 SUC CES S 时代表云服务器规格变更成功。 变更规格时,部分规格的之间不能互相变更。您可以参见查询云服务器规格变更支持列表查询支持列表。
  • 请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 resize 是 Object 标记为云服务器变更规格操作,详情请参见表3。 dry_run 否 Boolean 是否只预检此次请求。 true:发送检查请求,不会变更云服务器规格。检查项包括是否填写了必需参数、请求格式等。 如果检查不通过,则返回对应错误。 如果检查通过,则返回202状态码。 false:发送正常请求,通过检查后并且执行变更云服务器规格请求。 表3 resize数据结构说明 参数 是否必选 参数类型 描述 flavorRef 是 String 变更后的云服务器规格ID。 可能通过 查询云服务器规格变更支持列表 接口查询允许变更的规格列表。 mode 否 String 取值为withStopServer ,支持开机状态下变更规格。 mode取值为withStopServer时,对开机状态的云服务器执行变更规格操作,系统自动对云服务器先执行关机,再变更规格,变更成功后再执行开机。 cpu_options 否 Object 自定义CPU选项。 详情请参见表4。 表4 cpu_options数据结构说明 参数 是否必选 参数类型 描述 hw:cpu_threads 否 integer 用于控制CPU是否开启超线程。 取值范围:1,2。 1: 关闭超线程。 2: 打开超线程。 需要同时满足如下条件,才能设置为“关闭超线程”: 只能在实例创建或者resize时指定。 只有目标flavor的extra_specs参数: 存在“hw:cpu_policy”并取值为“dedicated”。 存在“hw:cpu_threads”并取值为“2”。
  • 请求消息 请求参数 参数 是否必选 参数类型 描述 os-getSerialConsole 是 Object 获取裸金属服务器远程登录地址。详情请参见表2。 表2 os-getSerialConsole字段数据结构说明 参数 是否必选 参数类型 描述 type 是 String 获取对象,请将type配置为“serial”。 请求示例 获取ID为47e9be4e-a7b9-471f-92d9-ffc83814e07a的裸金属服务器的远程登录地址。 1 POST https://{E CS Endpoint}/v2/9c53a566cb3443ab910cf0daebca90c4/servers/47e9be4e-a7b9-471f-92d9-ffc83814e07a/action 1 2 3 4 5 { "os-getSerialConsole": { "type": "serial" } }
  • 响应消息 响应参数 无 响应示例 1 2 3 4 5 6 { "console": { "url": "https://baremetal-consoleproxy.az1.dc1.domainname.com:8003/?token=040134bb-9195-4029-9a62-550bce390258", type": "serial" } }
  • 请求示例 设置云服务器的定时删除时间为“2020-09-25T12:05:00Z”。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "2020-09-25T12:05:00Z", } 取消云服务器的定时删除。 POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "", }
  • 请求消息 表2 请求参数 参数 是否必选 参数类型 描述 auto_terminate_time 是 String 按需云服务器定时删除时间。 按照ISO8601标准表示,并使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 如果秒(ss)取值不是 00,则自动取为当前分钟(mm)开始时。 最短定时删除时间为当前时间半小时之后。 最长定时删除时间不能超过当前时间三年。 如果参数auto_terminate_time为空字符串,表示不设置定时删除或取消定时删除。 示例:2020-09-25T12:05:00Z