調用DescribeSyntheticProbeList介面查詢撥測節點列表。
介面說明
本文將提供一個範例，查詢電信業者「聯通」在「北京市」的探測點詳情。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
cms:DescribeSyntheticProbeList |
none |
*All Resource
|
無 | 無 |
請求文法
GET HTTP/1.1請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| Isp |
string |
否 |
電信業者探測點的名稱或 ID。 |
China Unicom |
| City |
string |
否 |
電信業者探測點所在城市的名稱或 ID。 |
Beijing |
| Ipv4 |
boolean |
否 |
只展示 ipv4 節點。 |
false |
| Ipv6 |
boolean |
否 |
只展示 ipv6 節點。 |
false |
| ViewAll |
boolean |
否 |
是否返回所有探測點。取值：
|
true |
| MbProbe |
boolean |
否 |
只查詢行動端探測點。 |
false |
| LmProbe |
boolean |
否 |
只查詢 Lastmile 網民家用寬頻節點。 |
false |
| IdcProbe |
boolean |
否 |
只查詢 IDC 機房探測點。 |
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| Code |
string |
狀態碼。 |
200 |
| IspCityList |
array<object> |
探測點列表。 |
|
|
object |
探測點列表。 |
||
| AreaCn |
string |
大區中文。 |
华北 |
| AreaEn |
string |
大區英文。 |
Huabei |
| City |
string |
城市 ID。 |
738 |
| CityCn |
string |
城市中文。 |
北京 |
| CityEn |
string |
城市英文。 |
Beijing |
| Country |
string |
國家代碼。 |
629 |
| CountryCn |
string |
國家中文。 |
中国 |
| CountryEn |
string |
國家（或地區）英文 |
China |
| IpPool |
array |
節點 ip 列表。 |
|
|
string |
節點 ip。 |
1.1.1.1 |
|
| Isp |
string |
電信業者 ID。 |
232 |
| IspCn |
string |
電信業者中文。 |
联通 |
| IspEn |
string |
電信業者英文。 |
China-Unicom |
| LmProbeCount |
integer |
lastmile 探測點數量。 |
1 |
| MbProbeCount |
integer |
行動端探測點數量。 |
1 |
| Region |
string |
省份代碼。 |
264 |
| RegionCn |
string |
省份中文。 |
江西省 |
| RegionEn |
string |
省份英文。 |
Jiangxi |
| IdcV4ProbeCount |
integer |
idc ipv4 節點數量。 |
1 |
| IdcV6ProbeCount |
integer |
idc ipv6 節點數量。 |
1 |
| Message |
string |
錯誤訊息。 |
The specified resource is not found. |
| RequestId |
string |
請求 ID。 |
87170bc7-e28a-4c93-b9bf-90a1dbe84736 |
| Success |
string |
操作是否成功。取值：true：成功。false：失敗。 |
true |
樣本
正常返回樣本
JSON格式
{
"Code": "200",
"IspCityList": [
{
"AreaCn": "华北",
"AreaEn": "Huabei",
"City": "738",
"CityCn": "北京",
"CityEn": "Beijing",
"Country": "629",
"CountryCn": "中国",
"CountryEn": "China",
"IpPool": [
"1.1.1.1"
],
"Isp": "232",
"IspCn": "联通",
"IspEn": "China-Unicom",
"LmProbeCount": 1,
"MbProbeCount": 1,
"Region": "264",
"RegionCn": "江西省",
"RegionEn": "Jiangxi",
"IdcV4ProbeCount": 1,
"IdcV6ProbeCount": 1
}
],
"Message": "The specified resource is not found.",
"RequestId": "87170bc7-e28a-4c93-b9bf-90a1dbe84736",
"Success": "true"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidParameterValue | Illegal parameters. | |
| 401 | AccessDeniedException | You donot have sufficient access to perform this action. | |
| 500 | InternalUnknownError | The request processing has failed due to some unknown error. | |
| 402 | LimitExceeded | The quota for this customer had been reached. | |
| 403 | Forbidden | You are not authorized to operate the specified resource. | |
| 406 | ExceedingQuota | Exceeding quota limits. | |
| 429 | ThrottlingException | The request was denied due to request throttling. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。