绑定弹性公网 IP
AssociateEip
所属服务
eip
Action
AssociateEip
Version
2017-12-14
Method
GET
描述
绑定云主机
如果PrivateIpAddress不为空,则指定该云主机的某个私有网ip绑定,只支持弹性公网ip使用
请求参数
query
参数名称 | 说明 | 参数类型 | 是否必填 | 备注 |
---|---|---|---|---|
IpAddress | IP地址 | string | 否 | |
Id | IPID,和IpAddress两个参数至少传入一个 | string | 否 | |
InstanceType | 绑定资源类型,nvs - 云主机,srv - 容器,目前只支持 nvs | string | 是 | |
InstanceId | 绑定的资源ID | string | 是 | |
InstanceName | 绑定的资源名,最大长度256 | string | 是 | |
PrivateIpAddress | 需要绑定的私有网ip地址,默认绑定主私有网ip,只能在绑定弹性ip时使用,不支持旧版ip | string | 否 | |
Action | AssociateEip | string | 是 | |
Version | 2017-12-14 | string | 是 |
Attention
IpAddress 和 Id 必须有一个
返回参数
返回参数被覆盖
状态码
错误码(Code) | 错误提示(Message) | http status code | 说明 |
---|---|---|---|
Success | Action is success | 200 | 成功 |
MissingParameter | client params error, Required String parameter "%s" is not present | 400 | 缺少输入参数:"%s" |
InvalidFormat | The format of the input parameter "%s" is illegal | 400 | 您输入参数格式不正确:"%s" |
InvalidIP | The specified Eip not exist | 404 | Eip不存在 |
ActionFail | Action fail cause by Eip status | 403 | Eip的状态不支持此操作 |
ResourceNotFound | The specified instance resouce not found | 404 | Eip绑定或解绑的资源不存在 |
InternalServerError | Internal server error | 500 | 服务器内部错误 |
NetworkError | Internal network error | 500 | 服务器内部网络错误 |
ResourceConflict | The specified Eip conflict | 400 | Eip冲突 |
ResourceNotFound | The specified instance resouce not found. | 400 | Eip绑定或解绑的资源不存在 |
请求示例
curl -X GET "http://127.0.0.1:7010/eip?Action=AssociateEip&Version=2017-12-14&InstanceName=test&InstanceId=b4d5e41b-ef74-45a7-ab6d-9cb779b4049f&InstanceType=nvs&IpAddress=60.191.82.189&PrivateIpAddress=172.30.10.206"
返回示例
{
"RequestId": "2fe3bbf7-a47d-47d5-aaef-b02eeae88fa8",
"Code": "Success",
"Message": "Action is success",
"Eip": {
"Id": "d5412198-d6ea-482c-b75b-142155963406",
"IpAddress": "60.191.82.189",
"Status": "InUse",
"MaxBandwidth": 5,
"Comment": "",
"InstanceId": "b4d5e41b-ef74-45a7-ab6d-9cb779b4049f",
"InstanceName": "test",
"InstanceType": "nvs",
"NetworkChargeType": "PayByTraffic",
"PayType": "PostPaid",
"ActiveStatus": "Normal",
"CreatedAt": "2019-02-20T02:24:31Z",
"UpdatedAt": "2019-02-20T02:24:31Z",
"TenantId": "0777ccfb14c84bb18cd819f92b9d7b24"
}
}