更新时间:2025-12-30 GMT+08:00

获取http探测结果

功能介绍

根据http探测发送返回的task_id查询探测结果。

调用方法

请参见如何调用API

URI

GET /v2/{project_id}/notifications/topics/{topic_urn}/detection/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。 获取项目ID请参考 获取项目ID

topic_urn

String

Topic的唯一的资源标识,可通过查询主题列表获取该标识。

task_id

String

http探测任务id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

detail

detail object

终端探测详情

status

Integer

http探测任务状态,0代表执行成功,终端可用,1代表未执行,2代表执行失败,终端不可用

request_id

String

请求ID

表4 detail

参数

参数类型

描述

httpCode

Integer

探测终端返回的http返回码,0代表用户在黑名单无法发送,-1代表用户终端超过5秒未响应,-2代表队列已满,Http探测任务未执行。其他httpcode为终端实际返回值。

httpResponse

String

终端探测响应体,如果httpCode为0,-1,-2, 2xx时响应体内容固定,由SMN定义。其余httpCode的响应体内容为终端返回内容。

状态码:400

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码:403

表6 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码:404

表7 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

状态码:500

表8 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

code

String

服务异常错误信息编码。

message

String

服务异常错误信息描述。

请求示例

正确查询的示例

GET https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/urn:smn:regionId:f96188c7ccaf4ffba0c9aa149ab2bd57:test_create_topic_v2/detect/c414cfd4326a488e9c6a315ce8dc5fe3

响应示例

状态码:200

获取http探测正确返回体

{
  "detail" : {
    "httpCode" : 200,
    "httpResponse" : "Http endpoint is available."
  },
  "status" : 0,
  "request_id" : "e4bde8f67bd64402804011160c9f8772"
}

状态码

状态码

描述

200

获取http探测正确返回体

400

Bad Request

403

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码