修改一個彈性網卡(ENI)屬性。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ModifyNetworkInterfaceAttribute
RegionId String 執行個體所在地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
NetworkInterfaceId String 彈性網卡 ID。
SecurityGroupId.N String 安全性群組 ID,新的安全性群組將會覆蓋舊的安全性群組,安全性群組必須跟彈性網卡在同一個 VPC 內。
NetworkInterfaceName String 彈性網卡的名稱。
  • 字元長度為 [2, 128] 個英文或中文字元,必須以大小字母或中文開頭,可包含數字、底線(_) 或連字號(-)。
  • 彈性網卡名稱會展示在控制台。
  • 不能以 http:// 和 https:// 開頭。
  • 不填則為空,預設值為空。
Description String 彈性網卡的描述資訊。
  • 字元長度為 [2, 256] 個英文或中文字元。
  • 不能以 http:// 和 https:// 開頭。
  • 不填則為空,預設值為空。

返回參數

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

樣本

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

XML 格式

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

錯誤碼

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

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
UnsupportedParameter The parameters is unsupported. 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 使用者執行該操作。
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。
SecurityGroupInstanceLimitExceed The maximum number of instances in a security group is exceeded. 403 該安全性群組內已有的執行個體數量已超出最大限制。
InvalidSecurityGroupId.NotVpc The specified SecurityGroupId not in VPC. 403 指定的安全性群組 ID 不是 VPC 類型。
InvalidOperation.InvalidEniType The operation is not allowed in the current ENI type. 403 當前彈性網卡類型不支援該操作。
InvalidVSwitchId.NotFound The specified VSwitchId is not found. 404 指定的交換器 ID 不存在。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId is not found. 404 指定的安全性群組 ID 不存在。