概览

ZStack Cloud提供两类标签帮助用户和插件管理资源, 引入额外的资源属性,以及指挥ZStack Cloud执行特殊的业务逻辑。

用户标签(User Tags)

  1. 用户可以在所拥有的资源上创建用户标签,这对于管理相似资源的聚集特别有用。
    例如,用户可以为作为网页服务器的云主机设置一个标签web
    1. CreateUserTag resourceType=VmInstanceVO \ resourceUuid=613af3fe005914c1643a15c36fd578c6 tag=web
      CreateUserTag resourceType=VmInstanceVO \ resourceUuid=5eb55c39db015c1782c7d814900a9609 tag=web
      CreateUserTag resourceType=VmInstanceVO \ resourceUuid=0cd1ef8c9b9e0ba82e0cc9cc17226a26 tag=web
    2. 之后,可以通过Query API with tags <query with tags>来获取这些云主机:
      QueryVmInstance __userTag__=web
    用户也可以在创建云主机的时候设置多个标签,标签之间用","分隔,这样可以实现多个usertags
    1. CreateVmInstance instanceOfferingUuid=1cf417bfd0e94175aea92131f1000011  \ imageUuid=ee14c7c8cc46309d821c51bbae3adb70 l3NetworkUuids=ac5c7e736f1b499bbd0c12763b30051d  \ name=tesd2 userTags=capability::liveSnapshot,os::centos::7.4
    2. 用户可以标识:容量40G,OS Centos7.4,密码是123456,用于Apache 场景。这些跟 :: 没有特别的关系
      CreateVmInstance instanceOfferingUuid=1cf417bfd0e94175aea92131f1000011  \ imageUuid=ee14c7c8cc46309d821c51bbae3adb70 l3NetworkUuids=ac5c7e736f1b499bbd0c12763b30051d name=tesd2   \ userTags=capability:40G,OS:CentOS7.4,password:123456,usage:Apache
  2. 用户也可以通过用户标签和系统标签(system tags)合作来改变业务逻辑。

    例如,用户想在所有作为网页服务器的云主机上,在一个特定的通过SSD提高IO性能的主存储上,创建他们的根云盘。

    要达到这一目的,用户可以这样做:
    1. 在主存储上创建一个用户标签forWebTierVM
      CreateUserTag tag=forWebTierVM resourceType=PrimaryStorageVO \ resourceUuid=6572ce44c3f6422d8063b0fb262cbc62
    2. 然后,在计算规格上创建一个系统标签:
      CreateSystemTag tag=primaryStorage::allocator::userTag::forWebTierVM \ resourceType=InstanceOfferingVO resourceUuid=8f69ef6c2c444cdf8c019fa0969d56a5
    3. 这样,当用户通过计算规格(UUID:8f69ef6c2c444cdf8c019fa0969d56a5)创建云主机时,ZStack Cloud会保证云主机的根云盘都会被创建在拥有用户标签forWebTierVM的主存储(UUID:6572ce44c3f6422d8063b0fb262cbc62)上。

系统标签(System Tags)

系统标签相比用户标签有更广泛的用途。就像上节中的例子一样,用户可以灵活使用它们来指挥ZStack Cloud执行特殊的业务逻辑。

  1. 内部系统标签

    扩展ZStack Cloud功能的插件,可以通过使用系统标签来引入额外的资源属性,或记录和资源紧密相关的元数据。

    例如,用户想在KVM云主机上实施在线迁移或者在线快照。

    ZStack Cloud需要知道KVM云主机的libvirt版本和QEMU版本,这些信息都是元数据,ZStack Cloud将它们作为云主机的系统标签存储起来。

    1. 管理员可以通过以下命令查看一个KVM云主机的系统标签:
      QuerySystemTag fields=tag resourceUuid=d07066c4de02404a948772e131139eb4
    2. d07066c4de02404a948772e131139eb4是该KVM云主机的UUID,查询结果为:
      {   "inventories": [       {           "tag": "capability:liveSnapshot"       },       {           "tag": "qemu-img::version::2.0.0"       },       {           "tag": "os::version::14.04"       },       {           "tag": "libvirt::version::1.2.2"       },       {           "tag": "os::release::trusty"       },       {           "tag": "os::distribution::Ubuntu"       }   ],   "success": true }

    这类系统标签,被称为内部系统标签。内部系统标签只能被ZStack Cloud的服务或插件创建,并且不能被DeleteTag API删除。

  2. 非内部系统标签

    为了增加新的功能,插件通常需要为一个资源添加新的属性。虽然插件不能通过改变一个资源的数据库模式来增加一个新的列,但它可以为一个资源创建作为系统标签的新属性。

    例如,当创建一个云主机时,用户可以为云主机某L3网络上的网卡绑定一个可以通过网络访问的主机名:
    1. CreateVmInstance name=testTag systemTags=hostname::web-server-1 \ l3NetworkUuids=6572ce44c3f6422d8063b0fb262cbc62 \ instanceOfferingUuid=04b5419ca3134885be90a48e372d3895 \ imageUuid=f1205825ec405cd3f2d259730d47d1d8
    2. 这个主机名被实现为一个系统标签;
    3. 如果查看VM inventory in chapter ‘Virtual Machine’, 那里没有叫做hostname的属性;
    4. 然而,可以在云主机的系统标签中发现它:
      QuerySystemTag fields=tag uuid resourceUuid=76e119bf9e16461aaf3d1b47c645c7b7
      {   "inventories": [       {           "tag": "hostname::web-server-1",           "uuid": "596070a6276746edbf0f54ef721f654e"       }   ],   "success": true }

    这类系统标签就是非内部的,用户可以通过DeleteTag API删除它。

    例如,用户想把一个之前的云主机的主机名更改为web-server-nginx,可以这样做:
    1. DeleteTag uuid=596070a6276746edbf0f54ef721f654e
    2. CreateSystemTag resourceType=VmInstanceVO tag=hostname::web-server-nginx \ resourceUuid=76e119bf9e16461aaf3d1b47c645c7b7
    3. 停止和启动云主机之后,云主机中的系统会接受到web-server-nginx作为新的主机名。

命名约定(Name Convention)

用户标签和系统标签最多都只能有2048个字符。
  • 对于用户标签,没有强制的命名约定,但推荐使用可读的有意义的字符串。
  • 对于系统标签,和ZStack Cloud中服务和插件定义的一样, 他们使用::作为分隔符。

资源类型(Resource Type)

创建一个标签时, 用户必须指定标签所关联的资源类型。

资源类型示例见下表:
资源类型
AccessControlListVO
AccessControlRuleVO
AccessKeyVO
AccountVO
ActiveAlarmVO
AddingNewInstanceRuleVO
AddressPoolVO
AffinityGroupVO
AlarmVO
AlertVO
AliyunDiskVO
AliyunEbsBackupStorageVO
AliyunEbsPrimaryStorageVO
AliyunNasAccessGroupVO
AliyunNasAccessRuleVO
AliyunNasFileSystemVO
AliyunNasMountTargetVO
AliyunPanguPartitionVO
AliyunProxyVpcVO
AliyunProxyVSwitchVO
AliyunRouterInterfaceVO
AliyunSmsSNSTextTemplateVO
AliyunSnapshotVO
AppBuildSystemVO
ApplianceVmVO
AutoScalingGroupActivityVO
AutoScalingGroupInstanceVO
AutoScalingGroupVO
AutoScalingRuleAlarmTriggerVO
AutoScalingRuleSchedulerJobTriggerVO
AutoScalingRuleTimedTaskTriggerVO
AutoScalingRuleTriggerVO
AutoScalingRuleVO
AutoScalingTemplateVO
AutoScalingVmTemplateVO
BackupStorageVO
BaremetalBondingVO
BaremetalChassisVO
BaremetalHardwareInfoVO
BaremetalInstanceVO
BaremetalNicVO
BaremetalPxeServerVO
BaremetalVlanNicVO
BareMetal2ChassisVO
BareMetal2ChassisNicVO
BareMetal2ChassisDiskVO
BareMetal2ChassisOfferingVO
BareMetal2InstanceVO
BareMetal2GatewayVO
BareMetal2ProvisionNetworkVO
BillingResourceLabelVO
BillingVO
BuildApplicationVO
CaptchaVO
CephBackupStorageMonVO
CephBackupStorageVO
CephPrimaryStorageMonVO
CephPrimaryStoragePoolVO
CephPrimaryStorageVO
CertificateVO
ClusterDRSVO
ClusterVO
ConnectionAccessPointVO
ConsoleProxyVO
DahoCloudConnectionVO
DahoConnectionVO
DahoVllsVO
DatabaseBackupVO
DataCenterVO
DiskOfferingVO
EcsImageVO
EcsInstanceVO
EcsSecurityGroupRuleVO
EcsSecurityGroupVO
EcsVpcVO
EcsVSwitchVO
EipVO
EmailMediaVO
EmailTriggerActionVO
ESXHostVO
EventRuleTemplateVO
EventSubscriptionVO
ExternalBackupVO
FaultToleranceVmGroupVO
FiberChannelLunVO
FiberChannelStorageVO
FlowCollectorVO
FlowMeterVO
GarbageCollectorVO
GuestOsCategoryVO
GuestToolsVO
HardwareL2VxlanNetworkPoolVO
HostNetworkBondingVO
HostNetworkInterfaceVO
HostVO
HybridAccountVO
HybridEipAddressVO
IAM2OrganizationVO
IAM2ProjectRoleVO
IAM2ProjectTemplateVO
IAM2ProjectVO
IAM2TicketFlowCollectionVO
IAM2TicketFlowVO
IAM2VirtualIDGroupVO
IAM2VirtualIDVO
IdentityZoneVO
ImageReplicationGroupVO
ImageStoreBackupStorageVO
ImageVO
ImagePackageVO
InstanceOfferingVO
IpRangeVO
IPsecConnectionVO
IscsiLunVO
IscsiServerVO
IscsiTargetVO
KVMHostVO
L2NetworkVO
L2VlanNetworkVO
L3NetworkVO
LdapServerVO
LoadBalancerListenerVO
LoadBalancerServerGroupVO
LoadBalancerVO
LoginAttemptsVO
LongJobVO
MdevDeviceSpecVO
MdevDeviceVO
MediaVO
MetricRuleTemplateVO
MiniStorageResourceReplicationVO
MiniStorageVO
MonitorGroupAlarmVO
MonitorGroupEventSubscriptionVO
MonitorGroupInstanceVO
MonitorGroupVO
MonitorTemplateVO
MonitorTriggerActionVO
MonitorTriggerVO
MulticastRouterVO
MultipathDeviceVO
MultiPathGroupVO
MultiPathVO
NasFileSystemVO
NasMountTargetVO
NormalIpRangeVO
OssBucketVO
PciDeviceOfferingVO
PciDeviceSpecVO
PciDeviceVO
PolicyRouteRuleSetVO
PolicyRouteRuleVO
PolicyRouteTableRouteEntryVO
PolicyRouteTableVO
PolicyVO
PortForwardingRuleVO
PortMirrorSessionVO
PortMirrorVO
PreconfigurationTemplateVO
PriceTableVO
PrimaryStorageVO
PublishAppVO
QuotaVO
RaidControllerVO
RaidPhysicalDriveVO
RemovalInstanceRuleVO
ResourceStackVO
RoleVO
RouterAreaVO
SchedulerJobGroupVO
SchedulerJobVO
SchedulerTriggerVO
SchedulerVO
ScsiLunVO
SdnControllerVO
SecurityGroupRuleVO
SecurityGroupVO
SftpBackupStorageVO
SharedBlockGroupVO
SharedBlockVO
SharedBlockCapacityVO
SimulatorHostVO
SNSApplicationEndpointVO
SNSApplicationPlatformVO
SNSDingTalkAtPersonVO
SNSDingTalkEndpointVO
SNSEmailAddressVO
SNSEmailEndpointVO
SNSEmailPlatformVO
SNSHttpEndpointVO
SNSMicrosoftTeamsEndpointVO
SNSSmsEndpointVO
SNSSmsReceiverVO
SNSTextTemplateVO
SNSTopicVO
StackTemplateVO
SystemRoleVO
TagPatternVO
ThirdpartyPlatformVO
TicketFlowCollectionVO
TicketFlowVO
TicketStatusHistoryVO
TicketTypeVO
TicketVO
TwoFactorAuthenticationSecretVO
UsbDeviceVO
UserGroupVO
UserVO
V2VConversionHostVO
VCenterBackupStorageVO
VCenterClusterVO
VCenterDatacenterVO
VCenterPrimaryStorageVO
VCenterResourcePoolVO
VCenterVO
VipVO
VirtualBorderRouterVO
VirtualRouterOfferingVO
VirtualRouterVmVO
VmCdRomVO
VmInstanceVO
VmNicVO
VmPriorityConfigVO
VmVdpaNicVO
VmVfNicVO
VniRangeVO
VolumeBackupVO
VolumeSnapshotGroupVO
VolumeSnapshotTreeVO
VolumeSnapshotVO
VolumeVO
VpcFirewallIpSetTemplateVO
VpcFirewallRuleSetVO
VpcFirewallRuleTemplateVO
VpcFirewallRuleVO
VpcFirewallVO
VpcHaGroupVO
VpcRouterVmVO
VpcUserVpnGatewayVO
VpcVirtualRouteEntryVO
VpcVirtualRouterVO
VpcVpnConnectionVO
VpcVpnGatewayVO
VpcVpnIkeConfigVO
VpcVpnIpSecConfigVO
VRouterRouteEntryVO
VRouterRouteTableVO
VtepVO
VxlanClusterMappingVO
VxlanHostMappingVO
VxlanNetworkPoolVO
VxlanNetworkVO
XDragonHostVO
ZBoxBackupVO
ZBoxVO
ZoneVO

在每个资源的对应Tags章节中, 我们有解释需用什么资源类型来创建对应的标签。


清单

系统标签清单(SystemTag inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见资源结构 0.6
createDate 请参见资源结构 0.6
lastOpDate 请参见资源结构 0.6
resourceUuid 资源uuid 0.6
resourceType 资源类型 0.6
tag 标签字符串 0.6
type 保留域 0.6
groupBy 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type 1.9
systemTags 系统标签, 请参见 创建系统标签(CreateSystemTag) 0.6
userTags 用户标签, 请参见 创建用户标签(CreateUserTag) 0.6

资源标签清单(Tag inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见资源结构 3.2.0
createDate 请参见资源结构 3.2.0
lastOpDate 请参见资源结构 3.2.0
value 3.2.0
description 资源的详细描述 3.2.0
color 3.2.0
type 保留域 3.2.0
groupBy 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type 3.2.0
systemTags 系统标签, 请参见 创建系统标签(CreateSystemTag) 3.2.0
userTags 用户标签, 请参见 创建用户标签(CreateUserTag) 3.2.0
示例
{   "inventories": [     {       "uuid": "f7ac675964d0386b89d8df713f68aee0",       "name": "SSD",       "value": "SSD",       "description": "SSD volume",       "color": "#FFFFFF",       "type": "simple",       "createDate": "Nov 14, 2017 10:20:57 PM",       "lastOpDate": "Nov 14, 2017 10:20:57 PM"     }   ] }

用户标签清单(UserTag inventory)

名字 描述 可选的 可选的参数值 起始支持版本
uuid 请参见资源结构 0.6
createDate 请参见资源结构 0.6
lastOpDate 请参见资源结构 0.6
resourceUuid 用户指定的资源UUID,若指定,系统不会为该资源随机分配UUID 0.6
resourceType 当创建一个标签时, 用户必须指定标签所关联的资源类型(resource type) 0.6
tag 标签字符串 0.6
type 保留域, 请不要使用它 0.6
groupBy 以字段分组,相当于MySQL中的group by关键字。例如groupBy=type 0.6
systemTags 系统标签, 请参见 创建系统标签(CreateSystemTag) 0.6
userTags 用户标签, 请参见 创建用户标签(CreateUserTag) 0.6
示例
{   "inventories": [     {       "uuid": "ae4f2dd05a513e1e8d350d448c2071a9",       "resourceType": "DiskOfferingVO",       "tag": "for-large-DB",       "type": "User",       "createDate": "Nov 14, 2017 10:20:57 PM",       "lastOpDate": "Nov 14, 2017 10:20:57 PM"     }   ] }











历史版本

学习路径

ZStack Cloud 产品学习路径

快速梳理文档,点击相应文本链接,快速跳转到相应文档的页面,学习 ZStack Cloud 产品。

我知道了

升级提醒

若您选择升级至4.0.0及之后版本,请注意以下功能调整:

1. 云路由器全面升级为VPC路由器,云路由网络全面升级为VPC网络,不再单独设云路由器页面。升级全程无感知,相关业务不受任何影响。

2. 企业管理账号体系取代用户组与用户,不再单独设用户/用户组页面,不可再使用用户/用户组账号登录云平台。升级前,请先将“用户组与用户”纳管的账号数据妥善迁移至“企业管理”纳管,再执行升级操作。注意:对于admin创建并具备admin权限的用户账号同步取消,如有需要,可使用企业管理账号体系中的平台管理员实现相同功能。

3. 调整AD/LDAP与账户的对接管理方式,统一由企业管理纳管,不再单独设AD/LDAP页面。升级前,请先将“账户”对接纳管的AD/LDAP账号数据妥善迁移至“企业管理”纳管,再执行升级操作。

如对上述升级提醒有任何疑问或需要升级帮助,请联系ZStack官方技术支持

下载ZStack企业版

您已填写过基本信息?点击这里

姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

下载链接将会通过邮件形式发送至您的邮箱,请谨慎填写。

同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

下载ZStack企业版

还未填写过基本信息?点击这里

邮箱或手机号码格式错误
同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

验证手机号
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

登录观看培训视频
仅对注册用户开放,请 登录 观看培训视频

业务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

其他(漏洞提交、投诉举报等)

400-962-2212 转 3
ZStack认证培训咨询
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

业务咨询:

400-962-2212 转 1

ZStack学院:

training@zstack.io
申请ZStack多机版
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

业务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

其他(漏洞提交、投诉举报等)

400-962-2212 转 3
立即咨询
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

业务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

其他(漏洞提交、投诉举报等)

400-962-2212 转 3
培训认证合作伙伴申请
姓名应该不少于2个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
邮箱格式错误
城市名称不应该少于2个字符
公司名称不应该少于4个字符
职位名称不应该少于2个字符

同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

业务咨询:

400-962-2212 转 1

商务联系:

channel@zstack.io
ZStack&工信人才联合证书申请
已获得ZStack原厂证书
未获得ZStack原厂证书
请填写您的基本信息
姓名应该不少于2个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
邮箱格式错误
城市名称不应该少于2个字符
公司/学校名称不应该少于4个字符
证书类型
ZCCT
ZCCE
ZCCA
ZCPC-ISP
申请ZStack&工信人才联合证书须支付工本费,是否可以接受
同意 不同意

我已阅读并同意云轴科技 《法律声明》《隐私政策》用户管理规则及公约

业务咨询:

400-962-2212 转 1

商务联系:

channel@zstack.io

下载链接已发送至您的邮箱。

如未收到,请查看您的垃圾邮件、订阅邮件、广告邮件。 当您收到电子邮件后,请点击 URL 链接,以完成下载。

下载链接已发送至您的邮箱。

如未收到,请查看您的垃圾邮件、订阅邮件、广告邮件。
或点击下方URL链接 (IE内核浏览器请右键另存为), 完成下载:

感谢您使用 ZStack 产品和服务。

成功提交申请。

我们将安排工作人员尽快与您取得联系。

感谢您使用 ZStack 产品和服务。

信息提交成功。

我们将安排工作人员尽快与您取得联系,请保持电话畅通。

感谢您使用 ZStack 产品和服务。

预约沟通

联系我们

业务咨询
400-962-2212 转 1
售后咨询
400-962-2212 转 2
其他业务(漏洞提交、投诉举报等)
400-962-2212 转 3

联系我们

回到顶部

产品试用申请
请选择您要试用的产品
ZStack Cloud 企业版
ZStack Cloud 混合云版
ZStack Cloud 基础版
ZStack Cloud 标准版
请填写您的基本信息
姓名应该不少于两个字符
手机号格式错误
验证码填写错误 获取短信验证码 60 秒后可重发
公司名称不应该少于4个字符
邮箱格式错误

商务咨询:

400-962-2212 转 1

售后咨询:

400-962-2212 转 2

商务联系:

sales@zstack.io

成功提交申请。

我们将安排工作人员尽快与您取得联系。

感谢您使用 ZStack 产品和服务。