调试
您可以在API Explorer中调试该接口。
请求消息
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
tenant_id |
String |
租户ID或项目ID。 |
image |
String |
镜像 ID。 |
accessIPv4 |
String |
预留属性。 |
addresses |
Object |
弹性云服务器所属网络信息。 属性为Map<String, Object>结构。 |
metadata |
Object |
云服务器元数据。 |
accessIPv6 |
String |
预留属性。 |
created |
String |
云服务器创建时间。时间格式例如:2019-05-22T03:19:19Z |
hostId |
String |
云服务器对应的主机ID。 |
flavor |
Object |
|
OS-DCF:diskConfig |
String |
扩展属性,磁盘配置方式。对镜像启动云服务器生效。 |
user_id |
String |
云服务器所属用户ID。 |
name |
String |
修改后的云服务器名称。 |
progress |
Integer |
预留属性。 |
links |
Array of Object |
|
id |
String |
云服务器唯一标识。 |
updated |
String |
云服务器上一次更新时间。 时间格式例如:2019-05-22T03:19:19Z |
locked |
Boolean |
当云服务器被锁时为True,否则为False。 微版本2.9及以上版本支持。 |
description |
String |
弹性云服务器的描述信息。 微版本2.19及以上版本支持。 |
tags |
Array of strings |
云服务器的标签列表。 微版本2.26及以上版本支持,如果不使用微版本查询,响应中无tags字段。 系统近期对标签功能进行了升级,升级后,返回的tag值遵循如下规则:
|
status |
String |
云服务器状态。 取值范围: ACTIVE, BUILD,ERROR,HARD_REBOOT,MIGRATING,REBOOT,RESIZE,REVERT_RESIZE,SHELVED,SHELVED_OFFLOADED,SHUTOFF,UNKNOWN,VERIFY_RESIZE 弹性云服务器状态说明请参考云服务器状态 |
参数 |
参数类型 |
描述 |
---|---|---|
addr |
String |
IP地址信息。 |
version |
Integer |
IP地址类型,值为4或6。
|
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
云服务器类型ID。 微版本2.47及以上版本不支持。 |
links |
Array of objects |
微版本2.47及以上版本不支持。 |
vcpus |
Integer |
该云服务器规格对应的CPU核数。 在微版本2.47及以上版本支持。 |
ram |
Integer |
该云服务器规格对应的内存大小,单位为MB。 在微版本2.47及以上版本支持。 |
disk |
Integer |
该云服务器规格对应要求系统盘大小,0为不限制。 在微版本2.47及以上版本支持。 |
ephemeral |
Integer |
未使用。 在微版本2.47及以上版本支持。 |
swap |
Integer |
未使用。 在微版本2.47及以上版本支持。 |
original_name |
String |
云服务器规格名称。 在微版本2.47及以上版本支持。 |
extra_specs |
Object |
flavor扩展字段请参考:os_extra_specs(flavor)字段数据结构说明 在微版本2.47及以上版本支持。 |
请求示例
修改指定云服务器的名称为“new-server-test”。
PUT https://{endpoint}/v2.1/{project_id}/servers/{server_id} { "server": { "name": "new-server-test" } }
响应示例
{ "server": { "tenant_id": "7910a6e50b80402ba028c8d96c1b31fe", "image": "", "accessIPv4": "", "addresses": { "03be5c1e-e05d-4905-a105-c3bd9b730bdc": [ { "addr": "192.168.0.72", "version": 4 } ] }, "metadata": {}, "accessIPv6": "", "created": "2018-05-17T03:15:48Z", "hostId": "7dc82f6b1d406200fc63e395cf4829cbffcb49de0e9c75c5773f201f", "flavor": { "links": [ { "rel": "bookmark", "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/flavors/c3.1U1G" } ], "id": "c3.1U1G" }, "OS-DCF:diskConfig": "MANUAL", "user_id": "d698a78532ca430f8daec1858f2b500e", "name": "new-server-test", "progress": 0, "links": [ { "rel": "self", "href": "https://None/v2/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a" }, { "rel": "bookmark", "href": "https://None/7910a6e50b80402ba028c8d96c1b31fe/servers/1a19ef4f-be0a-4526-bf2f-14b4464d536a" } ], "id": "1a19ef4f-be0a-4526-bf2f-14b4464d536a", "updated": "2018-05-21T00:36:27Z", "status": "ACTIVE" } }
返回值
请参考通用请求返回值。