All Products
Search
Document Center

Application Real-Time Monitoring Service:ListSyntheticDetail

Last Updated:Nov 05, 2024

Obtains the results of one or more synthetic tests.

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

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
arms:ListSyntheticDetaillist
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringNo

The ID of the region. Set the value to cn-hangzhou.

cn-hangzhou
SyntheticTypeintegerNo

The type of the synthetic test. Valid values: 1 and 2. 1 represents an immediate test, and 2 represents a scheduled test.

1
CategorystringNo

The type of the results. Set the value to SYNTHETIC.

SYNTHETIC
DetailstringNo

The type of the list that contains the results. This parameter is required. Valid values:

  • ICMP_LIST
  • TCP_LIST
  • DNS_LIST
  • HTTP_LIST
  • WEBSITE_LIST
  • DOWNLOAD_LIST
  • ALL
ICMP_LIST
FiltersobjectNo

The filter condition. This parameter is required.

  • To query the result of a synthetic monitoring task, set this parameter in the following format: {"taskId":"${taskId}"}.
  • To query the result details of a synthetic monitoring task, set this parameter in the following format: {"taskId":"${taskId}","dataId":"${dataId}"}.
stringNo

The filter condition.

{"taskId":"xxxaaabbbcccdddeeefffggg"}
AdvancedFiltersarray<object>No

An array of filter conditions. This parameter is required.

  • To query the list of synthetic test results, set this parameter in the following format: [{"Key":"taskType","OpType":"in","Value":[Task type]}].
  • To query the result details of a synthetic monitoring task, set this parameter in the following format: [{"Key":"dataId","OpType":"eq","Value":"dataId"}]. dataId is returned when you query the list of synthetic test results.
objectNo

An array of filter conditions.

KeystringNo

The filter condition. The taskType and dataId fields are supported.

  • To query the list of synthetic test results, set the key to taskType.
  • To query the result details of a synthetic monitoring task, set the key to dataId.
taskType
OpTypestringNo

The type of the filter condition. Valid values: eq and in. eq: equal to. in: include.

eq
ValueanyNo

The value of the filter condition. The type of the task. Valid values: 1: ICMP 2: TCP 3: DNS 4: HTTP 5: website speed measurement 6: file download

1
ExactFiltersarray<object>No

A reserved field.

objectNo
KeystringNo

A reserved field.

null
OpTypestringNo

A reserved field.

null
ValueanyNo

A reserved field.

null
StartTimelongNo

The timestamp of the start time of the query. Unit: milliseconds.

1684110343127
EndTimelongNo

The timestamp of the end time of the query. Unit: milliseconds.

1684480557772
OrderBystringNo

The field based on which results are sorted. Set the value to timestamp.

timestamp
OrderstringNo

The order in which results are sorted. Valid values:

  • ASC: ascending order
  • DESC: descending order
DESC
PageintegerNo

The page number. Pages start from page 1.

1
PageSizeintegerNo

The number of entries per page.

20

The query of synthetic test results contains two steps. Take a ping synthetic test as an example.

Step 1: Query a result list:

{"SyntheticType":1,"RegionId":"cn-hangzhou","Category":"SYNTHETIC","Detail":"ICMP_LIST","Filters":{"taskId":"xxxx"},"AdvancedFilters":[{"Key":"taskType","OpType":"in","Value":[1]}],"StartTime":1710124284000,"EndTime":1710125544000,"Page":1,"PageSize":999}

Step 2: Query the result details:

{"RegionId":"cn-hangzhou","StartTime":1710115743153,"EndTime":1710137343153,"SyntheticType":2,"Category":"SYNTHETIC","Detail":"ICMP_LIST","AdvancedFilters":[{"Key":"dataId","OpType":"eq","Value":"$dataId"}],"Page":1,"PageSize":999,"Filters":{"dataId":"$dataId"}}

Replace $dataId with the dataId field in each record that is returned in Step 1.

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

Id of the request

70675725-8F11-4817-8106-CFE0AD71****
Codelong

The HTTP status code returned. The status code 200 indicates that the request was successful.

200
Messagestring

The error message returned.

null
Dataobject

The returned struct.

Itemsarray<object>

The list of results.

Itemobject

The list of results.

any

The results details.

{ "requestId": "9A82BD90-4A42-5E25-9DA1-D85A2D4AA696", "code": "200", "message": null, "action": null, "apiName": null, "extendedCode": null, "bizCode": null, "httpStatusCode": "200", "accessDeniedDetail": null, "data": { "RequestId": "9A82BD90-4A42-5E25-9DA1-D85A2D4xxxxx", "Data": { "PageSize": 999, "Total": 1, "Page": 1, "Items": [ { "__time__": 1710115743, "ipIsp": "aliyun", "targetCity": "", "ipCity": "Virginia", "__source__": "", "resultCode": "2400", "icmpLossRate": "20", "ipCountry": "USA", "tracertHops": "0", "url": "www.aliyun.com", "targetIp": "47.88.XX.XX", "targetOperator": "aliyun", "clientType": "4", "dataId": "377a04e1cd5a4adc8fb0f249666xxxxx", "tracertTime": "null", "clientLastIp": "21.0.XX.XX", "errName": "null", "ipRegion": "USA", "taskName": "Aliyun Dial-up Test Point", "icmpTime": "229", "timestamp": "1710137152606" } ] }, "Code": 200 }, "successResponse": true }
Totalinteger

The total number of entries.

12
Pageinteger

The page number.

1
PageSizeinteger

The number of entries returned on each page.

10
TaskCreateTimelong

A reserved field.

null

Examples

Sample success responses

JSONformat

{
  "RequestId": "70675725-8F11-4817-8106-CFE0AD71****",
  "Code": 200,
  "Message": "null",
  "Data": {
    "Items": [
      {
        "key": "{\n    \"requestId\": \"9A82BD90-4A42-5E25-9DA1-D85A2D4AA696\",\n    \"code\": \"200\",\n    \"message\": null,\n    \"action\": null,\n    \"apiName\": null,\n    \"extendedCode\": null,\n    \"bizCode\": null,\n    \"httpStatusCode\": \"200\",\n    \"accessDeniedDetail\": null,\n    \"data\": {\n        \"RequestId\": \"9A82BD90-4A42-5E25-9DA1-D85A2D4xxxxx\",\n        \"Data\": {\n            \"PageSize\": 999,\n            \"Total\": 1,\n            \"Page\": 1,\n            \"Items\": [\n                {\n                    \"__time__\": 1710115743,\n                    \"ipIsp\": \"aliyun\",\n                    \"targetCity\": \"\",\n                    \"ipCity\": \"Virginia\",\n                    \"__source__\": \"\",\n                    \"resultCode\": \"2400\",\n                    \"icmpLossRate\": \"20\",\n                    \"ipCountry\": \"USA\",\n                    \"tracertHops\": \"0\",\n                    \"url\": \"www.aliyun.com\",\n                    \"targetIp\": \"47.88.XX.XX\",\n                    \"targetOperator\": \"aliyun\",\n                    \"clientType\": \"4\",\n                    \"dataId\": \"377a04e1cd5a4adc8fb0f249666xxxxx\",\n                    \"tracertTime\": \"null\",\n                    \"clientLastIp\": \"21.0.XX.XX\",\n                    \"errName\": \"null\",\n                    \"ipRegion\": \"USA\",\n                    \"taskName\": \"Aliyun Dial-up Test Point\",\n                    \"icmpTime\": \"229\",\n                    \"timestamp\": \"1710137152606\"\n                }\n            ]\n        },\n        \"Code\": 200\n    },\n    \"successResponse\": true\n}"
      }
    ],
    "Total": 12,
    "Page": 1,
    "PageSize": 10,
    "TaskCreateTime": 0
  }
}

Error codes

HTTP status codeError codeError message
400ParameterMissing%s
400ParameterIllegal%s
400TaskQuotaLimit%s
400ParameterRegionIllegal%s
400DuplicateTagKeyParam tagKey is duplicate.
400TagNumOUTthe number of tag is out .
400NoPermissionUSERuser no permission
403RAMNotAuthorize%s
403STSNotAuthorize%s
403IllegalUserAccess%s
403APINotAuthorize%s
403CommercialStatusException%s
403SyntheticTrailExpired%s
403SyntheticInDebt%s
403SyntheticDailyTimesExhausted%s
403SyntheticDailyLimit%s

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

Change history

Change timeSummary of changesOperation
No change history