ListPurchaseInfo - 套餐包列表--多云安全平台-火山引擎

文档中心

立即注册

导航

ListPurchaseInfo - 套餐包列表

最近更新时间：2025.05.30 11:56:21首次发布时间：2025.05.22 11:11:36

接口概述

功能：查询套餐包列表信息
HTTP 方法：POST

请求参数

Query 参数

参数名称	类型	是否必选	示例值	描述
Action	String	是	PostApiV1AssetSearchResultList	公共参数，本接口值：ListPurchaseInfo。
Version	String	是	2023-05-01	公共参数，本接口值：2024-12-01。

Body 参数

参数名称	类型	是否必选	示例值	描述
PageSize	Int	是	10	页面条数
CurrPage	int	是	1	当前页码
PaymentMode	String	是	prepaid	固定值：prepaid

响应参数

参数名称	类型	示例值	描述
Result	Object of ListPurchaseInfoResult	--	响应结果

ListPurchaseInfoResult

参数名称	类型	示例值	描述
Spec	String	1000次	套餐规格
PurchaseNum	int64	1	个数
TotalCnt	int64	1000	总量
RemainCnt	int64	100	剩余量，时效性：T-1
Status	String	Running	状态，Running: 运行中，Expired: 已过期，Terminated: 已退订
PurchaseTimeSec	int64	1745216487	购买时间，时间戳(s)
ExpireTimeSec	int64	1753113599	过期时间，时间戳(s)

请求示例

curl --location --request POST 'https://mcs.cn-beijing.volcengineapi.com/api/v1/trade/list_purchase_info?Version=2024-12-01&Action=ListPurchaseInfo' \
--header 'X-Date: 20250221T081658Z' \
--header 'Host: mcs.cn-beijing.volcengineapi.com' \
--header 'Authorization: HMAC-SHA256 Credential=AKLTxxxxxxxx/20250221/cn-beijing/mcs/request, SignedHeaders=host;x-date, Signature=xxxxxxxxxxxxxxxx' \
--header 'Connection: keep-alive'
--data '{"PaymentMode":"prepaid","PageSize":10,"CurrPage":1}'

返回示例

{
    "ResponseMetadata": {
        "RequestID": "20250521165224295759A558B1A46B5BDF",
        "Action": "",
        "Version": "",
        "Service": "mcs",
        "Region": "cn-beijing"
    },
    "PageInfo": {
        "CurrentPage": 1,
        "PageSize": 10,
        "Count": 1,
        "TotalCount": 1
    },
    "Result": [
        {
            "Spec": "10000",
            "PurchaseNum": 1,
            "TotalCnt": 10000,
            "RemainCnt": 0,
            "PurchaseTimeSec": 1745217513,
            "ExpireTimeSec": 1747843199,
            "Status": "Running",
            "TradeInstanceID": "Mul_cloud_Pay_as_Authentication0000000000000000001",
            "PaymentMode": "prepaid"
        }
    ]
}