虚拟数据中心 REST API

可使用此 REST API 来管理虚拟数据中心。

获取所有虚拟数据中心

表 1. 获取所有虚拟数据中心
REST API 信息 描述
URI /admin/resources/vdcs  
方法 (method) GET  
返回 200 返回所有虚拟数据中心的列表
404 找不到虚拟数据中心的列表
500 平台 System Manager 在处理请求时迂到内部错误。

返回所有虚拟数据中心的列表。

可使用可选参数来修改来自 REST API 调用的响应。 有关更多信息,请参阅相关信息部分。

响应主体


[
	-{
	-"colocation_policy": "Availability",
	-"compute_nodes": [
	-"/admin/resources/compute_nodes/39c04e23-59ef-493e-a23a-85a8b6374824",
	-"/admin/resources/compute_nodes/99bb903d-7588-46b9-b099-ae553bf8f31b"],
	-"created_time": "Wed 18 Dec 2013 17:42:03.549 UTC",
	-"created_time_raw": 1387388523549,
	-"description": "Default Cloud Pak System Shared Cloud Group",
	-"dr_storage_last_state_change_time": null,
	-"dr_storage_message": null,
	-"dr_storage_progress": null,
	-"dr_storage_state": null,
	-"hypervisor_type": "Platform System_PowerVM",
	-"id": "/admin/resources/vdcs/f9ee31d2-aba2-4e36-9a6f-447bd2943bc4",
	-"ip": "fd8c:215d:178e:1234:290:fa71:fa34:9fd6",
	-"is_highly_available": "T",
	-"is_public": "F",
	-"isas_rn": 1,
	-"label_key": "pure0538",
	-"label_text": "Default Cloud Pak System Shared Cloud Group",
	-"last_state_change_reason_key": null,
	-"last_state_change_reason_text": null,
	-"management_nodes": [ ],
	-"max_memory": 230400,
	-"max_vcpucount": 64,
	-"message": "",
	-"name": "Shared",
	-"state": "available",
	-"storage_volumes": [
	-"/admin/resources/storage_volumes/13690161-8f84-49c1-9c82-50a8e94cd15a",
	-"/admin/resources/storage_volumes/e4abc8fd-c47e-45e4-994c-4a0a0644c866",
	-"/admin/resources/storage_volumes/76b5c18b-8b1f-4377-83ad-bd1f9ee957aa"],
	-"type": "Average",
	-"updated_time": "Thu 09 Jan 2014 15:36:09.186 UTC",
	-"updated_time_raw": 1389281769186,
	-"vdc_stats": [
	-"/admin/resources/vdc_stats/aa80719c-b7ff-4ec0-a393-0e6a0e9d8696"],
	}
	]
compute_nodes
虚拟数据中心中的计算节点。
created_time
对象的创建时间。
created_time_raw
用长整型值表示的创建时间。
描述
云组的描述。
hypervisor_type
管理程序类型。
id
系统中对象的唯一标识,包括 URI,例如:
/admin/resources/vdcs/f9ee31d2-aba2-4e36-9a6f-447bd2943bc4
ip
此对象的 IP 地址。
is_highly_available
指示它是否具有高可用性,
is_public
指示云组是否为 用于使用外部管理连接进行 多云 部署。 允许值为 TF
isas_rn
指示表中子组件的相对顺序的整数值(例如,列示的第 4 个子组件在此属性中具有值 4)。
label_key
用于检索虚拟数据中心的标签的关键字。
label_text
缺省的已转换消息文本。
last_state_change_reason_key
最近一次 VDC 状态更改的原因。
last_state_change_reason_text
与 VDC 的状态相关联的任何消息都显示在此区域中。
management_nodes
虚拟数据中心中的管理节点。
max_memory
虚拟数据中心中的最大内存量。
max_vcpucount
数据中心中最大虚拟 CPU 数。
名称
分配给存储虚拟数据中心的名称。
state
对象的一般可用性。 如果是 pending 状态,那么该对象已创建但未将其激活。 如果 available,那么对象在系统中处于活动状态。
storage_volumes
与此 VDC 关联的存储卷。
类型
对象 vdc_stats 中包含的数据的类型
vcpuratio
用于此虚拟数据中心的 CPU 比率。
updated_time
指示更新此对象的日期和时间的时间戳记。 此值为以全球标准时间 (UTC) 格式表示的日期和时间(示例:Fri 03 Jan 2014 15:59:20.613 UTC)。
updated_time_raw
指示上次更新此对象时间的机器可读时间戳记。 此值为长整形整数(示例:1392069799633)。
vdc_stats
VDC 统计信息的标识。

获取特定虚拟数据中心

表 2. 获取特定虚拟数据中心
REST API 信息 描述
URI /admin/resources/vdc_stats/{id}  
方法 (method) GET  
返回 200 返回虚拟数据中心标识。
404 找不到虚拟数据中心标识。
500 平台 System Manager 在处理请求时迂到内部错误。

返回由 {id} 标识的单个虚拟数据中心。

可使用可选参数来修改来自 REST API 调用的响应。 有关更多信息,请参阅相关信息部分。