修改一個彈性網卡(ENI)屬性。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:ModifyNetworkInterfaceAttribute |
RegionId | String | 是 | 執行個體所在地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
NetworkInterfaceId | String | 是 | 彈性網卡 ID。 |
SecurityGroupId.N | String | 否 | 安全性群組 ID,新的安全性群組將會覆蓋舊的安全性群組,安全性群組必須跟彈性網卡在同一個 VPC 內。 |
NetworkInterfaceName | String | 否 | 彈性網卡的名稱。
|
Description | String | 否 | 彈性網卡的描述資訊。
|
返回參數
全是公共返回參數。參閱 公共參數。
樣本
請求樣本
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 不存在。 |