閱讀177 返回首頁    go 阿裏雲

查詢彈性公網 IP 列表__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

查詢指定地域的EIP列表。此接口支持分頁查詢，每頁的數量默認為10條。

  • 此接口不會校驗參數之間的依賴關係，返回結果是所有條件的“交集”。

請求參數

名稱 類型 是否必須 描述
Action String 是 係統規定參數，取值：DescribeEipAddresses
RegionId String 是 需要查詢的地域
Status String 否 Eip狀態，包括Associating | Unassociating | InUse | Available
EipAddress String 否 EIP
AllocationId String 否 申請Id
AssociatedInstanceType String 否 綁定的資源的類型；
這是一個過濾器性質的參數，若不指定，則表示不使用該條件對結果進行過濾。
取值範圍：EcsInstance|HaVip
AssociatedInstanceId String 否 綁定的資源的Id。
這是一個過濾器性質的參數，若不指定，則表示不適用該條件對結果進行過濾。
如果要使用該過濾器，必須同時使用AssociatedInstanceType。
如果AssociatedInstanceType是HaVipId，則該參數填寫HaVipId；若AssociatedInstanceType是EcsInstance，則該參數填寫EcsInstancdId。
PageNumber Integer 否 實例狀態列表的頁碼，起始值為1，默認值為1
PageSize Integer 否 分頁查詢時設置的每頁行數，最大值50行，默認為10

返回參數

名稱 類型 描述
EipAddresses EipAddressSetType 彈性IP地址詳情EipAddressSetType組成的集合
TotalCount Integer 列表條條目數
PageNumber Integer 當前頁碼
PageSize Integer 當前分頁包含多少條目

錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
Forbidden.RegionNotFound Specified region is not found during access authentication. 404 指定的region不存在
InvalidIAssociatedInstanceType.ValueNotSupported The specified value of AssociatedInstanceType is not supported. 400 AssociatedInstanceType的輸入值不合法。

示例

請求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeEipAddresses
  2. &RegionId=cn-hangzhou-1
  3. &<公共請求參數>

返回示例

XML格式

  1. <DescribeEipAddresses>
  2.     <RequestId>51BE7822-4121-428A-88F3-262AE4FD868D</RequestId>
  3. <EipAddresses>
  4.     <EipAddress>
  5.         <RegionId>cn-beijing</RegionId>
  6.         <AllocationId> eip-2578g5v5a </AllocationId>
  7.         <IpAddress>123.56.0.36</IpAddress>
  8.         <Status>Available</Status>
  9.         <OperationLocks>
  10.             <LockReason></LockReason>
  11. </OperationLocks>
  12.         <Bandwidth>5</Bandwidth>
  13.         <InternetChargeType>PayByBandwidth</InternetChargeType>
  14.         <AllocationTime>2014-05-28T03:03:16Z</AllocationTime>
  15.     </EipAddress>
  16. </EipAddresses>
  17. </DescribeEipAddresses>

JSON格式

  1. {
  2.   "EipAddresses": {
  3.     "EipAddress": [
  4.       {
  5.         "AllocationId": "eip-2578g5v5a",
  6.         "AllocationTime": "2014-05-28T03:03:16Z ",
  7.         "Bandwidth": "1",
  8.         "InstanceId": "",
  9.         "InternetChargeType": " PayByBandwidth ",
  10.         "IpAddress": "123.56.0.36",
  11.         "OperationLocks": {
  12.           "LockReason": []
  13.         },
  14.         "RegionId": "cn-beijing",
  15.         "Status": "Available"
  16.       }
  17.     ]
  18.   },
  19.   "PageNumber": 1,
  20.   "PageSize": 10,
  21.   "RequestId": "51BE7822-4121-428A-88F3-262AE4FD868D",
  22.   "TotalCount": 1
  23. }

最後更新：2016-11-23 17:08:34

  上一篇：go 綁定彈性公網 IP__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 修改彈性公網 IP 屬性__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲