全部產品
Search

搜尋本產品

    Network Intelligence Service：CreateNetworkPath - 建立網路分析路徑

    文件中心

    Network Intelligence Service：CreateNetworkPath - 建立網路分析路徑

    更新時間：Dec 21, 2025

    調用CreateNetworkPath介面，建立網路分析路徑，用於雲上網路路徑可達性分析。

    介面說明

    • CreateNetworkPath 介面支援多種組網情境以及多種資源間的路徑建立，路徑建立後，路徑參數將被儲存，便於重複分析。

    • 一個阿里雲帳號（主帳號）最多支援建立 100 條路徑。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nis:CreateNetworkPath

    create

    *NetworkPath

    acs:nis:*:{#accountId}:networkpath/*

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    否

    要建立網路分析路徑的地區 ID。

    cn-hangzhou
    NetworkPathName

    string

    是

    路徑名稱。

    ecs2PublicIp
    SourceId

    string

    是

    源資源 ID。

    i-2zef4ngqfarepyun****
    SourceType

    string

    是

    源資源類型。

    • ecs：Elastic Compute Service（Elastic Compute Service）。

    • internetIp：公網 IP 位址。

    • vsw：交換器（vSwitch）。

    • vpn：VPN 閘道。

    • vbr：邊界路由器 VBR（Virtual Border Router）。

    ecs
    SourceIpAddress

    string

    否

    源 IP 位址。

    172.17.XX.XX
    SourcePort

    integer

    否

    源連接埠。

    443
    TargetId

    string

    否

    目的資源 ID。

    說明

    調用該 API 時，TargetId 參數必須輸入。

    i-bp13d0e064gubm****
    TargetType

    string

    否

    目的資源類型。

    • ecs：Elastic Compute Service（Elastic Compute Service）。

    • internetIp：公網 IP 位址。

    • vsw：交換器（vSwitch）。

    • vpn：VPN 閘道。

    • vbr：邊界路由器 VBR（Virtual Border Router）。

    • clb：傳統型負載平衡 CLB（Classic Load Balancer）。

    說明

    調用該 API 時，TargetType 參數必須輸入。

    ecs
    TargetIpAddress

    string

    否

    目的 IP 位址。

    192.168.XX.XX
    TargetPort

    integer

    否

    目的連接埠。

    80
    Protocol

    string

    否

    協議類型。取值：

    • tcp：傳輸控制通訊協定。

    • udp：使用者資料包通訊協定。

    • icmp：網路控制報文協議。

    說明

    調用該 API 時，Protocol 參數必須輸入。

    tcp
    NetworkPathDescription

    string

    否

    網路路徑的描述資訊。

    分析ECS到ECS路徑
    Tag

    array<object>

    否

    標籤列表。

    object

    否

    標籤資訊。

    Key

    string

    否

    標籤鍵。最多支援 128 個字元，不能以aliyun或acs:開頭，不能包含http://或https://。

    一次調用最多支援添加 20 個標籤。

    role
    Value

    string

    否

    標籤值。最多支援輸入 20 個標籤值。一旦輸入該值，可以為空白字串。

    最多支援 128 個字元，不能以aliyun和acs:開頭，不能包含http://或者https://。

    ops
    ResourceGroupId

    string

    否

    路徑所屬的資源群組。

    rg-acfm27qsxjj****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    NetworkPathId

    string

    網路路徑 ID。

    np-4cbf598673d14d27****
    RequestId

    string

    請求 ID。

    92DD9FFB-06FB-56F7-83EF-5CEF98F5562A

    樣本

    正常返回樣本

    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參數無效。
    400 IllegalParam.SourceIp Please enter a valid source IP. 請輸入合法的源IP
    400 IllegalParam.Protocol The specified Protocol(%s) is invalid. 指定的Protocol(%s)參數不合法。
    400 IllegalParam.TargetType The specified target type (%s) is invalid. 指定的目的類型（%s）無效。
    400 IllegalParam.SourceType The specified source type (%s) is invalid. 指定的源類型（%s）無效。
    400 IllegalParam.TargetIp The specified target ip (%s) is invalid. 指定的目的IP（%s）格式不正確。
    400 IllegalParam.NotSupportHaVpn The specified VPN(%s), which is not currently supported for such instances. 指定的VPN(%s)是HaVpn，此類執行個體目前尚不支援。
    400 IllegalParam.SourceNotBound Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being. Elastic IP Address(%s)未綁定資源，暫不支援分析。
    400 IllegalParam.TargetNotBound Elastic public network IP(%s) is not bound to resources, and analysis is not supported for the time being. Elastic IP Address(%s)未綁定資源，暫不支援分析。
    400 IllegalParam.NotPublicIp The specified (%s) is invalid. 指定的參數 (%s) 不是公網IP。
    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. 指定的執行個體 (%s) 和執行個體類型不符。
    403 Forbidden.NetworkPath The current user has not activated NIS and is not authorized to use the path analysis interface. 目前使用者未開通NIS，無許可權使用路徑分析介面。

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。