DetachNetworkInterface - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Desvincula una interfaz de red elástica (ENI) de una instancia de Elastic Compute Service (ECS).

Descripción de la operación

Tome en cuenta los siguientes puntos:

No puede desvincular la ENI principal de una instancia.
Asegúrese de que la ENI que se va a desvincular esté en estado Detaching (Unbinding) o InUse (Bound).
Asegúrese de que la instancia de la que desea desvincular una ENI esté en estado Running (Running) o Stopped (Stopped).
La operación DetachNetworkInterface es una operación asíncrona. Después de llamar a esta operación para desvincular una ENI, puede verificar el estado o los eventos de la ENI para determinar si se ha desvinculado. La siguiente figura muestra las transiciones entre los estados de la ENI.
- Si la ENI está en estado Detaching, significa que se envió la solicitud de desvinculación y la ENI se está desvinculando de la instancia asociada.
- Si la ENI está en estado Available, significa que la ENI ya se desvinculó de la instancia asociada.
- Si la ENI se queda atascada en el estado Detaching, es posible que no se pueda desvincular de la instancia asociada debido a razones específicas. Por ejemplo, la ENI podría no desvincularse porque el sistema operativo de la instancia no respondió a la solicitud de desvinculación. Si ocurre este problema, puede volver a enviar la solicitud para desvincular la ENI. Si el problema persiste, reinicie la instancia.

Para obtener información sobre ejemplos de cómo llamar a la operación DetachNetworkInterface, consulte Desvincular una ENI de una instancia de ECS.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:DetachNetworkInterface

update

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la ENI.	cn-hangzhou
NetworkInterfaceId	string	Sí	El ID de la ENI.	cn-hangzhou
InstanceId	string	Sí	El ID de la instancia.	eni-bp67acfmxazb4p****
TrunkNetworkInstanceId	string	No	El ID de la ENI troncal. Nota Este parámetro no está disponible para su uso.	i-bp67acfmxazb4p****
		No	El ID de la solicitud.	eni-f8zapqwj1v1j4ia3****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	%s	A parameter is not specified.
400	UnsupportedParameter	%s	The parameter is not supported.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidInstanceID.Malformed	%s	The specified InstanceId parameter is invalid.
400	InvalidOperation.InvalidRegion	%s	The specified RegionId parameter is invalid.
400	InvalidOperation.InvalidEcsState	%s	The current status of the instance does not support this operation.
400	InvalidOperation.InvalidEniState	%s	The current status of the ENI does not allow modifying ENI attributes.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Detaching the primary ENI from an instance is not allowed.
400	Forbidden.RegionId	%s	The service is unavailable in the current region.
400	InvalidParams.EniId	%s	The specified EniId parameter is invalid.
400	InvalidParameter.EniNotBelongEcs	%s	The specified ENI does not belong to the specified ECS instance. For more information, see the actual return result of the %s placeholder in the error message. You can call DescribeInstances to view the ENI IDs attached to the specified ECS instance.
400	InvalidOperation.EniHotPlugNotSupported	The ENI with high-performance traffic mode cannot be hot-plugged. Please stop the ECS instance to which the ENI is attached, and try again.	An ENI with high-performance communication mode enabled does not support hot unplugging. Stop the ECS instance to which the ENI is mounted and try again.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
500	InvalidSecurityGroupId.EniMustHaveSecurityGroup	The specified network card does not have an associated security group.	The specified NIC is not associated with a security group.
403	InvalidUserType.NotSupported	%s	Your account does not support this operation.
403	Abs.InvalidAccount.NotFound	%s	Your Alibaba Cloud account does not exist or your AccessKey pair has expired.
403	Forbidden.NotSupportRAM	%s	RAM users are not authorized to perform this operation.
403	Forbidden.SubUser	%s	You are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization.
403	MaxEniCountExceeded	%s	The maximum number of ENIs that can be managed has been reached.
403	EniPerInstanceLimitExceeded	%s	The maximum number of ENIs that can be attached to the specified instance has been reached.
403	InvalidOperation.AvailabilityZoneMismatch	%s	The operation is invalid.
403	InvalidOperation.VpcMismatch	%s	The operation is invalid. Check whether the VPC in the operation corresponds to other parameters.
403	SecurityGroupInstanceLimitExceed	%s	The number of instances in the security group has reached the maximum limit.
403	InvalidSecurityGroupId.NotVpc	%s	The specified SecurityGroupId parameter is invalid and the network type of the security group is not VPC.
403	InvalidOperation.InvalidEniType	%s	The current type of the Elastic Network Interface (ENI) does not support this operation.
403	InvalidOperation.EniServiceManaged	%s	The operation is invalid.
403	InvalidOperation.EniLinked	%s	The operation is invalid because the current ENI of the instance is associated with other ENIs. You must disassociate the ENI from the other ENIs before you can unbind the ENI from the instance.
403	InvalidInstanceId.NotFound	%s	The specified instance does not exist. Check whether the InstanceId parameter is valid.
403	InvalidOperation.HotPlugNotSupport	%s	The operation is not supported while the specified resource is running. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.InvalidTrunkEniStatus	%s	The current status of the specified trunk-mode ENI does not allow this operation. For more information, see the actual return result in the %s placeholder of the error message.
403	InvalidOperation.TrunkingIsNotAllowed	%s	The trunk network card is not operational.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	The specified instance type does not support trunk mode for Elastic Network Interfaces (ENIs).
403	InvalidParameter.EniNotBelongTrunk	%s	The specified ENI is not in trunk mode. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.EniTypeNotSupportTrunking	%s	The type of the ENI does not support operations related to the trunk mode. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.HasMemberEniAttached	%s	Other ENIs are attached to the ENI that works in trunk mode. For more information, see the return value of the %s placeholder in the error message.
403	InvalidParameter.EniNotBelongEcs	%s
404	InvalidEcsId.NotFound	%s	The specified instance ID does not exist.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	The specified vSwitch does not exist.
404	InvalidSecurityGroupId.NotFound	%s	The specified security group ID does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.