附加彈性網卡（ENI）到專有網路（VPC）類型執行個體上。

描述

  • 彈性網卡必須處於 可用（Available）狀態。

  • 執行個體必須處於 運行中（Running）或者 已停止（Stopped）狀態。

  • 彈性網卡只能附加到 VPC 類型執行個體，且必須與執行個體在同一 VPC 內。

  • 一個彈性網卡只能同時附加到一台執行個體上。

  • 一台執行個體可以同時附加多個彈性網卡，參閱 彈性網卡 查看每台執行個體規格能附加的彈性網卡數量。

  • 由於 VPC 虛擬交換器不能跨可用性區域，彈性網卡附加的執行個體與彈性網卡所在的交換器必須屬於同一可用性區域。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：AttachNetworkInterface
RegionId String 是 執行個體所在地域的 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表
NetworkInterfaceId String 是 彈性網卡 ID
InstanceId String 是 執行個體 ID

返回參數

全是公共返回參數。參閱 公共參數。

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=AttachNetworkInterface
&RegionId=cn-hangzhou
&NetworkInterfaceId=[networkInterfaceId]
&InstanceId=AY121018033933eae8xxxxx
&<公共請求參數>
返回樣本

XML 格式

<AttachNetworkInterfaceResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
</AttachNetworkInterfaceResponse>
JSON 格式 
{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
UnsupportedParameter The parameters is unsupported. 400 該參數不存在，或者不支援該參數
InvalidOperation.InvalidEcsState The operation is not allowed in the current ECS state. 400 當前執行個體狀態不支援該操作
InvalidOperation.DetachPrimaryEniNotAllowed Detaching primary ENI from ECS instance is not allowed. 400 不允許從執行個體上解綁主網卡
MissingParameter The input parameter that is mandatory for processing this request is not supplied. 400 缺少必需參數
Abs.InvalidAccount.NotFound The Account is not found or ak is expired. 403 您的阿里雲帳號不存在，或者您的 AccessKey 已經過期
Forbidden.NotSupportRAM This action does not support accessed by RAM mode. 403 不允許 RAM 使用者執行該操作
Forbidden.SubUser The specified action is not available for you. 403 不允許 RAM 使用者執行該操作
EniPerInstanceLimitExceeded The number of ENI exceeds the limit for the type of instance you are trying to launch. 403 彈性網卡的數量超過了指定執行個體類型允許的最大值
InvalidOperation.VpcMismatch The VPC of the specified ENI and security group are not in the same VPC. 403 指定的彈性網卡和安全性群組 ID 不在同一個 VPC
SecurityGroupInstanceLimitExceed The maximum number of instances in a security group is exceeded. 403 該安全性群組內已有的執行個體數量已超出最大限制
InvalidOperation.InvalidEniType The operation is not allowed in the current ENI type. 403 當前彈性網卡類型不支援該操作
InvalidEcsId.NotFound The specified EcsId is not found. 404 指定的執行個體 ID 不存在