All Products
Search
Document Center

Cloud Phone:DescribeMetricTop

Last Updated:Jun 10, 2026

Meminta data pemantauan terbaru untuk metrik seperti bandwidth jaringan instansi dan mengembalikan hasilnya dalam daftar terurut.

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.

Sintaks permintaan

POST  HTTP/1.1

Parameter permintaan

Parameter

Type

Required

Description

Example

MetricNames

array

Yes

Daftar metrik.

string

No

Nama metrik.

Valid values:

  • instance_out_traffic :

    Bandwidth keluar (hanya untuk jaringan standar)

  • instance_in_traffic :

    Bandwidth masuk (hanya untuk jaringan standar)

instance_in_traffic

AndroidInstanceIds

array

No

Untuk pemantauan tingkat instansi, tentukan daftar ID instansi cloud phone.

string

No

Untuk pemantauan tingkat instansi, tentukan ID instansi cloud phone.

acp-sgicbcdadjs****

Period

integer

No

Periode statistik data pemantauan. Satuan: detik.

60

StartTime

string

No

Waktu mulai kueri.

2019-01-31 10:00:00

EndTime

string

No

Waktu akhir kueri.

2019-01-31 11:00:00

NextToken

string

No

Token yang menandai awal halaman hasil berikutnya. Jika Anda mengosongkan parameter ini, kueri dimulai dari awal.

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uONHqPtDLM2U8s****

Length

string

No

Jumlah entri yang dikembalikan pada setiap halaman. Parameter ini digunakan untuk kueri berhalaman.

Catatan

Nilai maksimum adalah 100 jika metriknya adalah `instance_in_traffic` atau `instance_out_traffic`.

100

InstanceIds

array

No

Daftar ID instansi.

string

No

ID instansi.

Catatan

Tentukan ID paket bandwidth untuk mengkueri N titik data bandwidth teratas (di mana N kurang dari atau sama dengan 100) untuk paket tersebut. Data diurutkan berdasarkan bandwidth dalam urutan menurun.

np-5hh4a31emkt6u****

Elemen respons

Element

Type

Description

Example

object

Data yang dikembalikan.

RequestId

string

ID permintaan.

4610632D-D661-5982-B3D7-5D3FD183F****

Count

integer

Jumlah entri yang dikembalikan.

1

NextToken

string

Token untuk mengambil halaman hasil berikutnya. Jika hasil tidak sepenuhnya dikembalikan dalam satu kueri, parameter ini tidak kosong. Anda dapat menggunakan token ini dalam kueri berikutnya untuk mengambil halaman hasil berikutnya.

AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****

MetricTotalModel

array<object>

Data pemantauan instansi.

array<object>

Data pemantauan instansi.

AndroidInstanceId

string

Untuk pemantauan tingkat instansi, ini adalah ID instansi cloud phone.

acp-fkuit0cmyru4p****

InstanceId

string

ID instansi.

np-5hh4a31emkt6u****

MetricModelList

array<object>

Data pemantauan metrik.

array<object>

Data pemantauan metrik.

MetricName

string

The name of the metric.

instance_in_traffic

DataPoints

array<object>

The monitoring data points.

object

A monitoring data point.

Timestamp

integer

The timestamp of the data point. Unit: milliseconds.

1548777660000

Minimum

number

The minimum value.

Catatan

The unit is bps when the metric is `instance_in_traffic` or `instance_out_traffic`.

93.1

Average

number

The average value. Unit: %.

Catatan

The unit is bps when the metric is `instance_in_traffic` or `instance_out_traffic`.

99.52

Maximum

number

The maximum value. Unit: %.

Catatan

The unit is bps when the metric is `instance_in_traffic` or `instance_out_traffic`.

100

Name

string

The name.

cloudPhone-****

Id

string

The ID.

acp-fkuit0cmyru4p****

Properties

string

The properties.

Catatan

A JSON string that contains the extension properties.

{"IP":"192.168.*.***"}

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4610632D-D661-5982-B3D7-5D3FD183F****",
  "Count": 1,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
  "MetricTotalModel": [
    {
      "AndroidInstanceId": "acp-fkuit0cmyru4p****",
      "InstanceId": "np-5hh4a31emkt6u****",
      "MetricModelList": [
        {
          "MetricName": "instance_in_traffic",
          "DataPoints": [
            {
              "Timestamp": 1548777660000,
              "Minimum": 93.1,
              "Average": 99.52,
              "Maximum": 100,
              "Name": "cloudPhone-****",
              "Id": "acp-fkuit0cmyru4p****\n",
              "Properties": "{\"IP\":\"192.168.*.***\"}"
            }
          ]
        }
      ]
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.