创建网络分析路径，用于云上网络路径可达性分析。
接口说明
- CreateNetworkPath接口支持多种组网场景以及多种资源间的路径创建，路径创建后，路径参数将被保存，便于重复分析。
- 一个阿里云账号（主账号）最多支持创建100条路径。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
| nis:CreateNetworkPath | Write |
|
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 否 | 要创建网络分析路径的地域ID。 | cn-hangzhou |
| NetworkPathName | string | 是 | 路径名称。 | ecs2PublicIp |
| SourceId | string | 是 | 源资源ID。 | i-2zef4ngqfarepyun**** |
| SourceType | string | 是 | 源资源类型。
| ecs |
| SourceIpAddress | string | 否 | 源IP地址。 | 172.17.XX.XX |
| SourcePort | integer | 否 | 源端口。 | 443 |
| TargetId | string | 否 | 目的资源ID。 | i-bp13d0e064gubm**** |
| TargetType | string | 否 | 目的资源类型。
| ecs |
| TargetIpAddress | string | 否 | 目的IP地址。 | 192.168.XX.XX |
| TargetPort | integer | 否 | 目的端口。 | 80 |
| Protocol | string | 否 | 协议类型。取值：
| tcp |
| NetworkPathDescription | string | 否 | 网络路径的描述信息。 | 分析ECS到ECS路径 |
| Tag | object [] | 否 | 标签列表。 | |
| Key | string | 否 | 标签键。最多支持128个字符，不能以 一次调用最多支持添加20个标签。 | role |
| Value | string | 否 | 标签值。最多支持输入20个标签值。一旦输入该值，可以为空字符串。 最多支持128个字符，不能以 | ops |
返回参数
示例
正常返回示例
JSON格式
{
"NetworkPathId": "np-4cbf598673d14d27****",
"RequestId": "92DD9FFB-06FB-56F7-83EF-5CEF98F5562A"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | IllegalParam.InternetIP | The specified IP address (%s) is not an internet IP address. | 指定的IP(%s)不是公网地址。即IP地址不能在10.0.0.0～10.255.255.255、172.16.0.0 ～172.31.255.255、192.168.0.0～192.168.255.255 这3个地址段内。 |
| 400 | IllegalParam.IP | The specified IP address (%s) is invalid. | 指定的IP地址(%s)无效。 |
| 400 | QuotaExceeded.NetworkPath | The quota of %s is exceeded, usage %s/%s. | 网络路径数量(%s)超过阈值，使用率：%s/%s。 |
| 400 | ResourceAlreadyExist.NetworkPath | The specified resource of %s already exists. | 指定的网络路径配置%s已存在。 |
| 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. | 路径分析不支持源与目的的公网IP和ECS实例ID（%s和%s）具有绑定关系。 |
| 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. | 源与目的都是IP，但都不是阿里云公网IP，路径分析不支持这种场景。 |
| 400 | IllegalParam.SourcePort | The specified SourcePort(%s) value is invalid. The value must be within the range of (0,65536]. | SourcePort参数不合法，必须介于0到65536（含）之间。 |
| 400 | IllegalParam.TargetPort | The specified TargetPort(%s) value is invalid. The value must be within the range of (0,65536]. | TargetPort参数不合法，必须介于0到65536（含）之间。 |
| 400 | IllegalParam.SourceId | The specified SourceId(%s) may be not exist. | 指定的实例(%s)可能不存在，请检查是否拼写错误。 |
| 400 | IllegalParam.TargetId | The specified TargetId(%s) may be not exist. | 指定的实例(%s)可能不存在，请检查是否拼写错误。 |
| 400 | MissingParameter.TagValue | You must specify Tag.N.Value. | 必须指定Tag的Value。 |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. | 超过了标签的最大数目。 |
| 400 | Duplicate.TagKey | The Tag.N.Key contains duplicate keys. | Tag的包含重复的key。 |
| 400 | MissingParameter.TagKey | You must specify Tag.N.Key. | 必须指定Tag的Key。 |
| 400 | InvalidParameter.TagKey | The Tag.N.Key parameter is invalid. | Tag的Key参数无效 |
| 400 | InvalidParameter.TagValue | The Tag.N.Value parameter is invalid. | Tag的Value参数无效。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 2023-07-11 | OpenAPI 错误码发生变更，OpenAPI 入参发生变更 | 看变更集 | ||||||||
| ||||||||||
| 2022-06-17 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||
|