创建系统标签

POST/zstack/v1/system-tags

Request

cURL

curl --request POST \
  --url '/v1/system-tags' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "status": "ok",
  "method": "POST",
  "path": "/v1/system-tags"
}

Headers

Authorization: OAuth the-session-uuid

Body

{
  "params": {
    "resourceType": "HostVO",
    "resourceUuid": "c31d63c6d40d489e87fa7e1ee5707d47",
    "tag": "reservedMemory::1G"
  },
  "systemTags": [],
  "userTags": []
}

上述示例中systemTags、userTags字段可以省略。列出是为了表示body中可以包含这两个字段。

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X POST -d '{"params":{"resourceType":"HostVO","resourceUuid":"47609e353c6f331f93ac114d06379f8d","tag":"reservedMemory::1G"}}' \
http://localhost:8080/zstack/v1/system-tags

参数列表

名字	类型	位置	描述	起始版本
resourceType	String	body(包含在params结构中)	当创建一个标签时, 用户必须指定标签所关联的资源类型	0.6
resourceUuid	String	body(包含在params结构中)	用户指定的资源UUID，若指定，系统不会为该资源随机分配UUID	0.6
tag	String	body(包含在params结构中)	标签字符串	0.6
systemTags (可选)	List	body	系统标签	0.6
userTags (可选)	List	body	用户标签	0.6

ZSvirt创建系统标签时支持配置是否关机自动卸载从设备规格分配的物理PCI设备，对已有虚拟机，也可以删除或更改其配置。SystemTags增加autoReleaseSpecReleatedPhysicalPciDevice选项。

选项格式为：autoReleaseSpecReleatedPhysicalPciDevice
例如：autoReleaseSpecReleatedPhysicalPciDevice
ZSvirt创建系统标签时支持配置是否关机自动卸载从设备规格分配的虚拟PCI设备，对已有虚拟机，也可以删除或更改其配置。SystemTags增加autoReleaseSpecReleatedVirtualPciDevice选项。
- 选项格式为：autoReleaseSpecReleatedVirtualPciDevice
- 例如：autoReleaseSpecReleatedVirtualPciDevice
ZSvirt创建系统标签时支持设置虚拟机跨集群高可用策略，SystemTags增加resourceBindings选项。
- 选项格式为：resourceBindings::Cluster:clusterUuid，其中clusterUuid为对应的集群uuid
- 例如：resourceBindings::Cluster:2sdasf231jvznsdak
ZSvirt创建系统标签时支持在boot.ipxe文件中增加自定义参数，SystemTags增加extraBootParams选项。
- 选项格式为：extraBootParams::{自定义参数}
- 例如：extraBootParams::{acpi=noirq noapic}

API返回

返回示例

{
  "inventory": {
    "inherent": false,
    "uuid": "55d86810cb564ecc934fa79d498b9dc3",
    "resourceType": "HostVO",
    "tag": "reservedMemory::1G",
    "type": "System",
    "createDate": "Apr 24, 2017 7:10:55 PM",
    "lastOpDate": "Apr 24, 2017 7:10:55 PM"
  }
}

名字	类型	描述	起始版本
error	ErrorCode	错误码，若不为null，则表示操作失败, 操作成功时该字段为null。详情参考error	0.6
inventory	SystemTagInventory	详情参考inventory	0.6

error

名字	类型	描述	起始版本
ode	String	错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001	0.6
description	String	错误的概要描述	0.6
details	String	错误的详细信息	0.6
elaboration	String	保留字段，默认为null	0.6
opaque	LinkedHashMap	保留字段，默认为null	0.6
cause	ErrorCode	根错误，引发当前错误的源错误，若无原错误，该字段为null	0.6

inventory

名字	类型	描述	起始版本
inherent	Boolean	内部系统标签	0.6
uuid	String	资源的UUID，唯一标示该资源	0.6
resourceUuid	String	用户指定的资源UUID，若指定，系统不会为该资源随机分配UUID	0.6
resourceType	String	当创建一个标签时, 用户必须制定标签所关联的资源类型(resource type)	0.6
tag	String	标签字符串	0.6
type	String	保留域, 请不要使用它	0.6
createDate	Timestamp	创建时间	0.6
lastOpDate	Timestamp	最后一次修改时间	0.6

SDK示例

Java SDK

CreateSystemTagAction action = new CreateSystemTagAction();
action.resourceType = "HostVO";
action.resourceUuid = "c63dfecc5c3f4f24bdab3eda92036eef";
action.tag = "reservedMemory::1G";
action.sessionId = "494209d421304d1cb9b8aaab7cac3a45";
CreateSystemTagAction.Result res = action.call();

Python SDK

CreateSystemTagAction action = CreateSystemTagAction()
action.resourceType = "HostVO"
action.resourceUuid = "d8f0bf84c4bc41c99ff7129a369515c1"
action.tag = "reservedMemory::1G"
action.sessionId = "f84ee562742b4aaab791842d71f5d472"
CreateSystemTagAction.Result res = action.call()