绑定弹性公网IP
1. 接口描述
调用 AssociateEip 接口将弹性公网IP绑定到相同地域的实例上。
- 弹性公网IP可绑定到同地域的云服务器、裸金属云服务器、轻云服务器等。
- 绑定是一个异步操作接口，即系统会先返回一个请求ID，但未完成绑定，系统后台的绑定操作任务仍在进行。
- 请求绑定操作前，弹性公网IP的状态需是可绑定（AVAILABLE ），实例的状态必须是已关闭（STOPPED）或已启动（STARTED）。
- 发起绑定后，弹性公网IP的状态变更为操作中（PENDING），操作状态变更为绑定中（BINDING），绑定完成后，弹性公网IP状态变更为AVAILABLE 。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：AssociateEip |
| EipUUID | String | 是 | 弹性公网IP标识 |
| InstanceUUID | String | 是 | 实例ID |
| EipBindLevel | String | 否 | 公网IP等级，一个实例只能有一个主IP。取值范围: MAIN 主IP SECONDARY 次IP |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?SignatureVersion=1.0
&Action=AssociateEip
&Format=JSON
&EipUUID=eip-u200000du5gf
&InstanceUUID=ecs-x8sfa05erl
&SignatureNonce=fad368fd-b5e3-476b-903b-2ef34e0e9fba
&Version=2014-05-26
&AccessKeyId=hfWkfqG6a794
&Signature=IcyHYfUBWSzJauAbDaqniNSNE94=
&SignatureMethod=HMAC-SHA1
&Timestamp=2023-02-25T15:29:21Z
正常返回示例
{
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | InstanceUUID 参数不能为空 |
| ValueNotSupported | EipBindLevel 参数不合法 |
| AvailableEipNotFound | 可用的弹性公网IP未找到 |
| AvailableInstanceNotFound | 可用的实例未找到 |
| EipHasDeleted | 弹性公网IP已删除 |
| IncorrectEipStatus | 该公网IP目前的状态不支持此操作 |
| IncorrectInstanceStatus | 该实例目前的状态不支持此操作 |
| IncorrectInstanceRegion | 实例所在地域错误 |
| EipAlreadyExisted | 弹性公网IP已绑定 |
| NoOperationAuthority | 无操作权限 |
| AssociateEipFail | 绑定弹性公网IP失败:xxx |