接口功能介绍
网卡绑定云主机
接口约束
1.使用限制，本接口只适用于普通网卡的挂载操作，不适用于共享网卡
2.网卡和子网与云主机处于相同VPC下
3.单台云主机可绑定的网卡有配额限制，请在配额限制范围内绑定
URI
POST /v4/ecs/ports/attach
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| clientToken | 是 | String | 客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一，使用同一个ClientToken值，则代表为同一个请求。保留时间为24小时 | attach_test01 | |
| regionID | 是 | String | 资源池ID，您可以查看地域和可用区来了解资源池 获取： 查 资源池列表查询 |
bb9fdb42056f11eda1610242ac110002 | |
| azName | 是 | String | 可用区名称，您可以查看地域和可用区来了解可用区 获取： 查 资源池可用区查询 注：查询结果中zoneList内返回存在可用区名称(即多可用区，本字段填写实际可用区名称)，若查询结果中zoneList为空（即为单可用区，本字段填写default） |
cn-huadong1-jsnj1A-public-ctcloud | |
| projectID | 否 | String | 企业项目ID，企业项目管理服务提供统一的云资源按企业项目管理，以及企业项目内的资源管理，成员管理。您可以通过查看创建企业项目了解如何创建企业项目 | 0 | |
| networkInterfaceID | 是 | String | 弹性网卡ID，您可以查看弹性网卡-弹性网卡基本知识来了解弹性网卡 获取： 查 查询弹性网卡列表 创 创建弹性网卡 注：多可用区时，为弹性网卡ID；非多可用区时，为子网ID。 |
subnet-y8cofge5uj | |
| instanceID | 是 | String | 云主机ID，您可以查看弹性云主机了解云主机的相关信息 获取： 查 查询云主机列表 创 创建一台按量付费或包年包月的云主机 创 批量创建按量付费或包年包月云主机 |
a628a7d9-ef97-3b16-8a0a-4a794fcdbc39 | |
| instanceType | 是 | Integer | 实例类型：3-虚拟机 | 3 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| errorCode | String | 错误码，为product.module.code三段式码 | Openapi.PatternCheck.NotValid | |
| error | String | 错误码，为product.module.code三段式码 | Openapi.PatternCheck.NotValid | |
| message | String | 失败时的错误信息 | success | |
| description | String | 失败时的错误描述 | 成功 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
示例：网卡绑定一台云主机
{
"clientToken": "attach_test01" ,
"regionID": "bb9fdb42056f11eda1610242ac110002",
"azName": "cn-huadong1-jsnj1A-public-ctcloud",
"projectID": "0",
"networkInterfaceID": "port-pja7l0zfvk",
"instanceID": "a628a7d9-ef97-3b16-8a0a-4a794fcdbc39",
"instanceType": 3
}
响应示例
{
"statusCode":800,
"errorCode":"SUCCESS",
"message":"success",
"description": "成功"
}
状态码
请参考 状态码
错误码
请参考 错误码
