CreateAndAnalyzeNetworkPath_网络智能服务_API文档-阿里云OpenAPI开发者门户

接口说明

该接口根据输入的源和目的信息，无需创建网络分析路径，直接发起可达性分析任务。返回分析结果后，将不在系统中记录，如需在 NIS 中留存网络路径或可达性分析任务结果，建议使用 createNetworkReachableAnalysis 接口。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

nis:CreateAndAnalyzeNetworkPath	Create	全部资源 *	无	无

请求参数

字段名称	字段详情
SourceIdstring	源资源 ID。示例值:i-uf62y8khhbkbdrp6****
SourceIpAddressstring	源 IP 地址。示例值:192.168.XX.XX
TargetIpAddressstring	目的 IP 地址。示例值:172.50.XX.XX
SourceTypestring	源资源类型。展开详情示例值:ecs
SourcePortinteger<int32>	源端口。示例值:0
TargetIdstring	目的资源 ID。展开详情示例值:i-m5eactvw7wtpktv5****
TargetTypestring	目的资源类型。展开详情示例值:ecs
TargetPortinteger<int32>	目的端口。示例值:80
Protocolstring	协议类型。取值：展开详情示例值:tcp
RegionIdstring	要发起网络可达性分析任务的地域 ID。示例值:cn-shanghai

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:D5E98683-355B-5867-8D3D-A24755F6895B
NetworkReachableAnalysisIdstring	发起的网络可达性分析任务 ID。示例值:nra-dfe9e53d2b524568****
SourceIdstring	源资源 ID。示例值:i-uf62y8khhbkbdrp6****
TargetIdstring	目的资源 ID。示例值:i-m5eactvw7wtpktv5****
SourceTypestring	源资源类型。示例值:ecs
TargetTypestring	目的资源类型。示例值:ecs
SourcePortstring	源端口。示例值:0
TargetPortstring	目的端口。示例值:80
Protocolstring	协议类型。示例值:tcp
SourceIpAddressstring	源 IP 地址。示例值:192.168.XX.XX
TargetIpAddressstring	目的 IP 地址。示例值:172.50.XX.XX

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	IllegalParam.InternetIP	The specified IP address (%s) is not an internet IP address.	诊断
400	IllegalParam.IP	The specified IP address (%s) is invalid.	诊断
400	Mismatch.SourceIdAndTargetId	Reachability Analyzer does not support the scenario in which source and target Internet IP addresses and ECS instance ID (%s and %s) are bound.	诊断
400	IllegalParam.SourceAndTargetInternetIp	Both source ID and target ID are IP addresses, but are not Internet IP addresses. Reachability Analyzer does not support the scenario.	诊断
400	IllegalParam.SourcePort	The specified SourcePort(%s) value is invalid. The value must be within the range of (0,65536].	诊断
400	IllegalParam.TargetPort	The specified TargetPort(%s) value is invalid. The value must be within the range of (0,65536].	诊断
400	IllegalParam.SourceId	The specified SourceId(%s) may be not exist.	诊断
400	IllegalParam.TargetId	The specified TargetId(%s) may be not exist.	诊断
400	IllegalParam.SourceIp	Please enter a valid source IP.	诊断
400	IllegalParam.SourceType	The specified source type (%s) is invalid.	诊断
400	IllegalParam.Protocol	The specified Protocol(%s) is invalid.	诊断
400	IllegalParam.TargetType	The specified target type (%s) is invalid.	诊断
400	IllegalParam.TargetIp	The specified target ip (%s) is invalid.	诊断
400	IllegalParam.NotSupportHaVpn	The specified VPN(%s), which is not currently supported for such instances.	诊断
400	IllegalParam.SourceNotBound	Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being.	诊断
400	IllegalParam.TargetNotBound	Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being.	诊断
400	IllegalParam.NotPublicIp	The specified (%s) is invalid.	诊断
400	IllegalParam.SourceEqualTarget	The specified source and destination are identical, which is not supported for analysis.	诊断
400	IllegalParam.TypeAndIdMismatch	The specified instanceId (%s) and type do not match.	诊断
403	Forbidden.NetworkPath	The current user has not activated NIS and is not authorized to use the path analysis interface.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-04-23	变更错误码400
	2024-04-09	变更错误码400
	2024-03-22	变更错误码400 新增错误码403
	2023-12-12	变更错误码400
	2023-09-04	删除请求参数AuditParam
	2023-08-31	新增请求参数AuditParam

1
2
10 条/页