标签管理相关接口

ZStack Cloud 4.8.10>ZStack CLoud开发手册>平台运维>标签管理相关接口

创建系统标签(CreateSystemTag)

API请求

URLs

POST zstack/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

说明:

ZStack Cloud创建系统标签时支持配置是否关机自动卸载从设备规格分配的物理PCI设备，对已有云主机，也可以删除或更改其配置。SystemTags增加autoReleaseSpecReleatedPhysicalPciDevice选项。
- 选项格式为：autoReleaseSpecReleatedPhysicalPciDevice
- 例如：autoReleaseSpecReleatedPhysicalPciDevice
ZStack Cloud创建系统标签时支持配置是否关机自动卸载从设备规格分配的虚拟PCI设备，对已有云主机，也可以删除或更改其配置。SystemTags增加autoReleaseSpecReleatedVirtualPciDevice选项。
- 选项格式为：autoReleaseSpecReleatedVirtualPciDevice
- 例如：autoReleaseSpecReleatedVirtualPciDevice
ZStack Cloud创建系统标签时支持设置云主机/VPC路由器跨集群高可用策略，SystemTags增加resourceBindings选项。
- 选项格式为：resourceBindings::Cluster:clusterUuid，其中clusterUuid为对应的集群uuid
- 例如：resourceBindings::Cluster:2sdasf231jvznsdak
ZStack Cloud创建系统标签时支持标识和过滤性能独享型负载均衡器/VPC路由器的镜像，SystemTags增加applianceType选项。
- 选项格式为：applianceType::type，其中type为性能独享型负载均衡器或VPC路由器的镜像
- 例如：applianceType::slb
ZStack Cloud创建系统标签时支持标识性能独享型负载均衡器，SystemTags增加SlbGroupUuid选项。
- 选项格式为：SlbGroupUuid::uuid，其中uuid性能独享型负载均衡器的uuid
- 例如：SlbGroupUuid::12345678
ZStack Cloud创建系统标签时支持在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()

查询系统标签(QuerySystemTag)

API请求

URLs

GET zstack/v1/system-tags GET zstack/v1/system-tags/{uuid}

Headers

Authorization: OAuth the-session-uuid

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \ -H "Authorization: OAuth 67bf58bea6854e568556b0e9f4bc84f6" \ -X GET http://localhost:8080/zstack/v1/system-tags?q=inherent=true&q=resourceType=HostVO

curl -H "Content-Type: application/json;charset=UTF-8" \ -H "Authorization: OAuth c798e7031aaa430386636f9ff8d6bb17" \ -X GET http://localhost:8080/zstack/v1/system-tags/7c8162efed2840c08a43e0afdcebf01b

可查询字段

运行CLI命令行工具，输入QuerySystemTag并按Tab键查看所有可查询字段以及可跨表查询的资源名。

API返回

返回示例

{   "inventories": [     {       "inherent": false,       "uuid": "0bba7cb618314646aea4e70b9be3bfea",       "resourceType": "HostVO",       "tag": "reservedMemory::1G",       "type": "System",       "createDate": "May 11, 2017 1:22:40 PM",       "lastOpDate": "May 11, 2017 1:22:40 PM"     }   ] }

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

#error

名字	类型	描述	起始版本
code	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

#inventories

名字	类型	描述	起始版本
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

QuerySystemTagAction action = new QuerySystemTagAction(); action.conditions = asList("inherent=true","resourceType=HostVO"); action.sessionId = "05c74fc02e574e678a407f0ccef8ae5f"; QuerySystemTagAction.Result res = action.call();

Python SDK

QuerySystemTagAction action = QuerySystemTagAction() action.conditions = ["inherent=true","resourceType=HostVO"] action.sessionId = "a1d2f95577514d0a918ce1502dc27e33" QuerySystemTagAction.Result res = action.call()

更新系统标签（UpdateSystemTag）

API请求

URLs

PUT zstack/v1/system-tags/{uuid}/actions

Headers

Authorization: OAuth the-session-uuid

Body

{   "updateSystemTag": {     "tag": "for-large-DB"   },   "systemTags": [],   "userTags": [] }

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

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \ -H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \ -X PUT -d '{"updateSystemTag":{"tag":"for-large-DB"}}' \ http://localhost:8080/zstack/v1/system-tags/2cb4ac52794535c3ae61f9612c1579e7/actions

参数列表

名字	类型	位置	描述	起始版本
uuid	String	url	资源的UUID，唯一标示该资源	0.6
tag	String	body(包含在updateSystemTag结构中)	标签字符串	0.6
systemTags (可选)	List	body	系统标签	0.6
userTags (可选)	List	body	用户标签	0.6

API返回

返回示例

{   "inventory": {     "inherent": false,     "uuid": "c17377dfd0794521a4fe02b6eb16cc5a",     "resourceType": "HostVO",     "tag": "reservedMemory::1G",     "type": "System",     "createDate": "May 11, 2017 1:22:30 PM",     "lastOpDate": "May 11, 2017 1:22:30 PM"   } }

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

#error

名字	类型	描述	起始版本
code	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

UpdateSystemTagAction action = new UpdateSystemTagAction(); action.uuid = "1ba32bc1af0446b29bd969029a6052a5"; action.tag = "for-large-DB"; action.sessionId = "367f6162107a47d58c471c9164139fab"; UpdateSystemTagAction.Result res = action.call();

Python SDK

UpdateSystemTagAction action = UpdateSystemTagAction() action.uuid = "be98b2f4e342485486cfa612eeabcaa5" action.tag = "for-large-DB" action.sessionId = "6b7af956a9a9477eba02753417380070" UpdateSystemTagAction.Result res = action.call()

下一章:迁移服务(Plus)