全部產品
Search

搜尋本產品

    ENS：DescribeNetworkInterfaces - 查看網卡列表

    文件中心

    ENS：DescribeNetworkInterfaces - 查看網卡列表

    更新時間：Feb 03, 2026

    調用DescribeNetworkInterfaces查看網卡列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:DescribeNetworkInterfaces

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    NetworkInterfaceId

    string

    否

    彈性網卡 ID。

    eni-58z57orgmt6d1****
    InstanceId

    string

    否

    執行個體 ID。

    i-5t7z99n32gplriv
    NetworkId

    string

    否

    網路識別碼。

    n-2zeuphj08tt7q3brd****
    VSwitchId

    string

    否

    交換器 ID。

    vsw-12345
    EnsRegionId

    string

    否

    執行個體所屬地區 ID。

    cn-tianjin-cmcc
    SecurityGroupId

    string

    否

    輔助網卡對應的安全性群組 ID。 如果您需要通過安全性群組 ID 查詢輔助網卡的資訊，請指定該參數。

    sg-5p1fg655nh68xyz9i***
    PrimaryIpAddress

    string

    否

    彈性網卡主 IP 位址。

    10.XXX.XXX.5
    Type

    string

    否

    彈性網卡類型。取值範圍：

    • Primary：主網卡。

    • Secondary：輔助網卡。

    預設值：空，表示查詢所有類型。

    Secondary
    NetworkInterfaceName

    string

    否

    彈性網卡的名稱。

    test-01
    Status

    string

    否

    彈性網卡的狀態。取值範圍：

    • Available：可用。

    • Attaching：附加中。

    • InUse：已附加。

    • Detaching：分離中。

    • Deleting：刪除中。

    預設值：空，表示查詢所有狀態。

    Available
    PageNumber

    string

    否

    執行個體狀態列表的頁碼，起始值為 1。 預設值：1。

    1
    PageSize

    string

    否

    分頁查詢時每頁的行數，最大值為 100，預設值為 50。

    50
    Ipv6Address

    array

    否

    彈性網卡的 IPv6 地址。N 表示可以設定多個 IPv6 地址，N 的取值範圍：1~100。

    string

    否

    彈性網卡的 IPv6 地址。

    2605:340:cdb1:XXXX:XXXX:XXXX:XXXX:e2d6
    EnsRegionIds

    array

    否

    ENS 節點 ID 列表。N 表示可以設定多個節點 ID，N 的取值範圍：1~100。

    string

    否

    ENS 節點 ID。

    cn-fuzhou-1
    NetworkInterfaceIds

    array

    否

    彈性網卡 ID 列表。N 表示可以設定多個彈性網卡 ID，N 的取值範圍：1~100。

    string

    否

    彈性網卡 ID。

    eni-5****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    彈性網卡資訊組成的集合。

    NetworkInterfaceSets

    object

    NetworkInterfaceSet

    array<object>

    彈性網卡資訊組成的集合。

    array<object>

    彈性網卡資訊組成的集合。

    CreationTime

    string

    建立時間。按照 ISO8601 標準表示，並需要使用 UTC 時間。格式為：yyyy-MM-ddThh:mmZ。

    2022-02-22T03:53:25Z
    EnsRegionId

    string

    ENS 的節點 ID。

    id-jakarta-1
    InstanceId

    string

    彈性網卡綁定的執行個體 ID。

    i-5siavnr3
    MacAddress

    string

    彈性網卡的 MAC 位址。

    00:16:XXX:XXX:60:0a
    NetworkInterfaceId

    string

    彈性網卡 ID。

    eni-uf686a5
    PrimaryIp

    string

    主私網 IP。

    10.XXX.XXX.25
    PrimaryIpType

    string

    主 IP 位址類型。取值：

    • Public：公網地址

    • Private：私網地址

    Private
    Status

    string

    網卡的狀態，取值：

    • Available：可用。

    • Attaching：附加中。

    • InUse：已附加。

    • Detaching：分離中。

    • Deleting：刪除中。

    InUse
    NetworkId

    string

    網路識別碼。

    n-5w0qd03adw****
    VSwitchId

    string

    交換器 ID。

    vsw-5rqswx1trlsj9
    PrivateIpSets

    object

    PrivateIpSet

    array<object>

    PrivateIpSet 組成的集合。

    object

    PrivateIpSet 組成的集合。

    PrivateIpAddress

    string

    私網 IP。

    192.XXX.XXX.130
    Primary

    boolean

    是否是主私網 IP 位址。可能值：

    • true：主私網 IP。

    • false：輔助私網 IP。

    true
    PrivateIpStatus

    string

    私人 IP 狀態，取值：

    • Available：可用。

    • Creating：建立中。

    • Deleting：刪除中。

    Available
    NetworkInterfaceName

    string

    彈性網卡的名稱。

    primaryTest
    Description

    string

    彈性網卡的描述。

    test-description
    SecurityGroupIds

    object

    SecurityGroup

    array

    安全性群組 ID。

    string

    安全性群組 ID。

    sg-5p1bozeiw711a1***
    Type

    string

    彈性網卡類型。取值範圍：

    • Primary：主網卡。

    • Secondary：輔助網卡。

    Primary
    Ipv6Sets

    object

    Ipv6Set

    array<object>

    彈性網卡已指派的 IPv6 地址集合。

    object

    彈性網卡已指派的 IPv6 地址集合。

    Ipv6Address

    string

    彈性網卡已指派的 IPv6 地址。

    2605:340:cdb1:XXXX:XXXX:XXXX:XXXX:e2d6

    VmncLearn

    boolean

    PageNumber

    integer

    執行個體狀態列表的頁碼，起始值為：1，預設值：1。

    1
    PageSize

    integer

    分頁查詢時每頁的行數，最大值為 50，預設值為 10。

    50
    TotalCount

    integer

    列表資料總數。

    49
    RequestId

    string

    請求 ID。

    708AF9CE-FF92-5DF9-93F8-B7754AB1061A

    樣本

    正常返回樣本

    JSON格式

    {
  "NetworkInterfaceSets": {
    "NetworkInterfaceSet": [
      {
        "CreationTime": "2022-02-22T03:53:25Z",
        "EnsRegionId": "id-jakarta-1",
        "InstanceId": "i-5siavnr3",
        "MacAddress": "00:16:XXX:XXX:60:0a",
        "NetworkInterfaceId": "eni-uf686a5",
        "PrimaryIp": "10.XXX.XXX.25",
        "PrimaryIpType": "Private",
        "Status": "InUse",
        "NetworkId": "n-5w0qd03adw****",
        "VSwitchId": "vsw-5rqswx1trlsj9",
        "PrivateIpSets": {
          "PrivateIpSet": [
            {
              "PrivateIpAddress": "192.XXX.XXX.130",
              "Primary": true,
              "PrivateIpStatus": "Available"
            }
          ]
        },
        "NetworkInterfaceName": "primaryTest",
        "Description": "test-description",
        "SecurityGroupIds": {
          "SecurityGroup": [
            "sg-5p1bozeiw711a1***"
          ]
        },
        "Type": "Primary",
        "Ipv6Sets": {
          "Ipv6Set": [
            {
              "Ipv6Address": "2605:340:cdb1:XXXX:XXXX:XXXX:XXXX:e2d6\n"
            }
          ]
        },
        "VmncLearn": true
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 49,
  "RequestId": "708AF9CE-FF92-5DF9-93F8-B7754AB1061A"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Missing%s You must specify the parameter %s.
    400 Invalid%s The specified parameter %s is invalid.
    400 ens.interface.error Failed to call API. 介面調用發生異常。
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    變更歷史

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