调用 ModifyNetworkInterfaceAttributes 接口，修改网卡的名称、描述、安全组、源/目的地址检查、随云服务器实例删除等信息。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | ModifyNetworkInterfaceAttributes | 要执行的操作。取值：ModifyNetworkInterfaceAttributes。 |
| Version | String | 是 | 2020-04-01 | API版本信息，取值为：2020-04-01。 |
NetworkInterfaceId | String | 是 | eni-bp1fgnh68xyz9**** | 网卡ID。 |
NetworkInterfaceName | String | 否 | eni-1 | 网卡的名称。
|
Description | String | 否 | eni-1-description | 网卡的描述信息。
|
SecurityGroupIds.N | String | 否 | SecurityGroupIds.1=sg-3cj59dpb0msxs6c6rrt1u****&SecurityGroupIds.2=sg-3fjrkjffjg34krrj0e**** | 网卡加入的安全组列表。
|
PortSecurityEnabled | Boolean | 否 | false | 是否为网卡开启源/目的地址检查。 开启后，系统会自动阻止源地址或目的地址不是当前网卡的流量。
|
DeleteOnTermination | Boolean | 否 | false | 是否开启随云服务器实例删除。
|
参数名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | 2021062415303301022514515207C4**** | 请求ID。 |
GET /?Action=ModifyNetworkInterfaceAttributes&Version=2020-04-01&NetworkInterfaceId=eni-bp1fgnh68xyz9****&NetworkInterfaceName=ENI_1 HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "2021062415303301022514515207C4****", "Action": "ModifyNetworkInterfaceAttributes", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result": { "RequestId": "2021062415303301022514515207C4****" } }
此处仅展示当前API的错误码，更多错误码请参见公共错误码。
HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidDescription.Malformed | The specified description is malformed. Ensure the maximum length of description is 255. | 指定的描述格式不合法。描述长度不能超过255个字符。 |
| 400 | InvalidDescription.Malformed | The specified description is malformed. | 指定的描述格式不合法。请修复描述格式后重试。 |
| 400 | InvalidEni.InvalidStatus | The specified elastic network interface is not in the correct status for the request. | 指定的弹性网卡所处的状态无法响应该请求。 |
| 400 | InvalidName.Malformed | The specified name is malformed. Ensure the maximum length of name is 128. | 指定的名称格式不合法。名称长度不能超过128个字符。 |
| 400 | InvalidName.Malformed | The specified name is malformed. | 指定的名称格式不合法。请修复名称格式后重试。 |
| 400 | InvalidSecurityGroup.InvalidStatus | The specified security group is not in the correct status for the request. | 指定的安全组所处的状态无法响应该请求。 |
| 400 | InvalidSecurityGroup.VpcMismatch | The specified security group and elastic network interface are not in the same VPC. | 指定的安全组和弹性网卡不在同一个VPC。 |
| 400 | QuotaExceeded.EniSecurityGroup | You've reached the limit on the number of elastic network interfaces that a security group can associate. | 已达到安全组可关联的弹性网卡数量上限。 |
| 400 | QuotaExceeded.SecurityGroup | The number of security groups bound to the ENI exceeded quota. | 已达到当前网卡可绑定安全组的数量上限。 |
| 400 | QuotaExceeded.SecurityGroupIp | The number of IP addresses bound to the security group exceeded quota. | 已达到安全组可绑定IP地址的数量上限。 |
| 403 | Forbidden | You are not authorized to perform operations on ESI related resources. | 无权限操作弹性预约实例关联资源。 |
| 403 | Forbidden | You are not authorized to perform operations on the specified elastic network interface. The specified elastic network interface is a service-managed elastic network interface. | 无权限对指定弹性网卡进行操作。指定的弹性网卡为云产品托管的弹性网卡。 |
| 403 | Forbidden | You are not authorized to perform operations on the specified security group. The specified security group is a service-managed security group. | 无权限对指定安全组进行操作。指定的安全组为云产品托管的安全组。 |
| 403 | Forbidden | You are not authorized to perform operations on the specified ENI. Only ENI attached to an ECS instance is supported. | 无权限对指定弹性网卡进行操作。只有挂载到ECS的网卡才能修改绑定信息。 |
| 404 | InvalidEniId.NotFound | The specified elastic network interface does not exist. | 指定的弹性网卡不存在。 |
| 404 | InvalidSecurityGroupId.NotFound | The specified security group does not exist. | 指定的安全组不存在。 |
| 409 | InvalidSecurityGroupId.Conflict | The specified security group is duplicated with another security group associated with the same elastic network interface. | 指定的安全组已关联至该网卡，无法重复绑定。 |