All Products
Search
Document Center

Cloud Phone:DescribeMetricLast

Last Updated:Dec 04, 2025

Queries the latest monitoring data for an instance or a matrix. You can query metrics such as CPU, memory, disk, and network.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

MetricNames

array

Yes

The list of monitoring metrics.

string

No

The name of the metric.

Valid values:

  • disk_read_bps :

    Disk read bps

  • disk_read_iops :

    Disk read IOPS

  • cpu_utilization :

    CPU utilization

  • disk_write_iops :

    Disk write IOPS

  • disk_write_bps :

    Disk write bps

  • diskusage_utilization :

    Storage usage

  • memory_used_utilization :

    Memory usage

  • intranet_out_rate :

    Outbound bandwidth of the connection

  • process_memory :

    Process memory usage

  • intranet_in_rate :

    Inbound bandwidth of the connection

  • process_cpu :

    Process CPU utilization

cpu_utilization

AndroidInstanceIds

array

No

For instance-level monitoring, specify a list of Cloud Phone instance IDs.

string

No

For instance-level monitoring, specify the Cloud Phone instance ID.

acp-6nongia0tuev7****

Period

integer

No

The statistic period for monitoring data.

Valid values: 60, 900, and 3600.

Unit: seconds.

Valid values:

  • 15 :

    15 seconds

  • 60 :

    60 seconds

  • 900 :

    900 seconds

  • 3600 :

    3600 seconds

60

StartTime

string

No

The start time for the query.

2019-01-31 10:00:00

EndTime

string

No

The end time for the query.

2019-01-31 11:00:00

NextToken

string

No

The token that marks the start of the current read position. If you leave this parameter empty, the query starts from the beginning.

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uONHqPtDLM2U8s****

Length

string

No

The number of monitoring data records to return on each page for a paged query.

The default value is 1000. This means that 1000 monitoring data records are returned per page.

1000

InstanceIds

array

No

The list of instance IDs.

string

No

The instance ID.

Note

If you specify a bandwidth plan ID, you can query the latest bandwidth data for the bandwidth plan.

np-5hh4a31emkt6u****

Response elements

Element

Type

Description

Example

object

The data returned by the operation.

RequestId

string

The request ID.

2B9E6946-0E2A-5D2B-B275-361DF81F****

Count

integer

The number of records.

100

NextToken

string

The token for the next query. If not all results are returned in a single query, the returned NextToken is not empty. You can use the returned NextToken in the next query to query the next page.

AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****

MetricTotalModel

array<object>

The instance monitoring data.

array<object>

The instance monitoring data.

AndroidInstanceId

string

For instance-level monitoring, the Cloud Phone instance ID is returned.

acp-fkuit0cmyru4p****

MetricModelList

array<object>

The monitoring data for metrics.

array<object>

The monitoring data for the metric.

MetricName

string

The name of the metric.

cpu_utilization

DataPoints

array<object>

The monitoring data points.

object

The monitoring data point.

Timestamp

integer

The timestamp of the statistics. Unit: milliseconds.

1548777660000

Minimum

number

The minimum value. Unit: %.

Note

The unit is bps when the metric is `bandwidth_package_usage_out` or `bandwidth_package_usage_in`.

93.1

Average

number

The average value. Unit: %.

Note

The unit is bps when the metric is `bandwidth_package_usage_out` or `bandwidth_package_usage_in`.

99.52

Maximum

number

The maximum value. Unit: %.

Note

The unit is bps when the metric is `bandwidth_package_usage_out` or `bandwidth_package_usage_in`.

100

GpuId

string

The GPU ID.

cpn-1t1bxvp9az2pk****-gpu-0

ProcessLastInfos

array<object>

The process monitoring metrics.

Note

This parameter is returned when the metric is `process_cpu` or `process_memory`.

object

The process monitoring metric.

Timestamp

integer

The timestamp of the statistics. Unit: milliseconds.

1548777660000

Name

string

The process name.

com.offerup

ProcessIds

array

The list of process IDs.

integer

The process ID.

100056

MemoryUsage

number

The memory usage. Unit: %.

50

CpuUsage

number

The CPU utilization. Unit: %.

50

Examples

Success response

JSON format

{
  "RequestId": "2B9E6946-0E2A-5D2B-B275-361DF81F****",
  "Count": 100,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kU+SQXzm0H9mu/FiSc****",
  "MetricTotalModel": [
    {
      "AndroidInstanceId": "acp-fkuit0cmyru4p****",
      "MetricModelList": [
        {
          "MetricName": "cpu_utilization",
          "DataPoints": [
            {
              "Timestamp": 1548777660000,
              "Minimum": 93.1,
              "Average": 99.52,
              "Maximum": 100,
              "GpuId": "cpn-1t1bxvp9az2pk****-gpu-0"
            }
          ],
          "ProcessLastInfos": [
            {
              "Timestamp": 1548777660000,
              "Name": "com.offerup",
              "ProcessIds": [
                100056
              ],
              "MemoryUsage": 50,
              "CpuUsage": 50
            }
          ]
        }
      ]
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.