全部产品
Search
文档中心

云备份:GetTrialInfo - 获取试用信息

更新时间:Sep 03, 2026

查询指定OSS Bucket或NAS文件系统的免费试用信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

SourceType

string

是

数据源类型。仅支持查询 OSS 备份和 NAS 备份的免费试用信息。

枚举值:

  • NAS :

    备份阿里云 NAS

  • OSS :

    备份阿里云 OSS

OSS

Bucket

string

否

仅当 SourceType 取值为 OSS 时,需要配置该参数。表示 OSS bucket 名称。

hbr-backup-oss

FileSystemId

string

否

仅当 SourceType 取值为 NAS 时,需要配置该参数。表示文件系统 ID。

005494

CreateTime

integer

否

仅当 SourceType 取值为 NAS 时,需要配置该参数。表示文件系统创建时间。UNIX 时间,单位为秒。

1607436917

返回参数

名称

类型

描述

示例值

object

Code

string

返回码,200 表示成功。

200

Message

string

返回信息描述,成功一般返回 successful,错误时会返回相应错误信息。

successful

RequestId

string

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Success

boolean

请求是否成功。

  • true:成功。

  • false:失败。

TrialInfo

object

免费试用属性。仅当该数据源存在免费试用记录时返回。

TrialExpireTime

integer

免费试用过期时间。Unix 时间戳,单位为秒。

1584597600

TrialStartTime

integer

免费试用开始时间。Unix 时间戳,单位为秒。

1579413159

TrialVaultReleaseTime

integer

免费试用仓库释放时间。Unix 时间戳,单位为秒。

1594965600

KeepAfterTrialExpiration

boolean

免费试用结束后是否转为按量付费。

TrialVaultQuota

integer

剩余可创建的免费试用备份库数量。免费试用未到期且尚未创建免费试用备份库时返回 1,否则返回 0。

1

TrialBackupPlanQuota

integer

剩余可创建的免费试用备份计划数量。免费试用未到期且尚未创建免费试用备份计划时返回 1,否则返回 0。

1

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Success": true,
  "TrialInfo": {
    "TrialExpireTime": 1584597600,
    "TrialStartTime": 1579413159,
    "TrialVaultReleaseTime": 1594965600,
    "KeepAfterTrialExpiration": true,
    "TrialVaultQuota": 1,
    "TrialBackupPlanQuota": 1
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。