All Products
Search
Document Center

DataWorks:ListMeasureData

Last Updated:Jan 08, 2026

Queries the statistics on the number of phone call-based alerts or text message-based alerts reported within the tenant to which your account belongs during the previous 30 days.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DomainCodestringYes

The measurement item. Valid values:

  • DideAlarmPhone: phone call-based alerts
  • DideAlarmSms: text message-based alerts
DideAlarmPhone
ComponentCodestringYes

The metering component. Valid values:

  • Count: The number of DideAlarmPhone (telephone/call) alerts, and the number of DideAlarmSms (SMS/text message) alerts.
Count
StartTimelongYes

The start timestamp of the metering cycle, in milliseconds. The metering data is aggregated by day. The time range between EndTime and StartTime cannot exceed 30 days.

1717344000000
EndTimelongYes

The end timestamp of the metering cycle, in milliseconds. The metering data is aggregated by day. The time range between EndTime and StartTime cannot exceed 30 days.

1717430400000

Response parameters

ParameterTypeDescriptionExample
object

The returned result.

RequestIdstring

The request ID.

1AFAE64E-D1BE-432B-A9****
MeasureDatasarray<object>

The metering results.

MeasureDataobject
DomainCodestring

The item that is measured.

DideAlarmPhone
ComponentCodestring

The measurement component.

Count
StartTimelong

The start timestamp of the metering cycle, in milliseconds.

1717344000000
EndTimelong

The end timestamp of the metering cycle, in milliseconds.

1717430400000
Usagelong

The total quantity used within the measurement period.

10
Successboolean

Indicates whether the request was successful. Valid values:

  • true
  • false
true
ErrorCodestring

The error code.

100001001
ErrorMessagestring

The error message.

The user is not in tenant.
HttpStatusCodeinteger

The HTTP status code.

200

Examples

Sample success responses

JSONformat

{
  "RequestId": "1AFAE64E-D1BE-432B-A9****",
  "MeasureDatas": [
    {
      "DomainCode": "DideAlarmPhone",
      "ComponentCode": "Count",
      "StartTime": 1717344000000,
      "EndTime": 1717430400000,
      "Usage": 10
    }
  ],
  "Success": true,
  "ErrorCode": 100001001,
  "ErrorMessage": "The user is not in tenant.",
  "HttpStatusCode": 200
}

Error codes

HTTP status codeError codeError messageDescription
403Invalid.Tenant.UserNotInTenantThe user is not in tenant.The user is not in tenant.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history