閱讀517 返回首頁    go 阿裏雲

綁定彈性公網 IP__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

將EIP綁定到相同地域的雲服務實例或HaVip實例上

  • 目前EIP隻支持綁定到ECS實例和HaVip實例上
  • 隻有Available狀態的EIP才能夠進行綁定操作
  • EIP綁定成功後立刻生效，不需要重啟雲服務器實例
  • EIP目前隻能被綁定到相同地域的專有網絡類型雲服務器實例上
  • 每個雲服務器實例或HaVip實例隻能同時綁定一個EIP
  • 每個EIP同一時間隻能綁定一個雲產品實例
  • 隻有處於運行中和已停止狀態的雲服務器實例可以綁定彈性公網IP
  • 隻有處於Available或者InUse狀態的HaVip可以綁定彈性公網IP
  • 因為安全原因被鎖定的EIP無法進行綁定和解綁操作

請求參數

名稱 類型 是否必須 描述
Action String 是 係統規定參數，取值：AssociateEipAddress
AllocationId String 是 需要進行綁定操作的EIP的申請Id，申請Id是EIP的唯一標識
InstanceType String 否 綁定的對象類型。
取值範圍：EcsInstance | HaVip
默認值：EcsInstance
InstanceId String 是 需要進行綁定操作的實例id。
若InstanceType為EcsInstance，則此處填寫ECS實例Id；若InstanceType為HaVip，則此處填寫HaVipId；

返回參數

全是公共返回參數，詳見公共返回參數

錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidAssociation.Duplicated Specified instance already is associated. 400 指定的ECS實例已綁定EIP，不能再綁定。
OperationDenied Specified instance is not in VPC. 400 指定的ECS實例不是VPC類型實例，綁定失敗。
InvalidParameter.Mismatch Specified elastic IP address and ECS instance are not in the same region. 400 指定ECS實例和EIP不屬於同一個region
IncorrectEipStatus Current elastic IP status does not support this operation. 400 指定的EIP狀態不支持此操作
InvalidAllocationId.NotFound Specified allocation ID is not found. 404 指定的EIP的申請ID不存在，綁定失敗
InvalidInstanId.NotFound Specified instance does not exist. 404 指定的ECS實例不存在，綁定失敗
IncorrectInstanceStatus Current instance status does not support this operation. 400 指定的ECS實例狀態為非stop和running，綁定EIP失敗
InvalidInstanceType.ValueNotSupported The specified value of InstanceType is not supported. 400 InstanceType的輸入值不合法
InvalidHaVip.NotFound The specified HaVip does not exist. 404 InstanceType為HaVip，且InstanceId並不是一個真實存在的有效HaVipId。
CountLimitExceeded.EIPOnECSInstance One ECS Instance can be associated with only one EIP. 400 ECS實例上允許綁定的EIP數量已經達到上限
CountLimitExceed.EIPOnHaVip One HaVip can be associated with only one EIP. 400 HaVip上允許綁定的EIP數量已經達到上限
IncorrectHaVipStatus HaVip can be operated by this action only when it’s status is Available or InUse. 400 HaVip狀態不符合要求

示例

請求示例

  1. https://ecs.aliyuncs.com/?Action=AssociateEipAddress
  2. &AllocationId=eip-25877c70x
  3. &InstanceId=i-25skktcp4
  4. &<公共請求參數>

返回示例

XML格式

  1. <ReleasePublicIpAddressResponse>
  2.     <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  3. </ReleasePublicIpAddressResponse>

JSON格式

  1. {"RequestId":"C0FD0EED-F90D-4479-803D-DD62335357E5"}

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

  上一篇：go 申請彈性公網 IP__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 查詢彈性公網 IP 列表__網絡相關接口_API 參考_雲服務器 ECS-阿裏雲