云数据库 MySQL 版
云数据库 MySQL 版
云数据库 MySQL 版
文档指南
请输入
产品动态
内核功能
功能
用户指南
实例管理
连接管理
管理连接终端
备份恢复
服务可用性
日志管理
数据安全管理
参数管理
跨地域备份管理
API 参考
V2（2022-01-01）
实例管理
连接管理
账号管理
数据库管理
安全加密
备份与恢复
参数管理
资源包管理
附录
开发者工具
最佳实践
相关协议
- 文档首页
云数据库 MySQL 版API 参考V2（2022-01-01）资源包管理ListResourcePackages - 查询资源包列表
复制全文
下载 pdfListResourcePackages - 查询资源包列表
文档反馈
问问助手调用 ListResourcePackages 接口查询资源包列表。
请求类型
同步请求。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
EffectiveTime | 否 | { "EndTime":"2025-08-20T08:00:00.000Z", "StartTime":"2025-08-20T08:00:00.000Z" } | 通过资源包的生效时间段查询。 | |
ExpirationTime | 否 | { "EndTime":"2029-08-20T08:00:00.000Z", "StartTime":"2026-08-20T08:00:00.000Z" } | 通过资源包的到期时间段查询。 | |
PackageStatus | String | 否 | NotEffective | 资源包的状态。取值：
|
PackageType | String | 否 | StoragePackage | 资源包的类型。当前仅支持取值为 StoragePackage，即存储包。 |
PackageSpec | String | 否 | 100 | 资源包规格。如 PackageType 取值为 StoragePackage，则 PackageSpec 的取值范围为：
|
PurchaseDuration | Integer | 否 | 1 | 资源包的购买时长。 |
PageNumber | Integer | 否 | 1 | 当前页页码。取值最小为 1。默认值为 1。 |
PageSize | Integer | 否 | 20 | 每页记录数。最小值为 1，最大值不超过 100。默认值为 10。 |
OrderType | String | 否 | asc | 查询结果的排序方式。取值：
|
OrderBy | String | 否 | ExpirationTime | 用于排序的字段。取值：
|
TimeFilter
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
EndTime | String | 否 | 2027-08-20T08:00:00.000Z | 指定资源包的到期时间段进行查询时，时间段的终点（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
StartTime | String | 否 | 2026-08-19T08:00:00.000Z | 指定资源包的到期时间段进行查询时，时间段的起点（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
返回参数
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
Total | Integer | 21 | 符合查询条件的结果数量。 |
ResourcePackages | 请参见返回示例。 | 资源包的详细信息。 |
ResourcePackage
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
CreateTime | String | 2025-08-26T06:51:19.000Z | 资源包的创建时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
EffectiveTime | String | 2025-09-30T14:00:00.000Z | 资源包的生效时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
ExpirationTime | String | 2025-10-30T15:59:59.000Z | 资源包的过期时间（UTC 时间）。格式为 yyyy-MM-ddTHH:mm:ss.sssZ。 |
PackageId | String | rds-pkg-210000****-ec95 | 资源包的 ID。 |
PackageSpec | String | 100 | 资源包的规格。 |
PackageStatus | String | NotEffective | 资源包的状态。取值：
|
PackageType | String | StoragePackage | 资源包的类型。当前仅支持取值为 StoragePackage，即存储包。 |
PurchaseDuration | Integer | 1 | 资源包的购买时长。单位为月。 |
Region | String | cn-beijign | 资源包所属的地域。 |
示例
请求示例
POST /?Action=ListResourcePackages&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
"ExpirationTime": {
"EndTime": "2029-08-20T08:00:00.000Z",
"StartTime": "2026-08-20T08:00:00.000Z"
}
}
返回示例
{
"ResponseMetadata": {
"RequestId": "20250922223137889D767ED5A0B1FEB66D-35b4e1",
"Action": "ListResourcePackages",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-beijing"
},
"Result": {
"ResourcePackages": [
{
"CreateTime": "2025-08-19T08:22:15.000Z",
"EffectiveTime": "2025-08-20T08:00:00.000Z",
"ExpirationTime": "2028-08-20T15:59:59.000Z",
"PackageId": "rds-pkg-210000****-4e1f",
"PackageSpec": "100",
"PackageStatus": "InUse",
"PackageType": "StoragePackage",
"PurchaseDuration": 36,
"Region": "cn-beijing"
},
{
"CreateTime": "2025-08-19T08:22:15.000Z",
"EffectiveTime": "2025-08-20T08:00:00.000Z",
"ExpirationTime": "2028-08-20T15:59:59.000Z",
"PackageId": "rds-pkg-210000****-24f5",
"PackageSpec": "100",
"PackageStatus": "InUse",
"PackageType": "StoragePackage",
"PurchaseDuration": 36,
"Region": "cn-beijing"
}
],
"Total": 2
}
}
错误码
最近更新时间：2026.06.10 10:58:17
这个页面对您有帮助吗？
有用
有用
无用
无用