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

接口说明

CreateNetworkPath 接口支持多种组网场景以及多种资源间的路径创建，路径创建后，路径参数将被保存，便于重复分析。
一个阿里云账号（主账号）最多支持创建 100 条路径。

流控信息

请求速率为120/60(s)。

授权信息

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

具体说明如下：展开详情

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

nis:CreateNetworkPath	Create	NetworkPath acs:nis::{#accountId}:networkpath/	无	无

请求参数

字段名称	字段详情
RegionIdstring	要创建网络分析路径的地域 ID。示例值:cn-hangzhou
NetworkPathNamestring	路径名称。示例值:ecs2PublicIp
SourceIdstring	源资源 ID。示例值:i-2zef4ngqfarepyun****
SourceTypestring	源资源类型。展开详情示例值:ecs
SourceIpAddressstring	源 IP 地址。示例值:172.17.XX.XX
SourcePortinteger<int32>	源端口。示例值:443
TargetIdstring	目的资源 ID。展开详情示例值:i-bp13d0e064gubm****
TargetTypestring	目的资源类型。展开详情示例值:ecs
TargetIpAddressstring	目的 IP 地址。示例值:192.168.XX.XX
TargetPortinteger<int32>	目的端口。示例值:80
Protocolstring	协议类型。取值：展开详情示例值:tcp
NetworkPathDescriptionstring	网络路径的描述信息。示例值:分析ECS到ECS路径
Tagarray<object>	标签列表。子级条数 <= 21
ResourceGroupIdstring	路径所属的资源组。示例值:rg-acfm27qsxjj****

返回参数

字段名称	字段详情
NetworkPathIdstring	网络路径 ID。示例值:np-4cbf598673d14d27****
RequestIdstring	请求 ID。示例值:92DD9FFB-06FB-56F7-83EF-5CEF98F5562A

返回示例

错误码

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

全局错误码

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	QuotaExceeded.NetworkPath	The quota of %s is exceeded, usage %s/%s.	诊断
400	ResourceAlreadyExist.NetworkPath	The specified resource of %s already exists.	诊断
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	MissingParameter.TagValue	You must specify Tag.N.Value.	诊断
400	NumberExceed.Tags	The maximum number of Tags is exceeded.	诊断
400	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.	诊断
400	MissingParameter.TagKey	You must specify Tag.N.Key.	诊断
400	InvalidParameter.TagKey	The Tag.N.Key parameter is invalid.	诊断
400	InvalidParameter.TagValue	The Tag.N.Value parameter is invalid.	诊断
400	IllegalParam.SourceIp	Please enter a valid source IP.	诊断
400	IllegalParam.Protocol	The specified Protocol(%s) is invalid.	诊断
400	IllegalParam.TargetType	The specified target type (%s) is invalid.	诊断
400	IllegalParam.SourceType	The specified source 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-11-06	新增请求参数ResourceGroupId
	2023-07-11	变更错误码400 新增请求参数Tag
	2022-06-17	变更错误码400

CreateNetworkPath_网络智能服务_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例