调用ModifyNetworkInterfaceAttribute修改一个弹性网卡（ENI）的名称、描述以及所属安全组等。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | ModifyNetworkInterfaceAttribute |
系统规定参数。取值：ModifyNetworkInterfaceAttribute。 |
| RegionId | String | 是 | cn-hangzhou |
弹性网卡所在地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| NetworkInterfaceName | String | 否 | eniTestName |
弹性网卡的名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。 默认值：空。 |
| NetworkInterfaceId | String | 是 | eni-bp67acfmxazb4p**** |
弹性网卡ID。 |
| QueueNumber | Integer | 否 | 8 |
网卡队列数。取值范围：1~2048。
|
| Description | String | 否 | testDescription |
弹性网卡的描述信息。长度为2~255个英文或中文字符，不能以http://和https://开头。 默认值：空。 |
| SecurityGroupId.N | String | 否 | sg-bp67acfmxazb4p**** |
SecurityGroupId列表。
|
| DeleteOnRelease | Boolean | 否 | true |
释放实例时是否保留网卡。取值范围：
|
返回数据
|
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
请求ID。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceName=eniTestName
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Description=testDescription
&SecurityGroupId=["sg-bp67acfmxazb4p****"]
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 400 | MissingParameter | %s | 缺失参数，请检查参数是否完整。 |
| 400 | UnsupportedParameter | %s | 不支持参数。 |
| 400 | InvalidParameter | %s | 无效的参数。 |
| 400 | InvalidInstanceID.Malformed | %s | 参数 InstanceId 格式错误。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 实例当前的状态不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 弹性网卡当前的状态不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 由于不允许分离网卡，不允许此操作。 |
| 400 | InvalidParams.EniId | %s | 指定的参数 EniId 无效。 |
| 400 | Forbidden.RegionId | %s | 当前地域暂时没有提供该服务。 |
| 400 | JoinedGroupLimitExceed | %s | 指定资源所能加入的安全组数量达到上限。具体信息请参见错误信息%s占位符的实际返回结果。 |
| 403 | InvalidUserType.NotSupported | %s | 您当前的账号不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云账号不存在，或者您的 AccessKey 已经过期。 |
| 403 | Forbidden.NotSupportRAM | %s | 暂不支持RAM用户执行该操作。 |
| 403 | Forbidden.SubUser | %s | 您的账号没有操作此资源的权限，请向主账号申请相关的权限。 |
| 403 | MaxEniCountExceeded | %s | 已超过可以操作的最大弹性网卡数。 |
| 403 | EniPerInstanceLimitExceeded | %s | 实例附加的弹性网卡数量已经达到了最大限度，不能再为实例附加弹性网卡。 |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | 该操作无效。 |
| 403 | InvalidOperation.VpcMismatch | %s | 您的操作无效，请确认该操作中的 VPC 与其它参数是否匹配。 |
| 403 | SecurityGroupInstanceLimitExceed | %s | 该安全组内已有的实例数量已达到最大限制。 |
| 403 | InvalidSecurityGroupId.NotVpc | %s | 参数 SecurityGroupId 无效，该安全组的网络类型不是专有网络。 |
| 403 | InvalidOperation.InvalidEniType | %s | 当前弹性网卡的类型不支持此操作。 |
| 403 | InvalidOperation.EniServiceManaged | %s | 操作无效。 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | 云产品托管的安全组不支持修改操作。 |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | 弹性网卡队列数有误，具体信息请参见错误信息%s占位符的实际返回结果。 |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | 弹性网卡队列数超过上限，具体信息请参见错误信息%s占位符的实际返回结果。 |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | 弹性网卡队列总数超过上限，具体信息请参见错误信息%s占位符的实际返回结果。 |
| 403 | AclLimitExceed | %s | 网卡或实例的安全组规则数量超过限额值。 |
| 404 | InvalidEcsId.NotFound | %s | 指定的实例 ID 不存在。 |
| 404 | InvalidEniId.NotFound | %s | 指定的弹性网卡 ID 不存在。 |
| 404 | InvalidVSwitchId.NotFound | %s | 指定的交换机不存在。 |
| 404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全组 ID 不存在。 |
| 404 | InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc | Primary NetworkInterface is only allowed to modify name and description. | 主网卡仅支持修改网卡名称和描述。 |
访问错误中心查看更多错误码。
腾讯云1折，限时活动，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/150551.html
