查询资源包、预留实例劵、预留存储容量包的抵扣明细

注意事项

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

请求说明

1. 数据按照抵扣时间降序排序。
2. NextToken 首次查询传 "" , 后续如果仍有数据将返回下一页起始ID 用于下次查询。
3. 后续列表无数据返回时，表示本次请求结束。

请求参数

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

返回参数

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

请求示例 1

POST /?Action=ListPackageUsageDetails&Version=2022-01-01 HTTP/1.1
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240820T093909Z
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",
  "DeductBeginTime": "2022-02-02T12:00:00Z",
  "DeductEndTime": "2025-02-02T12:00:00Z",
  "MaxResults": "50",
  "NextToken": ""
}

返回示例 1

{
  "ResponseMetadata": {
    "RequestId": "2024082318562600110203118586F1BE",
    "Action": "ListPackageUsageDetails",
    "Version": "2022-01-01",
    "Service": "billing",
    "Region": "cn-beijing"
  },
  "Result": {
    "List": [
      {
        "OwnerID": "2100000001",
        "UserName": "user",
        "Product": "dcdn",
        "ProductName": "全站加速",
        "ConfigurationName": "流量包-1TB",
        "ConfigurationCode": "traffic_package-1TB",
        "InstanceNo": "Package7388090431495520300",
        "InstanceName": "资源包实例1",
        "Specification": "5",
        "SpecificationUnit": "GB",
        "RegionCode": "cn-beijing",
        "ZoneCode": "cn-beijing-a",
        "PackageType": "Periodic",
        "BeforeAmount": "5",
        "DeductionAmount": "1",
        "AfterAmount": "4",
        "Unit": "GB",
        "BeginTime": "2024-07-05T19:00:00Z",
        "EndTime": "2024-07-05T20:00:00Z",
        "DeductionTime": "2024-07-05T18:21:15Z",
        "DeductionInstanceNo": "Instance7388090304050184236",
        "DeductionUseAmount": "1",
        "DeductionInstanceUnit": "GB",
        "DeductionSpecification": "100",
        "DeductionSpecificationUnit": "GB",
        "DeductionRatio": "1",
        "DeductionProduct": "CDN",
        "DeductionAccountID": "2100000001",
        "DeductionUserName": "user",
        "DeductionCalculateFactor": "2",
        "DeductBillingFactor": "类型-ESSD_PL0",
        "DeductionElementCode": "流量",
        "DeductionRegionCode": "cn-beijing",
        "SubjectNo": "北京火山引擎科技有限公司"
      }
    ],
    "NextToken": "1200"
  }
}

请求示例 2

POST /?Action=ListPackageUsageDetails&Version=2022-01-01 HTTP/1.1
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240820T062524Z
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",
  "DeductBeginTime": "2020-02-02T12:00:00Z",
  "DeductEndTime": "2020-02-02T12:00:00Z",
  "MaxResults": "-",
  "NextToken": "778878160197"
}

返回示例 2

{
    "ResponseMetadata": {
        "RequestId": "202408201427286BF9482AA0871B6A5DD9",
        "Action": "ListPackageUsageDetails",
        "Version": "20220101",
        "Service": "billing",
        "Error": {
            "Code": "InternalError",
            "Message": "Service has some internal Error. Pls Contact With Admin."
        }
    }
}

错误码

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