建立一個彈性網卡(ENI)。

描述

  • 新建立的彈性網卡為 可用Available)狀態。

  • 彈性網卡只支援附加到同一可用區的 VPC 類型實例。

  • 一個彈性網卡只能附加到一台實例,附加到新實例之前您需要將其與當前實例分離。

  • 彈性網卡重新附加到另一台實例時,其屬性跟隨該彈性網卡,網路流量也會重新導向到新的實例。

  • 一個帳號在一個阿里雲地域內預設最多可建立 100 個彈性網卡。如果需要更多,請 提交工單 申請。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:CreateNetworkInterface
RegionId String 實例所在地域的 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
VSwitchId String 指定 VPC 的交換器 ID。
SecurityGroupId String 所屬的安全性群組 ID 必須是同一個 VPC 下的安全性群組。
PrimaryIpAddress String 彈性網卡的主私有 IP 位址。指定 IP 必須是在所屬交換器的地址段內的空閑地址,不指定則預設隨機分配該交換器中的空閑地址。
NetworkInterfaceName String 彈性網卡名稱。
  • 字元長度為 [2, 128] 個英文或中文字元,必須以大小字母或中文開頭,可包含數字、半形冒號(:)、底線(_)或連字號(-)。
  • 彈性網卡名稱會展示在控制台。
  • 不能以 http:// 和 https:// 開頭。
  • 不填則為空。預設值:空。
Description String 彈性網卡的描述資訊。
  • 字元長度為 [2, 256] 個英文或中文字元。
  • 不能以 http:// 和 https:// 開頭。
  • 不填則為空。預設值:空。
ClientToken String 用於保證請求的等冪性。由客戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性

返回參數

名稱 類型 描述
NetworkInterfaceId String 彈性網卡 ID

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
&RegionId=cn-hangzhou
&VSwitchId=[vswitchid]
&SecurityGroupId=sg-c0003exxxxx
&<公共請求參數>
返回樣本

XML 格式

<CreateNetworkInterfaceResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
    <NetworkInterfaceId>eni-eniIxxxxx</NetworkInterfaceId>
</CreateNetworkInterfaceResponse>
JSON 格式
{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
    "NetworkInterfaceId": "eni-enixxxxx"
}

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
MissingParameter The input parameter that is mandatory for processing this request is not supplied. 400 缺少必需參數。
UnsupportedParameter The parameters is unsupported. 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 您無法執行該操作。
InvalidOperation.AvailabilityZoneMismatch The VPC VSwitch of the specified ENI and ECS instance are not in the same availability zone. 403 指定的 VPC 交換器 ID、彈性網卡和實例 ID 不在同一個可用區。
InvalidOperation.VpcMismatch The VPC of the specified ENI and security group are not in the same VPC. 403 指定的彈性網卡和安全性群組 ID 不在同一個 VPC。
InvalidSecurityGroupId.NotVpc The specified SecurityGroupId not in VPC. 403 指定的安全性群組不是 VPC 類型。
MaxEniCountExceeded The number of ENI exceeds the limit per region. 403 該地域已有的彈性網卡數量超過了最大限制。
SecurityGroupInstanceLimitExceed The maximum number of instances in a security group is exceeded. 403 該安全性群組內已有的實例數量已超出最大限制。
InvalidEcsId.NotFound The specified EcsId is not found. 404 指定的實例 ID 不存在。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId is not found. 404 指定的安全性群組 ID 不存在。
InvalidVSwitchId.NotFound The specified VSwitchId is not found. 404 指定的交換器 ID 不存在。