4.3 云服务器管理
4.3.3 修改云服务器信息
功能介绍
修改云服务器信息，包括云服务器会话路数。调用该接口进行云服务器会话路数更新 时，会自动重启云服务器后生效。
URI
PUT /v2/cvr/servers/{server_id}
说明
该接口需要使用global终端节点调用。
表4-43 路径参数
参数 是否
必选
参数类型 描述
server_id 是 String 云服务器ID。
请求参数
表4-44 请求参数
参数 是否
必选
参数类型 描述
server 否 Object 云服务器信息，详情请参见表4-45。
接口参考 4 API
表4-45 server 字段数据结构说明
参数 是否
必选
参数类型 描述
session_numb
er 否 Integer 需要设置的云服务器会话路数。
取值范围：
● VR应用云服务器：允许设置为2，
4，8。
● 3D应用云服务器：允许设置为1，
2。
约束：
● 当前会话路数为1路的VR应用云服务 器，不允许通过该操作修改会话路数 为其它数值。
响应参数
● 状态码为200时
表4-46 响应 Body 参数
参数 参数类型 描述
server Object 云服务器信息，详情请参见表4-47。
表4-47 server 字段数据结构说明
参数 参数类型 描述
availability_z
one_id String 云服务器所在可用区。
bandwidth_si
ze Integer 云服务器所绑定带宽的大小。
单位：Mbit/s charging_mo
de Integer 云服务器的计费模式。
● 0：表示按需计费。
● 1：表示包周期计费。
create_time String 云服务器的创建时间。
时间格式例如：2020-05-20T03:30:52Z current_appli
cation_id String 云服务器上正在运行应用ID。
failure_reaso
n String 云服务器的故障信息。
参数 参数类型 描述
privateip String 云服务器所绑定的私有IP。
flavor_displa
y_name String 云服务器的规格显示名称。
格式如下：
xvCPUs | yGB | flavor_id
x为CPU个数，y为内存大小，flavor_id为规格 名。
image_name String 云服务器所安装的镜像名称。
installed_app
lications Array of
strings 已安装的应用ID列表。
link_device_i
d String 正在连接的设备ID，与云服务器连接设备的唯
一标识。
link_status String 设备与云服务器的连接状态。
cluster_id String 集群ID。
name String 云服务器名称。
id String 云服务器ID。
publicip String 云服务器绑定的公网IP。
region_id String 云服务器所在的区域。
status String 云服务器的状态。
total_volume
_size Sring 云服务器上安装的云硬盘总量。
单位：GB
volume_size String 云服务器上安装的云硬盘剩余量。
单位：GB applications Array of
strings 该台云服务器上的所有应用ID列表，包括安装 完成的及还未安装完成的应用。
session_num
ber Integer 云服务器的会话路数。
● 状态码为400时
表4-48 响应 Body 参数
参数 参数类型 描述
error_code String 返回的错误码，如CVR.0001。
error_msg String 错误的英文描述。
接口参考 4 API
请求示例
● 请求URL示例
PUT https://{endpoint}/v2/cvr/servers/7acc58a-d83f-44ac-8f57-588832d525aa
● 请求示例
修改3D应用云服务器的会话路数为2路。
{ "server":{
"session_number": 2 }
}
响应示例
● 状态码为200时 OK
{ "server": {
"id": "d7acc58a-d83f-44ac-8f57-588832d525aa", "cluster_id": "50adbf76-412a-11eb-821b-fa1640a9b0aa", "publicip": "255.255.255.255",
"region_id": "cn-north-4", "volume_size": "98", "total_volume_size": "99", "link_status": "free", "link_device_id": "", "failure_reason": "",
"create_time": "2021-02-02T10:20:43Z", "current_application_id": "",
"installed_applications": ["4d00636c-6540-11eb-b54a-fa1640a9b0aa"], "name": "ecs-eeee",
"status": "ACTIVE",
"flavor_display_name": "32vCPUs | 64GB | g5r.8xlarge.2", "availability_zone_id": "cn-north-4a",
"image_name": "Windows-Server-2016-64bit", "charging_mode": 0,
"privateip": "192.168.0.0", "bandwidth_size": 50,
"applications": ["4d00636c-6540-11eb-b54a-fa1640a9b0aa"], "session_number": 2
} }
● 状态码为400时
{ "error_code" : "string", "error_msg" : "string"
}
状态码
请参见状态码。
错误码
请参见错误码。