华为云服务器查询云服务器详情_云淘科技
功能介绍
根据云服务器ID，查询云服务器的详细信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v2.1/{project_id}/servers/{server_id}
参数说明请参见表1。
|
参数 |
是否必选 |
描述 |
|---|---|---|
|
project_id |
是 |
项目ID。 获取方法请参见获取项目ID。 |
|
server_id |
是 |
云服务器ID。 |
请求消息
无
响应消息
响应参数如表2所示。
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
server |
Object |
云服务器信息，详情请参见表3。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
云服务器名称。 |
|
id |
String |
云服务器唯一标识。 |
|
status |
String |
云服务器当前状态信息。 取值范围： ACTIVE、BUILD、DELETED、ERROR、HARD_REBOOT、MIGRATING、PAUSED、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、SHELVED、SHELVED_OFFLOADED、SOFT_DELETED、SUSPENDED、VERIFY_RESIZE 云服务器状态说明请参考云服务器状态。 |
|
created |
String |
云服务器创建时间。时间格式例如：2019-05-22T07:48:19Z |
|
updated |
String |
云服务器最近一次更新时间，例如开机、关机、重启等操作。时间格式例如：2019-05-22T07:48:19Z |
|
flavor |
Object |
云服务器规格信息，详情请参见表4。 |
|
image |
Object |
云服务器镜像信息，对镜像创的弹性云服务器该属性通常返回镜像id和链接。 详情请参见表5。 |
|
tenant_id |
String |
云服务器所属租户ID。即项目id，和project_id表示的是一个概念。 |
|
key_name |
String |
SSH密钥名称。 |
|
user_id |
String |
云服务器所属用户ID。 |
|
metadata |
Object |
云服务器元数据。 |
|
hostId |
String |
云服务器对应的主机ID。 |
|
addresses |
Object |
云服务器对应的网络地址信息。 属性为Map结构。 key为网络名称，如“demo_net”。 |
|
security_groups |
Array of objects |
云服务器所属安全组列表，详情请参见表9。 |
|
links |
Array of objects |
云服务器相关标记快捷链接信息，详情请参见表6。 |
|
tags |
Array of strings |
云服务器的标签列表。 微版本2.26及以上版本支持，如果不使用微版本查询，响应中无tags字段。 系统近期对标签功能进行了升级，升级后，返回的tag值遵循如下规则： key与value使用“=”连接，如“key=value”。 |
|
os:scheduler_hints |
Object |
弹性云服务器调度信息，参见表11。裸金属服务器场景不支持。仅在DEH专属主机的场景下存在该字段。 |
|
OS-DCF:diskConfig |
String |
扩展属性，磁盘配置方式。对镜像启动弹性云服务器生效。 取值范围： AUTO: API使用单个分区构建目标磁盘大小的弹性云服务器。 API会自动调整文件系统以适应整个分区。 MANUAL:API使用源映像中的分区方案和文件系统构建服务器。如果目标磁盘较大，则API不分区剩余的磁盘空间。 |
|
OS-EXT-AZ:availability_zone |
String |
扩展属性，可用区编码。 |
|
OS-EXT-SRV-ATTR:host |
String |
扩展属性，云服务器宿主名称。 |
|
OS-EXT-SRV-ATTR:hypervisor_hostname |
String |
扩展属性，hypervisor主机名。 |
|
OS-EXT-SRV-ATTR:instance_name |
String |
扩展属性，云服务器ID。 |
|
OS-EXT-STS:power_state |
Integer |
扩展属性，云服务器电源状态。 取值范围：0 , 1 , 2 , 3 , 4 0 : pending |
|
OS-EXT-STS:task_state |
String |
扩展属性，云服务器任务状态。 取值范围请参考云服务器状态表3。 |
|
OS-EXT-STS:vm_state |
String |
扩展属性，云服务器状态。 取值范围： ACTIVE,BUILDING,STOPPED,RESIZED,PAUSED,SUSPENDED,RESCUED,ERROR,DELETED,SOFT_DELETED,SHELVED,SHELVED_OFFLOADED 云服务器状态说明请参考云服务器状态。 |
|
OS-SRV-USG:launched_at |
String |
扩展属性，云服务器启动时间。时间格式例如：2019-05-22T07:48:19.000000 |
|
OS-SRV-USG:terminated_at |
String |
扩展属性，云服务器删除时间。时间格式例如：2019-05-22T07:48:19.000000 |
|
os-extended-volumes:volumes_attached |
Array of objects |
云服务器挂载的云磁盘信息，详情请参见表8。 |
|
fault |
Object |
云服务器故障信息。 可选参数，在云服务器状态为ERROR且存在异常的情况下返回。 详情参见 表11 fault字段数据结构说明。 |
|
description |
String |
云服务器的描述信息。 微版本2.19及以上版本支持。 |
|
host_status |
String |
nova-compute状态。 UP：服务正常 微版本2.16及以上版本支持。 |
|
OS-EXT-SRV-ATTR:hostname |
String |
云服务器的主机名。 微版本2.3及以上版本支持。 |
|
OS-EXT-SRV-ATTR:reservation_id |
String |
批量创建场景，云服务器的预留ID。 微版本2.3及以上版本支持。 |
|
OS-EXT-SRV-ATTR:launch_index |
Integer |
批量创建场景，云服务器的启动顺序。 微版本2.3及以上版本支持。 |
|
OS-EXT-SRV-ATTR:kernel_id |
String |
若使用AMI格式的镜像，则表示kernel image的UUID；否则，留空。 微版本2.3及以上版本支持。 |
|
OS-EXT-SRV-ATTR:ramdisk_id |
String |
若使用AMI格式镜像，则表示ramdisk image的UUID；否则，留空。 微版本2.3及以上版本支持。 |
|
OS-EXT-SRV-ATTR:root_device_name |
String |
云服务器系统盘的设备名称。 微版本2.3及以上版本支持。 |
|
OS-EXT-SRV-ATTR:user_data |
String |
创建云服务器时指定的user_data。 微版本2.3及以上版本支持。 |
|
locked |
Boolean |
当云服务器被锁时为True，否则为False。 微版本2.9及以上版本支持。 |
|
accessIPv4 |
String |
预留属性。 |
|
accessIPv6 |
String |
预留属性。 |
|
config_drive |
String |
预留属性。 |
|
progress |
Integer |
预留属性。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
云服务器类型ID。 微版本2.47及以上版本不支持。 |
|
links |
Array of objects |
云服务器类型相关标记快捷链接信息。 详情请参见表6。 微版本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及以上版本支持。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
镜像ID。 您可以根据镜像ID查询更多镜像信息，详细内容，请参见查询镜像列表（OpenStack原生）。 |
|
links |
Array of objects |
镜像相关标记快捷链接信息，详情请参见表6。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
rel |
String |
快捷链接标记名称。 |
|
href |
String |
对应快捷链接。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
addr |
String |
IP地址信息。 |
|
version |
Integer |
IP地址类型，值为4或6。 4：IP地址类型是IPv4 |
|
OS-EXT-IPS-MAC:mac_addr |
String |
扩展属性，MAC地址。 |
|
OS-EXT-IPS:type |
String |
扩展属性，分配IP地址方式。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
云磁盘ID。 |
|
delete_on_termination |
Boolean |
一个标志，指示在删除服务器时是否删除附加的卷。 默认情况下，这是False 微版本2.3及以上版本支持。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
安全组名称或者uuid。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
Integer |
错误码。 |
|
created |
String |
异常出现的时间。 |
|
message |
String |
异常描述信息。 |
|
details |
String |
异常详情信息，可选参数，在非空条件下才返回。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
tenancy |
否 |
Array of strings |
在指定的专属主机或者共享主机上创建弹性云服务器。 参数值为shared或者dedicated。 |
|
dedicated_host_id |
否 |
Array of strings |
专属主机ID。 此属性仅在tenancy值为dedicated时有效。 |
请求示例
查询指定云服务器的详细信息。
GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}
响应示例
{
"server": {
"addresses": {
"68269e6e-4a27-441b-8029-35373ad50bd9": [
{
"addr": "192.168.0.3",
"version": 4,
"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:1b:35:78",
"OS-EXT-IPS:type": "fixed"
}
]
},
"created": "2012-08-20T21:11:09Z",
"flavor": {
"id": "1",
"links": [
{
"href": "http://openstack.example.com/openstack/flavors/1",
"rel": "bookmark"
}
]
},
"hostId": "65201c14a29663e06d0748e561207d998b343e1d164bfa0aafa9c45d",
"id": "893c7791-f1df-4c3d-8383-3caae9656c62",
"image": "",
"links": [
{
"href": "http://openstack.example.com/v2/openstack/servers/893c7791-f1df-4c3d-8383-3caae9656c62",
"rel": "self"
},
{
"href": "http://openstack.example.com/openstack/servers/893c7791-f1df-4c3d-8383-3caae9656c62",
"rel": "bookmark"
}
],
"metadata": {},
"name": "new-server-test",
"progress": 0,
"status": "ACTIVE",
"tenant_id": "openstack",
"updated": "2012-08-20T21:11:09Z",
"user_id": "fake"
}
}
返回值
请参考通用请求返回值。
父主题： 生命周期管理
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
