DescribeResourcePackageDetail--云数据库 MySQL 版-火山引擎

文档中心

立即注册

导航

DescribeResourcePackageDetail

最近更新时间：2025.12.08 14:51:13首次发布时间：2025.12.08 14:51:13

调用 DescribeResourcePackageDetail 接口查询资源包的详细使用信息。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
PackageId	String	是	rds-pkg-210000****-4e1f	资源包的 ID。
QueryStartTime	String	是	2025-09-21T16:00:00Z	指定时间段的开始时间（UTC 时间）。格式为 `yyyy-MM-ddTHH:mm:ssZ`。
QueryEndTime	String	是	2025-09-28T15:59:59Z	指定时间段的结束时间（UTC 时间）。格式为 `yyyy-MM-ddTHH:mm:ssZ`。
PageNumber	Integer	否	1	当前页页码。取值最小为 1。默认值为 1。
PageSize	Integer	否	10	每页记录数。最小值为 1，最大值不超过 1000。默认值为 10。

返回参数

参数	类型	示例值	描述
ResourcePackage	Object	请参见返回示例。	资源包的详细信息。
Total	Integer	3	资源包的使用明细的数量。
UsageProgress	Integer	89	资源包的使用进度。单位为百分比。

示例

请求示例

POST /?Action=DescribeResourcePackageDetail&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****
{
    "PackageId": "rds-pkg-210000****-4e1f",
    "QueryStartTime": "2025-09-21T16:00:00Z",
    "QueryEndTime": "2025-09-28T15:59:59Z",
    "PageNumber": 1,
    "PageSize": 10
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20250923112134D0FDC5B835A79FF44B47-2f9056",
        "Action": "DescribeResourcePackageDetail",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": {
        "ResourcePackage": {
            "CreateTime": "2025-08-26T06:51:19.000Z",
            "EffectiveTime": "2025-08-26T06:00:00.000Z",
            "ExpirationTime": "2025-09-26T15:59:59.000Z",
            "PackageId": "rds-pkg-2100000746-b4e7",
            "PackageSpec": "100",
            "PackageStatus": "InUse",
            "PackageType": "StoragePackage",
            "PurchaseDuration": 1,
            "Region": "cn-beijing"
        },
        "Total": 0,
        "UsageItems": null,
        "UsageProgress": 89
    }
}

错误码

更多详情，请参见错误码。