All Products
Search
Document Center

Application Real-Time Monitoring Service:QueryCommercialUsage

Last Updated:Jun 12, 2026

Mengkueri data volume tulis. Operasi ini mendukung data penggunaan untuk empat produk: Application Monitoring, Managed Service for OpenTelemetry, Managed Service for Prometheus, dan Real User Monitoring.

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

IntervalInSec

integer

No

Interval waktu dari slice data, dalam detik. Nilai minimum: 3600.

Valid values:

  • 3600 :

    jam.

  • 86400 :

    hari.

3600

StartTime

integer

Yes

Stempel waktu untuk waktu mulai, dalam milidetik.

1699200000000

EndTime

integer

Yes

Stempel waktu untuk waktu berakhir, dalam milidetik.

1699286400000

OrderBy

string

No

Bidang pengurutan. Anda dapat mengatur parameter ini ke dimensi apa pun.

Valid values:

  • dataType :

    dataType

dataType

Metric

string

Yes

Nama metrik. Atur nilai ke USAGEFEE.STAT.

Valid values:

  • USAGEFEE.STAT :

    USAGEFEE.STAT

USAGEFEE.STAT

Order

string

No

Urutan pengurutan. Nilai yang valid:

  • ASC: urutan menaik.

  • DESC: urutan menurun.

ASC

AdvancedFilters

array<object>

No

Array dari kondisi filter.

object

No

Key

string

No

Kunci dari kondisi filter.

regionId

Value

string

No

Nilai dari kondisi filter.

cn-hangzhou

OpType

string

No

Operator. Saat ini, hanya equals dan in yang didukung.

Valid values:

  • in :

    in

  • eq :

    eq

eq

Dimensions

array

No

Dimensi dari metrik.

  • dataType: tipe data.

  • productType: tipe produk.

  • instanceId: ID instance.

  • instanceName: nama instance.

  • instanceType: tipe instance.

string

No

Dimensi dari metrik.

dataType

Measures

array

No

Data pengukuran dari metrik.

string

No

Data pengukuran dari metrik. Saat ini, hanya byte_sum yang didukung.

Valid values:

  • byte_sum :

    byte_sum

byte_sum

QueryType

string

Yes

Tipe pengembalian dari data yang dikueri.

  • instantQuery: data non-deret waktu.

  • timeSeriesQuery: data deret waktu.

Valid values:

  • timeSeriesQuery :

    timeSeriesQuery

  • instantQuery :

    instantQuery

instantQuery

Elemen respons

Element

Type

Description

Example

object

Code

integer

Kode status. Nilai yang valid: 2XX: berhasil. 3XX: pengalihan. 4XX: kesalahan permintaan. 5XX: kesalahan server.

200

HttpStatusCode

integer

Kode status HTTP.

200

Message

string

Pesan yang dikembalikan ketika panggilan gagal.

success

RequestId

string

ID permintaan.

99A663CB-8D7B-4B0D-A006-03C8EE38E7BB

Success

boolean

Menunjukkan apakah kueri berhasil.

  • true: Berhasil.

  • false: Gagal.

true

Data

object

Struktur respons.

Complete

boolean

Menunjukkan apakah eksekusi keseluruhan selesai ketika kueri multi-region terlibat.

  • true: Selesai.

  • false: Tidak selesai.

true

Items

array<object>

Daftar struktur data dalam respons.

object

Item data.

{ "date": "1697108400", "dataType": "metrics", "byte_sum": 9497922 }

Contoh

Respons sukses

JSONformat

{
  "Code": 200,
  "HttpStatusCode": 200,
  "Message": "success",
  "RequestId": "99A663CB-8D7B-4B0D-A006-03C8EE38E7BB",
  "Success": true,
  "Data": {
    "Complete": true,
    "Items": [
      {
        "date": "1697108400",
        "dataType": "metrics",
        "byte_sum": 9497922
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 ParameterMetricIllegal The specified metric is invalid.
400 ParameterMeasuresIllegal The specified Measures is invalid.
400 ParameterTimeStampIllegal The specified timeStamp is invalid.
400 ParameterOrderIllegal The specified order is invalid.
400 ParameterPageSizeIllegal The specified PageSize is invalid.
400 ParameterIntervalIllegal The specified interval is invalid.
400 ParameterMeasuresMissing You must specify measures.
400 ParameterDimensionsIllegal The specified dimensions is invalid.
400 ParameterRegionIdIllegal The specified RegionId is invalid.
400 InternalError Internal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.
403 APINotAuthorize The current user is not authorized to access the interface.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.