查询资源包、预留实例劵、预留存储容量包的信息

注意事项

1. 最多支持查询失效时间在18个月内的数据，超过不会返回数据。
2. MaxResults 数据查询每页不超过 20。
3. 查询QPS限制 为10QPS 超过会报错。

请求说明

1. 数据按照资源实例创建时间降序排序。
2. NextToken 首次查询传 "" , 后续如果仍有数据将返回下一页起始ID 用于下次查询。
3. 列表返回为空时表示后续无数据。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例 1

POST /?Action=ListResourcePackages&Version=2022-01-01 HTTP/1.1
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240820T092339Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240820/cn-beijing/billing/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "ResourceType": "Package",
  "MaxResults": "20",
  "NextToken": ""
}

返回示例 1

{
  "ResponseMetadata": {
    "RequestId": "20240823183418140163168173B94778",
    "Action": "ListResourcePackages",
    "Version": "2022-01-01",
    "Service": "billing",
    "Region": "cn-beijing"
  },
  "Result": {
    "List": [
      {
        "OwnerID": "2100000001",
        "UserName": "user",
        "PackageType": "Periodic",
        "InstanceNo": "Instance7365828935959969836",
        "InstanceName": "资源包实例1",
        "Product": "CDN",
        "ProductName": "内容分发网络",
        "TotalAmount": "500",
        "AvailableAmount": "499",
        "Unit": "GB",
        "EffectiveTime": "2022-02-02T12:00:00Z",
        "ExpiryTime": "2025-02-02T12:00:00Z",
        "BillTime": "2022-02-02T12:00:00Z",
        "Status": "Effective",
        "ConfigurationCode": "CDN_mainland_500GB_1m_package",
        "ConfigurationName": "国内CDN-500GB-1月有效期",
        "Specification": "500",
        "SpecificationUnit": "GB",
        "RegionCode": "cn-beijing",
        "ZoneCode": "cn-beijing-a",
        "SpecCalculateFactor": "1",
        "ResetPeriod": "monthly",
        "ResetByNaturalMonth": "true",
        "SubjectNo": "北京火山引擎科技有限公司"
      }
    ],
    "NextToken": "100"
  }
}

请求示例 2

POST /?Action=ListResourcePackages&Version=2022-01-01 HTTP/1.1
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240819T145836Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240819/cn-beijing/billing/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "ResourceType": "RI",
  "MaxResults": "30"
}

返回示例 2

{
    "ResponseMetadata": {
        "RequestId": "20240819225334C267EB2C212C378733A4",
        "Action": "ListResourcePackages",
        "Version": "20220101",
        "Service": "billing",
        "Region": "cn-beijing",
        "Error": {
            "Code": "InvalidParam",
            "Message": "The parameter MaxResults is invalid."
        }
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。