电子政务云监管平台接口对接规范参考范本

电子政务云监管平台接口规范电子政务云监管平台接口规范1-1-PAGE3电子政务云监管平台接口规范v2.1目录TOC\o"1-2"\h\z\u1接口约定 ······································ 1-12云服务商平台相关接口 ································ 2-12.1 查询云平台服务状态信息 ······························ 2-12.2 查询平台资源使用情况 ······························· 2-73用户租户相关接口 ·································· 3-13.1创建租户·····································3-13.2修改租户·····································3-43.3删除租户·····································3-63.4查询租户·····································3-83.5创建用户·····································3-103.6修改用户·····································3-133.7查询用户·····································3-163.8删除用户·····································3-184虚拟机相关接口 ··································· 4-14.1 查询虚拟机列表 ·································· 4-14.2 查询虚拟机详细信息 ································ 4-84.3 查询虚拟机监控信息 ································ 4-154.4 查询虚拟机快照列表 ································ 4-204.5 查询虚拟硬盘详细信息 ······························· 4-224.6 查询虚拟硬盘列表 ································· 4-264.7 查询虚拟硬盘快照列表 ······························· 4-304.8 查询虚拟机规格列表 ································ 4-334.9 查询虚拟机镜像列表 ································ 4-405网络相关接口 ···································· 5-15.1 查询私有网络列表 ································· 5-15.2 查询私有网络详细信息 ······························· 5-45.3 查询子网列表 ··································· 5-75.4 查询子网详细信息 ································· 5-115.5 查询网卡列表 ··································· 5-145.6 查询网卡详细信息 ································· 5-185.7 查询虚拟路由器列表 ································ 5-205.8 查询虚拟路由器详细信息 ······························ 5-255.9 查询安全组列表 ·································· 5-275.10 查询安全组详细信息 ······························· 5-335.11 查询防火墙列表 ································· 5-375.12 查询防火墙详细信息 ······························· 5-395.13 查询防火墙策略列表 ······························· 5-425.14 查询防火墙策略详细信息 ····························· 5-445.15 查询防火墙规则列表 ······························· 5-465.16 查询防火墙规则详细信息 ····························· 5-495.17 查询公网 IP列表································· 5-525.18 查询公网 IP详细信息 ······························· 5-565.19 查询VPN服务列表 ································ 5-585.20 查询VPN服务详细信息 ······························ 5-605.21 查询VPN的IKE策略列表 ····························· 5-635.22 查询VPN的IKE策略详细信息 ··························· 5-665.23 查询VPN的IPSEC策略列表 ···························· 5-695.24 查询VPN的IPSEC策略详细信息 ·························· 5-715.25 查询VPN站点连接列表 ······························ 5-745.26 查询VPN站点连接详细信息 ···························· 5-785.27 查询负载均衡池列表 ······························· 5-815.28 查询负载均衡池详细信息 ····························· 5-845.29 查询负载均衡 VIP列表 ······························ 5-875.30 查询负载均衡 VIP详细信息 ···························· 5-895.31 查询负载均衡成员列表 ······························ 5-925.32 查询负载均衡成员详细信息 ···························· 5-945.33 查询负载均衡健康监控列表 ···························· 5-975.34 查询负载均衡健康监控详细信息 ························· 5-1006物理设备相关接口 ·································· 6-16.1 查询虚拟化服务器列表 ······························· 6-16.2 查询虚拟化服务器监控信息 ····························· 6-66.3 查询存储设备列表 ································· 6-116.4 查询存储设备的监控信息 ······························ 6-136.5 查询网络设备列表 ································· 6-166.6 查询网络设备的监控信息 ······························ 6-1电子政务云监管平台接口规范电子政务云监管平台接口规范1-1-PAGE46.7 查询物理安全设备列表 ······························· 6-16.8 查询商物理安全设备详细信息 ···························· 6-37监控告警相关接口 ·································· 7-57.1 查询公网 IP监控详细信息 ····························· 7-57.2 查询虚拟机告警列表 ································ 7-77.3 查询虚拟机告警详细信息 ······························ 7-107.4 查询设备告警列表 ································· 7-137.5 查询设备告警详细信息 ······························· 7-167.6 查询告警策略列表 ·························· 错误！未定义书签。7.7 查询告警策略详细信息 ························ 错误！未定义书签。8虚拟安全设备接口 ·································· 8-18.1 查询虚拟 列表································· 8-18.2 查询虚拟 详细情况 ······························· 8-48.3 查询虚拟 IPS列表································· 8-88.4 查询虚拟 IPS详细信息 ······························· 8-108.5 查询虚拟防病毒列表 ································ 8-128.6 查询虚拟防病毒详细信息 ······························ 8-159日志相关接口 ··································· 9-189.1 查询云平台操作日志列表 ······························ 9-18电子政务云监管平台接口规范电子政务云监管平台接口规范1-1-PAGE1接口约定接口URI：云监管平台调用云服务商商接口时的访问地址。接口遵循openstack 的restful 风格，并兼容 openstack 接口。使用https，数据传输采用 SSL保护，使用电子政务云 CA申请证书。一阶段先使用链接进入云服务商平台进行操作， API先只提供创建，查询，删除接口原生接口能满足需求的尽量使用原生接口。如虚拟机、虚拟硬盘、虚拟网络等。云服务商暴露统一的入口地址和端口（上层不关心 token和endpoint接口参数约定：和类型接口，参数跟在 URL后边，如PUT和类型接口，参数都放在 https 的request-body 中。调用底层接口时，需要在 中加入userid、password、region 等参数除了租户用户不区分 region，其他都要区分。所有接口中，磁盘的单位都是 而内存的单位都是 带宽的单位都是 时间格式为2015-11-20T13:59:21 。region 分为inner（公用网络通用性能区域） ,inner_high（公用网络高性能区域）和external（互联网区域）。电子政务云监管平台接口规范电子政务云监管平台接口规范PAGE1云服务商平台相关接口查询云平台服务状态信息查询云平台服务状态信息列表。接口URI/v3/services访问方法方法GET返回结果状态码200(OK)：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。413：实体过大。503：服务不可用。消息体{"links":{"next":null,"previous":null,"self":"http://localhost:5000/v3/services"},"services":[{"description":"NovaComputeService",电子政务云监管平台接口规范电子政务云监管平台接口规范2-2-PAGE10"enabled":true,"id":"1999c3a858c7408fb586817620695098","links":{"self":"http://localhost:5000/v3/services/1999c3a858c7408fb586817620695098"},"name":"nova","type":"compute"},{"description":"CinderVolumeServiceV2","enabled":true,"id":"39216610e75547f1883037e11976fc0f","links":{"self":"http://localhost:5000/v3/services/39216610e75547f1883037e11976fc0f"},"name":"cinderv2","type":"volumev2"},{"description":"NeutronService","enabled":true,"id":"4fe41a27de3341af9100123f765eac0d","links":{"self":"http://localhost:5000/v3/services/4fe41a27de3341af9100123f765eac0d"},"name":"neutron","type":"network"},{"description":"EC2CompatibilityLayer","enabled":true,"id":"61d3d05bdd1449f18923c83f52a4d762","links":{"self":"http://localhost:5000/v3/services/61d3d05bdd1449f18923c83f52a4d762"},"name":"ec2","type":"ec2"},{"description":"GlanceImageService","enabled":true,"id":"69afa3d57d1948ea988beeb252bbaa5d","links":{"self":"http://localhost:5000/v3/services/69afa3d57d1948ea988beeb252bbaa5d"},"name":"glance","type":"image"},{"description":"NovaComputeServiceV2.1","enabled":true,"id":"79b691ee7be649d9bf8613efc0960206","links":{"self":"http://localhost:5000/v3/services/79b691ee7be649d9bf8613efc0960206"},"name":"novav21","type":"computev21"},{"description":"SwiftService","enabled":true,"id":"92419b70ebe64c6c873bd20b14360e6b","links":{"self":"http://localhost:5000/v3/services/92419b70ebe64c6c873bd20b14360e6b"},"name":"swift","type":"object-store"},{"description":"KeystoneIdentityService","enabled":true,"id":"b8f8454fc07b46b781204d2a436f9d1c","links":{"self":"http://localhost:5000/v3/services/b8f8454fc07b46b781204d2a436f9d1c"},"name":"keystone","type":"identity"},{"description":"CinderVolumeService","enabled":true,"id":"cdda3bea0742407f95e70f4758f46558","links":{"self":"http://localhost:5000/v3/services/cdda3bea0742407f95e70f4758f46558"},"name":"cinder","type":"volume"}]}元素含义service各子元素服务的uuid。id字符串（String）类型。必须，无缺省。name

服务的名称。字符串（String）类型。必须，无缺省。type

云服务的类型。字符串（String）类型。必须，无缺省。分为：description

云服务的描述。字符串（String）类型。非必须，无缺省。enabled

云服务的状态。字符串（String）类型。必须，无缺省。 true，false。应用举例查询云平台的服务状态信息列表。请求GEThttp://ip:port/v3/servicesaccept:application/json...回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"links":{"next":null,"previous":null,"self":"http://localhost:5000/v3/services"},"services":[{"description":"NovaComputeService","enabled":true,"id":"1999c3a858c7408fb586817620695098","links":{"self":"http://localhost:5000/v3/services/1999c3a858c7408fb586817620695098"},"name":"nova","type":"compute"},{"description":"CinderVolumeServiceV2","enabled":true,"id":"39216610e75547f1883037e11976fc0f","links":{"self":"http://localhost:5000/v3/services/39216610e75547f1883037e11976fc0f"},"name":"cinderv2","type":"volumev2"},{"description":"NeutronService","enabled":true,"id":"4fe41a27de3341af9100123f765eac0d","links":{"self":"http://localhost:5000/v3/services/4fe41a27de3341af9100123f765eac0d"},"name":"neutron","type":"network"},{"description":"EC2CompatibilityLayer","enabled":true,"id":"61d3d05bdd1449f18923c83f52a4d762","links":{"self":"http://localhost:5000/v3/services/61d3d05bdd1449f18923c83f52a4d762"},"name":"ec2","type":"ec2"},{"description":"GlanceImageService","enabled":true,"id":"69afa3d57d1948ea988beeb252bbaa5d","links":{"self":"http://localhost:5000/v3/services/69afa3d57d1948ea988beeb252bbaa5d"},"name":"glance","type":"image"},{"description":"NovaComputeServiceV2.1","enabled":true,"id":"79b691ee7be649d9bf8613efc0960206","links":{"self":"http://localhost:5000/v3/services/79b691ee7be649d9bf8613efc0960206"},"name":"novav21","type":"computev21"},{"description":"SwiftService","enabled":true,"id":"92419b70ebe64c6c873bd20b14360e6b","links":{"self":"http://localhost:5000/v3/services/92419b70ebe64c6c873bd20b14360e6b"},"name":"swift","type":"object-store"},{"description":"KeystoneIdentityService","enabled":true,"id":"b8f8454fc07b46b781204d2a436f9d1c","links":{"self":"http://localhost:5000/v3/services/b8f8454fc07b46b781204d2a436f9d1c"},"name":"keystone","type":"identity"},{"description":"CinderVolumeService","enabled":true,"id":"cdda3bea0742407f95e70f4758f46558","links":{"self":"http://localhost:5000/v3/services/cdda3bea0742407f95e70f4758f46558"},"name":"cinder","type":"volume"}]}查询平台资源使用情况查询云平台物理资源使用情况。接口URI/v3/resources访问方法方法GET返回结果状态码200(OK)：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。413：实体过大。503：服务不可用。消息体{"resource":{"vcpu":"3200","vcpu_used":"160","memory":"12800000","memory_used":"102400","storage":"100000","storage_used":"1000","floatingip":"255","floatingip_used":"10"}}元素含义resource各子元素resource各子元素vcpu

虚拟cpu总量。整数（int）类型。必须，无缺省。vcpu_used

虚拟cpu使用量。整数（int）类型。必须，无缺省。memory

内存总量。整数（int）类型。必须，无缺省。memory_used

内存使用量。整数（int）类型。必须，无缺省。storage

存储总量。整数（int）类型。必须，无缺省。storage_used

存储使用量。整数（int）类型。必须，无缺省。floatingip

公网ip总量整数（int）类型。必须，无缺省。floatingip_used

公网ip使用量整数（int）类型。必须，无缺省。应用举例查询云平台资源使用情况。请求GEThttp://ip:port/v3/resourcesaccept:application/json...回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{{"resource":{"vcpu":"3200","vcpu_used":"160","memory":"12800000","memory_used":"102400","storage":"100000","storage_used":"1000","publicip":"255","publicip_used":"10"}}电子政务云监管平台接口规范电子政务云监管平台接口规范3-13-1用户租户相关接口创建租户根据提供的参数创建租户。接口URI/v3/projects访问方法方法POST消息体{"project":{"description":"Mynewproject","domain_id":"default","enabled":true,"is_domain":true,"parent_id":null,"name":"myNewProject"}}参数说明字段 说明name

租户名称。字符串（String）类型。必须，无缺省。description

租户描述。字符串（String）类型。非必须，无缺省。parent_id

父租户id。字符串（String）类型。非必须，无缺省。电子政务云监管平台接口规范电子政务云监管平台接口规范3-3-PAGE19返回结果状态码201：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：错误的媒介类型。503：服务不可用。消息体{"project":{"is_domain":true,"description":"Mynewproject","links":{"self":"http://localhost:5000/v3/projects/93ebbcc35335488b96ff9cd7d18cbb2e"},"enabled":true,"id":"93ebbcc35335488b96ff9cd7d18cbb2e","parent_id":null,"domain_id":"default","name":"myNewProject"}}元素含义project 各子元素租户UUID。id字符串（String）类型。必须，无缺省。应用举例创建租户。请求POSThttp://ip:port/v3/projectsaccept:application/jsonContent-Type:application/json;charset=UTF-8-d{"project":{"description":"Mynewproject","domain_id":"default","enabled":true,"is_domain":true,"parent_id":null,"name":"myNewProject"}}回应HTTP/1.1201CreatedServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"project":{"is_domain":true,"description":"Mynewproject","links":{"self":"http://localhost:5000/v3/projects/93ebbcc35335488b96ff9cd7d18cbb2e"},"enabled":true,"id":"93ebbcc35335488b96ff9cd7d18cbb2e","parent_id":null,"domain_id":"default","name":"myNewProject"}}修改租户根据提供的参数编辑租户。接口URI/v3/projects/{project_id}访问方法方法PATCH消息体{"project":{"description":"Myupdatedproject","domain_id":"default","enabled":true,"name":"myUpdatedProject"}}参数说明字段 说明project_id

租户UUID。字符串（String）类型。必须，无缺省。name

租户名称。字符串（String）类型。必须，无缺省。description

租户描述。字符串（String）类型。非必须，无缺省。返回结果状态码200：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：错误的媒介类型。503：服务不可用。应用举例编辑租户。请求PUThttp://ip:port/v3/projects/93ebbcc35335488b96ff9cd7d18cbb2accept:application/jsonContent-Type:application/json;charset=UTF-8-d{"project":{"description":"Myupdatedproject","domain_id":"default","enabled":true,"name":"myUpdatedProject"}}回应HTTP/1.1204NoContentServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:0{{"project":{"is_domain":true,"description":"Myupdatedproject","links":{"self":"http://localhost:5000/v3/projects/93ebbcc35335488b96ff9cd7d18cbb2e"},"extra":{"is_domain":true},"enabled":true,"id":"93ebbcc35335488b96ff9cd7d18cbb2e","parent_id":null,"domain_id":"default","name":"myUpdatedProject"}}删除租户根据提供的租户 UUID删除租户。接口URI/v3/projects/{project_id}访问方法方法DELETE消息体无参数说明字段 说明project_id

租户UUID。字符串（String）类型。必须，无缺省。返回结果状态码204：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：错误的媒介类型。503：服务不可用。消息体无应用举例删除租户。请求DELETEhttp://ip:port/v3/projects/d6e91406-9a7a-48db-90e8-e44fad6df45c回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:0查询租户根据提供的租户 UUID查询租户信息。接口URI/v3/projects/{project_id}访问方法方法GET参数说明字段 说明project_id

租户UUID。字符串（String）类型。必须，无缺省。返回结果状态码200：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：错误的媒介类型。503：服务不可用。消息体{"project":{"description":null,"domain_id":"default","enabled":true,"id":"0c4e939acacf4376bdcd1129f1a054ad","links":{"self":"http://localhost:5000/v3/projects/0c4e939acacf4376bdcd1129f1a054ad"},"name":"admin","parent_id":null}}元素含义project 各子元素租户UUID。id字符串（String）类型。必须，无缺省。name

租户名称。字符串（String）类型。必须，无缺省。description

租户描述。字符串（String）类型。非必须，无缺省。应用举例查询租户信息。请求GEThttp://ip:port/v3/projects/d6e91406-9a7a-48db-90e8-e44fad6df45caccept:application/json回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"project":{"description":null,"domain_id":"default","enabled":true,"id":"0c4e939acacf4376bdcd1129f1a054ad","links":{"self":"http://localhost:5000/v3/projects/0c4e939acacf4376bdcd1129f1a054ad"},"name":"admin","parent_id":null}}创建用户根据提供的参数创建用户。接口URI/v3/users访问方法方法POST消息体{"user":{"default_project_id":"263fd9","description":"JamesDoeuser","domain_id":"1789d1","email":\h"jdoe@","enabled":true,"name":"JamesDoe","password":"secretsecret"}}参数说明字段 说明name

用户名。字符串（String）类型。必须，无缺省。password

登陆密码。字符串（String）类型。必须，无缺省。description

用户描述。字符串（String）类型。非必须，无缺省。default_project_id

用户所在的租户 。字符串（String）类型。必须，无缺省。email

用户的电子邮箱。字符串（String）类型。非必须，无缺省。返回结果状态码201(Created) ：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：错误的媒介类型。503：服务不可用。消息体{"user":{"default_project_id":"263fd9","description":"JamesDoeuser","domain_id":"1789d1","email":\h"jdoe@","enabled":true,"id":"76e979a8-d712-47c6-8783-9032d4422cfc","links":{"self":"https://identity:35357/v3/users/ff4e51"},"name":"JamesDoe"}}元素含义字段 说明用户的UUID。id字符串（String）类型。应用举例创建用户。请求POSThttp://ip:port/v3/usersaccept:application/jsonContent-Type:application/json;charset=UTF-8-d{"user":{"default_project_id":"263fd9","description":"JamesDoeuser","domain_id":"1789d1","email":\h"jdoe@","enabled":true,"name":"JamesDoe","password":"secretsecret"}}回应HTTP/1.1201CreatedServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"user":{"default_project_id":"263fd9","description":"JamesDoeuser","domain_id":"1789d1","email":\h"jdoe@","enabled":true,"id":"ff4e51","links":{"self":"https://identity:35357/v3/users/ff4e51"},"name":"JamesDoe"}}修改用户根据提供的参数编辑用户。接口URI/v3/users/{user_id}访问方法方法PATCH消息体{"user":{"default_project_id":"263fd9","description":"JamesDoe'suser","email":\h"jamesdoe@","password":"xxxx","enabled":true}}参数说明字段 说明user_id

用户的UUID。字符串（String）类型。必须，无缺省。name

用户姓名。字符串（String）类型。非必须，无缺省。password

登陆密码。字符串（String）类型。非必须，无缺省。description

用户描述。字符串（String）类型。非必须，无缺省。default_project_id

用户所在的租户 。字符串（String）类型。必须，无缺省。email

用户的电子邮箱。字符串（String）类型。非必须，无缺省。返回结果状态码200：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：错误的媒介类型。503：服务不可用。应用举例编辑用户。请求PUThttp://ip:port/v3/users/ff4e51accept:application/jsonContent-Type:application/json;charset=UTF-8-d{"user":{"default_project_id":"263fd9","description":"JamesDoe'suser","email":\h"jamesdoe@","password":"xxxx","enabled":true}}回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"user":{"default_project_id":"263fd9","description":"JamesDoe'suser","domain_id":"1789d1","email":\h"jamesdoe@","enabled":true,"id":"ff4e51","links":{"self":"https://identity:35357/v3/users/ff4e51"},"name":"jamesdoe"}}查询用户根据提供的用户 UUID查询用户信息。接口URI/v3/users/{user_id}访问方法方法GET参数说明字段 说明user_id

用户UUID。字符串（String）类型。必须，无缺省。返回结果状态码200：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。503：服务不可用。消息体{"user":{"default_project_id":"263fd9","description":"JohnSmith'suser","domain_id":"1789d1","email":\h"jsmith@","enabled":true,"id":"9fe1d3","links":{"self":"https://identity:35357/v3/users/9fe1d3"},"name":"jsmith"}}元素含义字段 说明用户的UUID。id字符串（String）类型。必须，无缺省。name

用户名。字符串（String）类型。必须，无缺省。description

用户描述。字符串（String）类型。非必须，无缺省。default_project_id

用户所在的租户 。字符串（String）类型。必须，无缺省。email

用户的电子邮箱。字符串（String）类型。非必须，无缺省。应用举例查询用户信息。请求GEThttp://ip:port/v3/users/d6e91406-9a7a-48db-90e8-e44fad6df45caccept:application/json回应回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"user":{"default_project_id":"263fd9","description":"JohnSmith'suser","domain_id":"1789d1","email":\h"jsmith@","enabled":true,"id":"9fe1d3","links":{"self":"https://identity:35357/v3/users/9fe1d3"},"name":"jsmith"}}删除用户根据提供的 UUID删除用户。接口URI/v3/user/{user_id}访问方法方法DELETE消息体无参数说明字段 说明user_id

用户UUID。字符串（String）类型。必须，无缺省。返回结果状态码204：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。409：请求冲突。413：请求实体过大。415：不支持的媒介。503：服务不可用。应用举例删除用户。请求DELETEhttp://ip:port/v3/users/d6e91406-9a7a-48db-90e8-e44fad6df45c回应HTTP/1.1204NoContentServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:0电子政务云监管平台接口规范电子政务云监管平台接口规范4-14-1虚拟机相关接口查询虚拟机列表查询虚拟机详细列表。接口URI/v2.1/{tenant_id}/servers/detail访问方法方法GET参数说明字段 说明tenant_id

租户UUID。字符串（String）类型。必须，无缺省。changes-since

根据最后状态变更的时间过滤。字符串（String）类型，非必须，无缺省。image

根据使用镜像的 进行过滤。字符串（String）类型，非必须，无缺省。flavor

根据使用规格的 进行过滤。字符串（String）类型，非必须，无缺省。name

根据名称过滤。字符串（String）类型，非必须，无缺省。status

根据状态过滤。字符串（String）类型，非必须，无缺省。host

根据主机名过滤。字符串（String）类型，非必须，无缺省。limit

分页标识，每页多少条，要与 marker配合整数类型（int），非必须，无缺省。电子政务云监管平台接口规范电子政务云监管平台接口规范4-4-PAGE15字段 说明marker

根据最后一条的 。字符串（String）类型，非必须，无缺省。返回结果状态码200(OK)：成功。203：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。500：内部错误。503：服务不可用。消息体{"servers":[{"addresses":{"private":[{"addr":"","OS-EXT-IPS-MAC:mac_addr":"aa:bb:cc:dd:ee:ff","OS-EXT-IPS:type":"fixed","version":4}]},"created":"2013-09-23T13:37:00Z","flavor":"id":"1","links":[{"href":\h"/openstack/flavors/1","rel":"bookmark"}]},"hostId":"9cc36101a27c2a69c1a18241f6228454d9d7f466bd90c62db8e8b856","id":"f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","image":{"id":"70a599e0-31e7-49b7-b260-868f441e862b","links":[{"href":\h"/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b","rel":"bookmark"}]},"key_name":null,"links":[{"href":\h"/v2/openstack/servers/f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","rel":"self"},{"href":\h"/openstack/servers/f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","rel":"bookmark"}],"metadata":{"MyServerName":"Apache1"},"name":"new-server-test","accessIPv4":"","accessIPv6":"","config_drive":"","OS-DCF:diskConfig":"AUTO","OS-EXT-AZ:availability_zone":"nova","OS-EXT-SRV-ATTR:host":"b8b357f7100d4391828f2177c922ef93","OS-EXT-SRV-ATTR:hypervisor_hostname":"fake-mini","OS-EXT-SRV-ATTR:instance_name":"instance-00000001","OS-EXT-STS:power_state":1,"OS-EXT-STS:task_state":null,"OS-EXT-STS:vm_state":"active","os-extended-volumes:volumes_attached":[],"OS-SRV-USG:launched_at":"2013-09-23T13:37:00.880302","OS-SRV-USG:terminated_at":null,"progress":0,"security_groups":[{"name":"default"}],"status":"ACTIVE","tenant_id":"openstack","updated":"2013-10-31T07:31:30Z","user_id":"fake"}]}元素含义server各子元素tenant_id

租户UUID。字符串（String）类型。必须，无缺省。user_id

用户UUID。字符串（String）类型。必须，无缺省。name

虚拟机的名称。字符串（String）类型。必须，无缺省。虚拟机的状态。building ：创建active ：正常；status

stopped：停止error：异常suspended：挂起unknown：未知字符串（String）类型。必须，无缺省。server各子元素OS-EXT-SRV-ATTR:host

虚拟机所在主机的名称。字符串（String）类型。必须，无缺省。OS-EXT-SRV-ATTR:hypervisor_hostname

虚拟机所在的虚拟化服务器的 hostname字符串（String）类型。必须，无缺省。OS-EXT-SRV-ATTR:instance_name

虚拟机在libvirt 中的名称。字符串（String）类型。必须，无缺省。OS-EXT-STS:power_state

虚拟机电源状态。字符串（String）类型。0：未上电，1上电。必须，无缺省。虚拟机任务状态。字符串（String）类型。分为：snapshot：快照中OS-EXT-STS:task_state

resize：规格变更shutoff ：关机中creating ：创建中空：无任务非必须，缺省""。flavor

虚拟机使用的规格信息。字符串（String）类型。必须，无缺省。image

虚拟机使用的镜像信息。字符串（String）类型。必须，无缺省。security_groups

虚拟机使用的安全组名称列表。字符串（String）类型。必须，无缺省。OS-SRV-USG:launched_at

虚拟机的创建时间。时间（datetime）类型。必须，无缺省。addresses

虚拟机上挂载的网卡信息。列表（List）类型。必须，无缺省。lumes_attached

虚拟机上挂载的磁盘 列表。列表（List）类型。必须，无缺省应用举例查询uuid为“f1366662-49d2-4259-9486-f8acca864af4 ”的虚拟机的详细信息。请求GEThttp://ip:port/v2.1/6cb71f4a-7ce8-4f5b-ae0e-09678397b9de/servers/detailaccept:application/json...回应HTTP/1.1200OKServer:Apache-Coyote/1.1Content-Type:application/jsonContent-Length:521{"servers":[{"addresses":{"private":[{"addr":"","OS-EXT-IPS-MAC:mac_addr":"aa:bb:cc:dd:ee:ff","OS-EXT-IPS:type":"fixed","version":4}]},"created":"2013-09-23T13:37:00Z","flavor":"id":"1","links":[{"href":\h"/openstack/flavors/1","rel":"bookmark"}]},"hostId":"9cc36101a27c2a69c1a18241f6228454d9d7f466bd90c62db8e8b856","id":"f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","image":{"id":"70a599e0-31e7-49b7-b260-868f441e862b","links":[{"href":\h"/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b","rel":"bookmark"}]},"key_name":null,"links":[{"href":\h"/v2/openstack/servers/f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","rel":"self"},{"href":\h"/openstack/servers/f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","rel":"bookmark"}],"metadata":{"MyServerName":"Apache1"},"name":"new-server-test","accessIPv4":"","accessIPv6":"","config_drive":"","OS-DCF:diskConfig":"AUTO","OS-EXT-AZ:availability_zone":"nova","OS-EXT-SRV-ATTR:host":"b8b357f7100d4391828f2177c922ef93","OS-EXT-SRV-ATTR:hypervisor_hostname":"fake-mini","OS-EXT-SRV-ATTR:instance_name":"instance-00000001","OS-EXT-STS:power_state":1,"OS-EXT-STS:task_state":null,"OS-EXT-STS:vm_state":"active","os-extended-volumes:volumes_attached":[],"OS-SRV-USG:launched_at":"2013-09-23T13:37:00.880302","OS-SRV-USG:terminated_at":null,"progress":0,"security_groups":[{"name":"default"}],"status":"ACTIVE","tenant_id":"openstack","updated":"2013-10-31T07:31:30Z","user_id":"fake"}]}查询虚拟机详细信息根据所提供的 uuid，查询虚拟机详细信息。接口URI/v2.1/{tenant_id}/servers/{server_id}访问方法方法GET参数说明字段 说明server_id

虚拟机UUID。字符串（String）类型。必须，无缺省。tenant_id

租户UUID。字符串（String）类型。必须，无缺省。返回结果状态码200(OK)：成功。203：成功。400：错误的请求。401：未授权。403：禁止访问。404：资源不存在。405：错误的方法。500：内部错误。503：服务不可用。消息体{"server":{"addresses":{"private":[{"addr":"","OS-EXT-IPS-MAC:mac_addr":"aa:bb:cc:dd:ee:ff","OS-EXT-IPS:type":"fixed","version":4}]},"created":"2013-09-23T13:37:00Z","flavor":"id":"1","links":[{"href":\h"/openstack/flavors/1","rel":"bookmark"}]},"hostId":"9cc36101a27c2a69c1a18241f6228454d9d7f466bd90c62db8e8b856","id":"f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","image":{"id":"70a599e0-31e7-49b7-b260-868f441e862b","links":[{"href":\h"/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b","rel":"bookmark"}]},"key_name":null,"links":[{"href":\h"/v2/openstack/servers/f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","rel":"self"},{"href":\h"/openstack/servers/f474386b-4fb6-4e1f-b1d5-d6bf4437f7d5","rel":"bookmark"}],"metadata":{"MyServerName":"Apache1"},"name":"new-server-test","accessIPv4":"","accessIPv6":"","config_drive":"","OS-DCF:diskConfig":"AUTO","OS-EXT-AZ:availability_zone":"nova","OS-EXT-SRV-ATTR:host":"b8b357f7100d4391828f2177c922ef93","OS-EXT-SRV-ATTR:hypervisor_hostname":"fake-mini","OS-EXT-SRV-ATTR:instance_name":"instance-00000001","OS-EXT-STS:power_state":1,"OS-EXT-STS:task_state":null,"OS-EXT-STS:vm_state":"active","os-extended-volumes:volumes_attached":[],"OS-SRV-USG:launched_at":"2013-09-23T13:37:00.880302","OS-SRV-USG:terminated_at":null,"progress":0,"security_groups":[{"name":"default"}],"status":"ACTIVE","tenant_id":"openstack","updated":"2013-10-31T07:31:30Z","user_id":"fake"}}元素含义server各子元素tenant_id

租户UUID。字符串（String）类型。必须，无缺省。user_id

用户UUID。字符串（String）类型。必须，无缺省。name

虚拟机的名称。字符串（String）类型。必须，无缺省。虚拟机的状态。building ：创建active ：正常；status

stopped：停止error：异常suspended：挂起unknown：未知字符串（String）类型。必须，无缺省。OS-EXT-SRV-ATTR:host

虚拟机所在主机的名称。字符串（String）类型。必须，无缺省。OS-EXT-SRV-ATTR:hypervisor_hostname

虚拟机所在的虚拟化服务器的 hostname字符串（String）类型。必须，无缺省。OS-EXT-SRV-ATTR:instance_name

虚拟机在libvirt 中的名称。字符串（String）类型。必须，无缺省。OS-EXT-STS:power_state

虚拟机电源状态。字符串（String）类型。0：未上电，1上电。必须，无缺省。server各子元素虚拟机任务状态。字符串（String）类型。分为：snapshot：快照中OS-EXT-STS:task_state

resize：规格变更shutoff ：关机中creating ：创建中空：无任务非必须，缺省""。flavor

虚拟机使用的规格信息。字符串（String）类型。必须，无缺