全部产品
Search
文档中心

CDN:DescribeCdnUserBillHistory

更新时间:Dec 14, 2025

Menanyakan riwayat penagihan di bawah Akun Alibaba Cloud Anda.

Deskripsi operasi

  • Anda dapat menanyakan riwayat penagihan hingga satu bulan terakhir.

  • Anda dapat memanggil operasi ini hingga 100 kali per detik per akun.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

StartTime

string

Yes

Awal rentang waktu yang akan ditanyakan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

Granularitas data minimum adalah 5 menit.

2018-09-30T16:00:00Z

EndTime

string

Yes

Akhir rentang waktu yang akan ditanyakan. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

Waktu akhir harus lebih lambat daripada waktu mulai.

2018-10-31T16:00:00Z

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

ED61C6C3-8241-4187-AAA7-5157AE175CEC

BillHistoryData

object

BillHistoryDataItem

array<object>

Riwayat penagihan yang dikembalikan.

array<object>

Dimension

string

Dimensi.

flow

BillType

string

Metode pengukuran.

month_4th_day_bandwidth

BillTime

string

Awal rentang waktu yang ditanyakan.

2018-09-30T16:00:00Z

BillingData

object

BillingDataItem

array<object>

Item yang dapat ditagih.

object

Flow

number

Jumlah network traffic. Satuan: byte.

24567

Bandwidth

number

Bandwidth. Satuan: bit/s.

4041

Count

number

Jumlah permintaan.

203601

CdnRegion

string

Wilayah yang dapat ditagih. Nilai yang valid:

  • CN: Chinese mainland

  • OverSeas: outside the Chinese mainland

  • AP1: Asia Pacific 1

  • AP2: Asia Pacific 2

  • AP3: Asia Pacific 3

  • NA: North America

  • SA: South America

  • EU: Europe

  • MEAA: Middle East and Africa

AP1

ChargeType

string

Metode penagihan. Nilai yang valid:

  • StaticHttp: static HTTP requests

  • DynamicHttp: dynamic HTTP requests

  • DynamicHttps: dynamic HTTPS requests

DynamicHttp

Contoh

Respons sukses

JSONformat

{
  "RequestId": "ED61C6C3-8241-4187-AAA7-5157AE175CEC",
  "BillHistoryData": {
    "BillHistoryDataItem": [
      {
        "Dimension": "flow",
        "BillType": "month_4th_day_bandwidth",
        "BillTime": "2018-09-30T16:00:00Z",
        "BillingData": {
          "BillingDataItem": [
            {
              "Flow": 24567,
              "Bandwidth": 4041,
              "Count": 203601,
              "CdnRegion": "AP1",
              "ChargeType": "DynamicHttp"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified parameter is invalid.
400 InvalidStartTime.Malformed The specified value of parameter StartTime is malformed.
400 InvalidEndTime.Malformed The specified value of parameter EndTime is malformed.
400 InvalidTime.Malformed Specified StartTime or EndTime is malformed. The specified start or end time is invalid.
400 InvalidEndTime.Mismatch Specified EndTime does not match the specified StartTime. StartTime must be earlier than EndTime.
400 InvalidTimeSpan The time span exceeds the limit. The time span exceeds the limit. Configure a valid time span as described in API documentation.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.