文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>云应用>API 文档>数据结构

数据结构

最近更新时间：2026-01-16 01:27:16

我的收藏

本页目录：

DisplayMetadata

元数据展示信息

被如下接口引用：VerifyLicense。

名称 类型 必选 描述
Name String 否

展示的名称


示例值：颁发机构
Value String 否

展示的值


示例值：YUNAPI 接口

Filter

描述键值对过滤器，用于条件过滤查询。例如过滤 ID、名称、状态等

  • 若存在多个 Filter 时，Filter间的关系为逻辑与（AND）关系。
  • 若同一个 Filter 存在多个 Values，同一 Filter 下 Values 间的关系为逻辑或（OR）关系。

被如下接口引用：DescribeLicense。

名称 类型 必选 描述
Name String 是 需要过滤的字段
Values Array of String 是 字段的过滤值

License

表示应用实例的软件授权，包含颁发信息、激活信息等内容。

被如下接口引用：VerifyLicense。

名称 类型 描述
LicenseId String

License ID


示例值：LICENSE_CLOUDAPP_A95275D8
LicenseMode String

软件授权模式。

枚举值说明
Permanent永久授权。该授权不受有效期限制。
Subscription订阅授权。授权如果过了有效期，则会进入过期状态。
Accept验收期授权。用于需要验收的软件处于验收期间的授权，授权如果过了验收有效期，则会进入过期状态。


示例值：Subscription
LicenseStatus String

软件的授权状态。

枚举值说明
Issued已颁发，等待激活。一般来说，如果软件已经在运行，不会出现该状态。
Active授权在有效期内，这是软件运行期间最常见的状态。
Expired授权已过期。订阅类的软件授权有有效期，如果服务器时间已晚于有效期，则会进入过期状态。
Isolated授权已隔离。有截止日期的授权，当用户授权到期时，先进入此状态，用户可以去续费，超过7天不续费则授权进入Destroyed状态。
Destroyed授权已失效/销毁。用户如果退货软件，则授权会自动失效。


示例值：Active
ProviderId Integer

软件供应方 ID。


示例值：1000
SoftwarePackageId String

软件包 ID。


示例值：pkg-kby01bv4
SoftwarePackageVersion String

软件包版本。


示例值：1.0.0
AuthorizedUserUin String

被授权的用户 UIN。


示例值：100008888888
AuthorizedCloudappId String

被授权的应用实例 ID。


示例值：cloudapp-95t785d8
AuthorizedCloudappRoleId String

被授权的角色 ID。


示例值：4000008000060000
AuthorizedSpecification Array of SaleParam

被授权的软件规格，具体字段请参考结构SaleParam
BillingMode Integer

被授权的软件的计费模式。

枚举值说明
1线上计费，软件的授权从腾讯云线上购买，支持续费、退款等操作。
2线下计费，软件的授权线下签订合同购买，定向客户交付，无法从线上续费和退款。
4免费


示例值：1
LifeSpan Integer

授权时长（单位由LifeSpanUnit确定，枚举值有Y年/M月/D日三种）


示例值：1
IssueDate Timestamp ISO8601

授权颁发时间。


示例值：2024-06-29T00:00:00+08:00
ActivationDate Timestamp ISO8601

授权激活时间，如从未激活则返回 null。


注意：此字段可能返回 null，表示取不到有效值。
示例值：2024-06-30T00:00:00+08:00
ExpirationDate Timestamp ISO8601

授权过期时间


注意：此字段可能返回 null，表示取不到有效值。
示例值：2025-06-30T00:00:00+08:00
LifeSpanUnit String

授权时长单位，枚举值有Y年/M月/D日三种


示例值：Y
LicenseType String

授权的类型：Standard正式版/Development开发版/Trial体验版


示例值：Standard
LicenseLevel String

授权的层级：Master 主授权；Child 子授权/增强型授权


示例值：Master
LicenseData LicenseData

License 内容信息
IssueURL String

License 颁发地址


示例值：http://127.0.0.1/license/issuing

LicenseData

License 内容信息

被如下接口引用：VerifyLicense。

名称 类型 必选 描述
Text String 是

License 文本内容。支持密钥、证书等文本形式，二进制的密钥需要伙伴进行 base64 转码


示例值：dszxczxc-zcx-cx--xc-zcx--
DeploymentOutput String 否

部署服务输出信息，基于部署签发 License 时需要该参数。


示例值：{"output":"deploy.data"}
Metadata Array of DisplayMetadata 否

License 前端展示信息。key、value 形式，比如可传入，颁发机构：XXXX 有限公司

SaleParam

表示商品 SKU 的单个售卖参数

被如下接口引用：VerifyLicense。

名称 类型 必选 描述
ParamKey String 是 售卖参数标识
示例值：user_scale
ParamKeyName String 是 售卖参数的展示名称
注意：此字段可能返回 null，表示取不到有效值。
示例值：用户规模
ParamId String 否 参数 Id
示例值：PARAM_BHFHICABHI3452
ParamValueId String 否 参数值 Id
示例值：PARAM_BHFHICABHI0423
ParamValue String 否 售卖参数值，当ParamType=Quant时，该值有可能为Null
注意：此字段可能返回 null，表示取不到有效值。
示例值：100
ParamValueName String 否 售卖参数值的展示名称
注意：此字段可能返回 null，表示取不到有效值。
示例值：100人
ParamType String 否 售卖参数的类型，目前支持枚举类Enum/数量类Quant
注意：此字段可能返回 null，表示取不到有效值。
示例值：Enum
ModuleId String 否 模块ID
示例值：PARAM_BHFHICABHI000
ModuleKey String 否 模块key
示例值：phone
ModuleName String 否 模块名称
示例值：手机模块
中国站
目录