全部產品
Search

搜尋本產品

    ENS：DescribeEnsEipAddresses

    文件中心

    ENS：DescribeEnsEipAddresses

    更新時間：Aug 21, 2026

    呼叫 DescribeEnsEipAddresses 查詢彈性公網 IP（EIP）。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:DescribeEnsEipAddresses

    list

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    AllocationId

    string

    否

    要查詢的 EIP 執行個體 ID。最多支援輸入 50 個 EIP 執行個體 ID，執行個體 ID 之間以半形逗號（,）分隔。

    eip-5q9uwkd9bznjpxz8hr6cirnjk
    EipAddress

    string

    否

    要查詢的 EIP 的 IP 位址。最多支援輸入 50 個 EIP 的 IP 位址，IP 位址之間以半形逗號（,）分隔。

    120.XXX.XXX.4
    AssociatedInstanceId

    string

    否

    雲端產品的執行個體 ID。

    lb-5t18quoohsrc3xkf86spmnu77
    AssociatedInstanceType

    string

    否

    要綁定的雲端產品執行個體類型，取值：

    • EnsInstance：VPC 類型的 ENS 執行個體。

    • SlbInstance：負載平衡執行個體。

    SlbInstance
    Status

    string

    否

    EIP 的狀態，取值：Associating：綁定中。Unassociating：解綁中。InUse：已分配。Available：可用。

    InUse
    EnsRegionId

    string

    否

    ENS 的節點 ID。

    cn-chengdu-telecom
    EipName

    string

    否

    EIP 的名稱。

    test
    Standby

    string

    否

    是否為備用彈性 IP。取值：

    • true：備用。

    • false：非備用。

    true
    IcmpReplyEnabled

    boolean

    否

    是否啟用 ICMP 代回。取值：

    • true（預設值）：啟用。

    • false：不啟用。

    false
    EnsRegionIds

    array

    否

    ENS 節點 ID 陣列。陣列長度：1~100。

    string

    否

    ENS 節點 ID。

    cn-chengdu-telecom-4
    PageNumber

    integer

    否

    清單的頁碼，預設值為 1。

    1
    PageSize

    integer

    否

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

    50
    LockReason

    string

    否

    鎖定類型。

    • financial：因欠費被鎖定。

    financial

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    8629F679-B51D-4194-A1CC-5D8F504C362B
    EipAddresses

    object

    [\"106.14.194.193\"]
    EipAddress

    array<object>

    EIP 的詳細資訊。

    array<object>

    EIP 的詳細資訊。

    AllocationId

    string

    EIP 的執行個體 ID。

    eip-5sainglpw7qfem3icir4s****
    AllocationTime

    string

    EIP 的建立時間。

    1624885274000
    Bandwidth

    integer

    EIP 的頻寬峰值，預設值為 5。取值範圍：5~10000，單位：Mbps。

    50
    ChargeType

    string

    EIP 的計費模式。

    • PrePaid：包年包月。

    • PostPaid：按量計費。

    PostPaid
    Description

    string

    EIP 的描述資訊。

    example
    InstanceId

    string

    目前綁定的執行個體 ID。

    lb-5sc3kum2e0sz34wbqrws9****
    InstanceType

    string

    要綁定的雲端產品執行個體類型，取值：

    • EnsInstance：VPC 類型的 ENS 執行個體。

    • SlbInstance：負載平衡執行個體。

    SlbInstance
    InternetChargeType

    string

    EIP 的計費方式。

    • 95BandwidthByMonth：月 95 峰值頻寬。

    • PayByBandwidth：固定頻寬計費。

    95BandwidthByMonth
    IpAddress

    string

    EIP 的 IP 位址。

    120.XXX.XXX.4
    Name

    string

    EIP 執行個體名稱。

    test
    EnsRegionId

    string

    ENS 節點 ID。

    cn-xian-telecom
    Status

    string

    EIP 的狀態。

    • Associating：綁定中。

    • Unassociating：解綁中。

    • InUse：已分配。

    • Available：可用。

    Available
    Isp

    string

    營運商，取值：

    • cmcc：中國移動。

    • unicom：中國聯通。

    • telecom：中國電信。

    cmcc
    Standby

    boolean

    該 EIP 是否為備用。

    true
    IpStatus

    string

    如果該彈性 IP 是備用 EIP 時，表示目前 EIP 的執行狀態。

    • Stopped：已停止。

    • Running：執行中。

    • Starting：啟動中。

    • Stopping：停止中。

    Stopped
    Tags

    object

    Tag

    array<object>

    標籤集合。

    object

    標籤集合。

    Value

    string

    標籤值。

    TestValue
    Key

    string

    標籤鍵。

    TestKey
    TagValue deprecated

    string

    標籤值。

    TestValue
    TagKey deprecated

    string

    標籤鍵。

    TestKey
    IcmpReplyEnabled

    boolean

    是否啟用 ICMP 代回。取值：

    • true（預設值）：啟用。

    • false：不啟用。

    false
    BandwidthPackageBandwidth

    integer

    EIP 加入的共享頻寬的頻寬值。單位：Mbps。

    100
    BandwidthPackageId

    string

    加入的共享頻寬 ID。

    cbwp-5***
    OperationLocks

    object

    Lock

    array<object>

    鎖定詳情。

    object

    鎖定詳情。

    LockReason

    string

    鎖定類型。

    • financial：因欠費被鎖定。

    financial
    PageNumber

    integer

    查詢清單的頁碼。取值：>0，預設查詢第 1 頁。

    1
    PageSize

    integer

    分頁查詢時設定的每頁列數。預設值：10，取值：10~100。

    50
    TotalCount

    integer

    清單項目數。

    7

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "8629F679-B51D-4194-A1CC-5D8F504C362B",
  "EipAddresses": {
    "EipAddress": [
      {
        "AllocationId": "eip-5sainglpw7qfem3icir4s****",
        "AllocationTime": "1624885274000",
        "Bandwidth": 50,
        "ChargeType": "PostPaid",
        "Description": "example",
        "InstanceId": "lb-5sc3kum2e0sz34wbqrws9****",
        "InstanceType": "SlbInstance",
        "InternetChargeType": "95BandwidthByMonth",
        "IpAddress": "120.XXX.XXX.4",
        "Name": "test",
        "EnsRegionId": "cn-xian-telecom",
        "Status": "Available",
        "Isp": "cmcc",
        "Standby": true,
        "IpStatus": "Stopped",
        "Tags": {
          "Tag": [
            {
              "Value": "TestValue",
              "Key": "TestKey",
              "TagValue": "TestValue",
              "TagKey": "TestKey"
            }
          ]
        },
        "IcmpReplyEnabled": false,
        "BandwidthPackageBandwidth": 100,
        "BandwidthPackageId": "cbwp-5***",
        "OperationLocks": {
          "Lock": [
            {
              "LockReason": "financial"
            }
          ]
        }
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 7
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ens.interface.error Failed to call API.
    400 NoPermission Permission denied.

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

    變更歷史

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