ModifyNetworkInterfaceAttribute - - Centro de documentación de Alibaba Cloud

Modifica los atributos de una elastic network interface (ENI), como el nombre, la descripción y los security groups de la ENI.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ModifyNetworkInterfaceAttribute	La operación que desea ejecutar. Establezca el valor en ModifyNetworkInterfaceAttribute.
RegionId	String	Sí	cn-hangzhou	El ID de región de la ENI. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
NetworkInterfaceName	String	No	eniTestName	El nombre de la ENI. Debe tener entre 2 y 128 caracteres de longitud, comenzar con una letra y no puede empezar con http:// o https://. Puede contener dígitos, letras, dos puntos (:), guiones bajos (_) y guiones (-). Este parámetro está vacío de forma predeterminada.
NetworkInterfaceId	String	Sí	eni-bp67acfmxazb4p****	El ID de la ENI.
QueueNumber	Integer	No	8	El número de colas que admite la ENI. Valores válidos: de 1 a 2048. Solo puede cambiar el número de colas de las ENI secundarias. Solo puede modificar el número de colas de una ENI secundaria cuando se encuentra en estado `Available` o cuando está asociada (`InUse`) a una instancia en estado `Stopped`. El número de colas de la ENI secundaria no puede superar el máximo permitido por tipo de instancia para cada ENI. Asimismo, el total de colas en todas las ENI de la instancia no debe exceder la cuota de colas admitida por dicho tipo de instancia. Para consultar el número máximo de colas por ENI y la cuota correspondiente al tipo de instancia, llame a la operación DescribeInstanceTypes y revise los valores de `MaximumQueueNumberPerEni` y `TotalEniQueueQuantity` en la respuesta.
Description	String	No	testDescription	La descripción de la ENI. Debe tener entre 2 y 255 caracteres de longitud y no puede comenzar con http:// o https://. Este parámetro está vacío de forma predeterminada.
SecurityGroupId.N	String	No	sg-bp67acfmxazb4p****	El ID del security group N al que se agregará la ENI. Los valores válidos de N dependen del número máximo de security groups a los que se puede agregar una ENI. Para obtener más información, consulte Limits. Solo puede cambiar los security groups a los que está agregada una ENI secundaria. Al especificar este parámetro, la ENI secundaria se agrega a los security groups indicados y se elimina de los originales. Los nuevos security groups surten efecto tras un breve retraso.
DeleteOnRelease	Boolean	No	true	Especifique si se conserva la ENI cuando se libera la instancia asociada. Valores válidos: true false

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
&RegionId=cn-hangzhou
&NetworkInterfaceName=eniTestName
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&Description=testDescription
&SecurityGroupId=["sg-bp67acfmxazb4p****"]
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyNetworkInterfaceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyNetworkInterfaceAttributeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	%s	No se especificó un parámetro obligatorio.
400	UnsupportedParameter	%s	Un parámetro especificado no es compatible.
400	InvalidParameter	%s	Valor de parámetro no válido.
400	InvalidInstanceID.Malformed	%s	Formato de InstanceId no válido.
400	InvalidOperation.InvalidEcsState	%s	Esta operación no se puede ejecutar en la instancia debido a su estado actual.
400	InvalidOperation.InvalidEniState	%s	Esta operación no se puede ejecutar en la ENI debido a su estado actual.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	La ENI no se puede desasociar de la instancia.
400	InvalidParams.EniId	%s	ID de ENI no válido.
400	Forbidden.RegionId	%s	El servicio no está disponible en la región por el momento.
400	JoinedGroupLimitExceed	%s	Se superó el número máximo de security groups a los que se puede agregar el recurso especificado. Para obtener más información, consulte el valor devuelto por el marcador de posición %s en el mensaje de error.
403	InvalidUserType.NotSupported	%s	La cuenta no admite esta operación.
403	Abs.InvalidAccount.NotFound	%s	No se encontró su cuenta de Alibaba Cloud o su par de AccessKey caducó.
403	Forbidden.NotSupportRAM	%s	Los usuarios de Resource Access Management (RAM) no tienen permisos para ejecutar esta operación.
403	Forbidden.SubUser	%s	No tiene acceso al recurso. Póngase en contacto con el propietario de la cuenta de Alibaba Cloud.
403	MaxEniCountExceeded	%s	Se superó el número máximo de ENI que se pueden gestionar.
403	EniPerInstanceLimitExceeded	%s	Se superó el número máximo de ENI que se pueden asociar a la instancia.
403	InvalidOperation.AvailabilityZoneMismatch	%s	La operación no es válida.
403	InvalidOperation.VpcMismatch	%s	La operación no es válida. Compruebe si la virtual private cloud (VPC) indicada en la operación coincide con los demás parámetros.
403	SecurityGroupInstanceLimitExceed	%s	Se alcanzó el número máximo de instancias en el security group.
403	InvalidSecurityGroupId.NotVpc	%s	ID de security group no válido. El tipo de red del security group especificado no es VPC.
403	InvalidOperation.InvalidEniType	%s	Esta operación no se puede ejecutar en este tipo de ENI.
403	InvalidOperation.EniServiceManaged	%s	La operación no es válida.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Los security groups gestionados por servicios en la nube no se pueden modificar.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valor de QueueNumber no válido. Para obtener más información, consulte el valor devuelto por el marcador de posición %s en el mensaje de error.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Se superó el número máximo de colas en la ENI. Para obtener más información, consulte el valor devuelto por el marcador de posición %s en el mensaje de error.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Se superó el número máximo de colas en todas las ENI de una instancia. Para obtener más información, consulte el valor devuelto por el marcador de posición %s en el mensaje de error.
403	AclLimitExceed	%s	Se superó el número máximo de reglas de security group que se pueden aplicar a la ENI o a la instancia.
404	InvalidEcsId.NotFound	%s	No se encontró el ID de la instancia.
404	InvalidEniId.NotFound	%s	No se encontró el ID de la ENI.
404	InvalidVSwitchId.NotFound	%s	No se encontró el ID del vSwitch.
404	InvalidSecurityGroupId.NotFound	%s	No se encontró el ID del security group.
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	Las ENI primarias solo permiten modificar su nombre y descripción.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.