Creates a task for analyzing network reachability.
Operation description
- The CreateNetworkReachableAnalysis operation is used to create a task for analyzing the reachability of the network path that is created by calling the CreateNetworkPath operation and record the analysis results.
- The CreateNetworkReachableAnalysis operation can be called to repeatedly analyze the reachability of a network path.
- You can create up to 1,000 reachability analysis records within one Alibaba Cloud account.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| RegionId | string | No | The ID of the region for which you want to create a task for analyzing network reachability. | cn-shanghai |
| NetworkPathId | string | Yes | The ID of the network path. You can call the CreateNetworkPath operation to obtain the ID of the network path. | np-b2f618ceb2c84057**** |
| Tag | object [] | No | The tags to add to the resource. | |
| Key | string | No | The key of the tag to add to the resource. The tag key can be up to 128 characters in length and cannot contain You can add up to 20 tags in each call. | Team |
| Value | string | No | The value of the tag to add to the resource. The tag value can be up to 128 characters in length and cannot contain You can add up to 20 tag values in each call. | ops |
Response parameters
Examples
Sample success responses
JSONformat
{
"NetworkReachableAnalysisId": "nra-2fede05617494417****",
"RequestId": "A7F0D6EC-E19E-58AC-AC9F-08036763960F"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | IncorrectStatus.NetworkPath | The last analysis status of %s is %s. Please try again later. | The Reachability Analyzer task %s is not completed. Try again after the task is completed. |
| 400 | QuotaExceeded.ParallelNraLimit | The maximum number of parallel reachability analysis task is exceeded. | The number of parallel Reachability Analyzer tasks exceeds the upper limit. |
| 400 | QuotaExceeded.MaxNraCount | The maximum number of reachability analysis task is exceeded. | The number of saved Reachability Analyzer tasks exceeds the upper limit. |
| 400 | IllegalParam.ZoneId | The specified available zone (%s) is invalid. | The specified zone (%s) is invalid. |
| 400 | IllegalParam.StepMinutes | The specified sampling interval (%s) is invalid. | The specified sampling interval (%s) is invalid. |
| 400 | IllegalParam.BeginTime | The specified begin time (%s) is invalid. | The specified start time (%s) is invalid. |
| 400 | IllegalParam.EndTime | The specified end time (%s) is invalid. | The specified end time (%s) is invalid. |
| 400 | Mismatch.BeginTimeAndEndTime | The specified begin time must be earlier than the end time. | The specified start time must be earlier than the end time. |
| 400 | MissingParameter.TagValue | You must specify Tag.N.Value. | - |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. | - |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | - |
| 400 | Duplicate.TagKey | The Tag.N.Key contains duplicate keys. | - |
| 400 | InvalidParameter.TagKey | The Tag.N.Key parameter is invalid. | - |
| 400 | InvalidParameter.TagValue | The Tag.N.Value parameter is invalid. | - |
| 404 | ResourceNotFound.NetworkPath | The specified resource of %s is not found. | The specified network path %s does not exist. |
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2023-09-04 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||
| ||||||||||||
| 2023-08-31 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||
| ||||||||||||
| 2023-07-11 | The Error code has changed. The request parameters of the API has changed | see changesets | ||||||||||
|