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

Crea una interfaz de red elástica (ENI) con compatibilidad para especificar una dirección IP privada principal.

Descripción de la operación

Tenga en cuenta los siguientes puntos al invocar esta operación:

Esta es una operación síncrona. La interfaz de red elástica (ENI) recién creada se encuentra en estado activo (Available) y se puede adjuntar inmediatamente.
Si NetworkInterfaceId está vacío en la respuesta, intente crear la ENI nuevamente.
Una ENI solo se puede adjuntar a una única instancia en una nube privada virtual (VPC).
Cuando una ENI se vuelve a adjuntar a otra instancia, sus propiedades permanecen sin cambios y el tráfico de red se redirige a la nueva instancia.
Al crear una ENI, puede asignar hasta 49 direcciones IP privadas secundarias mediante esta operación.
Al crear una ENI, si desea configurar direcciones IPv6, asegúrese de que IPv6 esté habilitado para el vSwitch especificado. Para obtener más información, consulte ¿Qué es IPv6 Gateway?.
El número de ENI que se pueden crear por cuenta en una región es limitado. Puede ver las cuotas de recursos en la consola de ECS. Para obtener más información, consulte Ver y aumentar las cuotas de recursos.

Ejemplos de solicitud

Crear una interfaz de red elástica (ENI)

RegionId:  cn-hangzhou,   //Establezca la región China (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //Establezca el ID del grupo de seguridad.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //Establezca el ID del vSwitch.

Crear una interfaz de red elástica (ENI) y especificar una dirección IP privada principal

RegionId:  cn-hangzhou,   //Región China (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   //ID del grupo de seguridad.
VSwitchId:  vsw-bp19wo63nleroq22g****,   //ID del vSwitch.
PrimaryIpAddress:  192.168.0.*,   //Dirección IP privada principal.

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:CreateNetworkInterface

create

*NetworkInterface

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

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#vswitchId}

vpc:IsDefaultVSwitch
vpc:IsDefaultVpc
vpc:VPC
vpc:tag
vpc:tag
vpc:tag

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región del controlador de interfaz de red (NIC) que se va a crear. Puede invocar DescribeRegions para consultar la lista más reciente de regiones de Alibaba Cloud.	cn-hangzhou
Tag	array<object>	No	Las etiquetas del controlador de interfaz de red (NIC).
	object	No	La etiqueta del controlador de interfaz de red (NIC).
Key	string	No	La clave de etiqueta del controlador de interfaz de red (NIC). Valores válidos de N: 1 a 20. La clave de etiqueta no puede ser una cadena vacía. La clave de etiqueta puede tener hasta 128 caracteres de longitud y no puede comenzar con aliyun o acs:. No puede contener `http://` ni `https://`.	TestKey
Value	string	No	El valor de etiqueta del controlador de interfaz de red (NIC). Valores válidos de N: 1 a 20. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`.	TestValue
ResourceGroupId	string	No	El ID del grupo de recursos. Puede llamar a ListResourceGroups para consultar la información del grupo de recursos.	rg-bp67acfmxazb4ph****
VSwitchId	string	Sí	El ID del vSwitch del controlador de interfaz de red (NIC). La dirección IP privada de la ENI se asigna desde las direcciones libres dentro del bloque CIDR del vSwitch. Importante El controlador de interfaz de red (NIC) y la instancia a la que desea adjuntar la ENI deben estar en la misma zona, pero pueden pertenecer a diferentes vSwitches.	vsw-bp1s5fnvk4gn2tws03****
PrimaryIpAddress	string	No	La dirección IP privada principal del controlador de interfaz de red (NIC). La dirección IP especificada debe ser una dirección libre dentro del bloque CIDR del vSwitch. Si no especifica este parámetro, se asigna de forma predeterminada una dirección IP privada libre aleatoria en el bloque CIDR del vSwitch.	172.17..
SecurityGroupId	string	No	El ID del grupo de seguridad al que pertenece el controlador de interfaz de red (NIC). El grupo de seguridad y la ENI deben estar en la misma VPC. Nota Al invocar esta operación, debe establecer `SecurityGroupId` o `SecurityGroupIds.N`, pero no ambos.	sg-bp1fg655nh68xyz9i****
NetworkInterfaceName	string	No	El nombre del controlador de interfaz de red (NIC). El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener caracteres de la categorización de letras Unicode (incluidos caracteres en inglés y chino) y dígitos ASCII (0-9). El nombre puede contener dos puntos (:), guiones bajos (_), puntos (.) o guiones (-). Valor predeterminado: vacío.	testNetworkInterfaceName
Description	string	No	La descripción del controlador de interfaz de red (NIC). La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`. Valor predeterminado: vacío.	testDescription
Visible	boolean	No	Nota Este parámetro está obsoleto.	null
InstanceType	string	No	El tipo de la interfaz de red elástica (ENI). Valores válidos: Secondary: ENI secundaria. Trunk: controlador de interfaz de red (NIC) troncal (en vista previa por invitación). Valor predeterminado: Secondary.	Secondary
BusinessType	string	No	Nota Este parámetro está obsoleto.	null
SecondaryPrivateIpAddressCount	integer	No	El número de direcciones IP privadas para creación automática por parte de ECS. Valores válidos: 1 a 49.	1
QueueNumber	integer	No	El número de colas para el controlador de interfaz de red (NIC). Valores válidos: 1 a 2048. Cuando adjunta la ENI a una instancia, el valor debe ser menor que el número máximo de colas por controlador de interfaz de red (NIC) admitido por el tipo de instancia. Puede llamar a DescribeInstanceTypes para consultar el campo `MaximumQueueNumberPerEni`. Valor predeterminado: vacío. Cuando se adjunta la ENI, se utiliza el número de colas predeterminado para el tipo de instancia. Puede llamar a DescribeInstanceTypes para consultar el campo `SecondaryEniQueueNumber`.	1
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero asegúrese de que el token sea único entre diferentes solicitudes. ClientToken solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-426655440000
NetworkInterfaceTrafficMode	string	No	El patrón de comunicación del controlador de interfaz de red (NIC). Valores válidos: Standard: utiliza el patrón de comunicación TCP. HighPerformance: habilita la interfaz RDMA elástica (ERI) y utiliza el patrón de comunicación RDMA. Nota Un controlador de interfaz de red (NIC) en patrón de comunicación RDMA solo se puede adjuntar a una instancia cuyo tipo de instancia admita ERI. El número de ENI en patrón RDMA no puede exceder el límite de la familia de instancias. Para obtener más información, consulte Familias de instancias y Configurar eRDMA en instancias de nivel empresarial. Valor predeterminado: Standard.	Standard
QueuePairNumber	integer	No	El número de colas para la ENI RDMA. Si desea adjuntar múltiples ENI RDMA a una instancia, le recomendamos que especifique manualmente QueuePairNumber para cada ENI según el límite superior de `QueuePairNumber` admitido por el tipo de instancia y el número de ENI que planea utilizar. Asegúrese de que el QueuePairNumber total de todas las ENI no exceda el valor máximo permitido por el tipo de instancia. Llame a DescribeInstanceTypes para consultar el límite superior para el tipo de instancia. Importante Si no se especifica QueuePairNumber para una ENI RDMA, se utiliza de forma predeterminada el límite superior de QueuePairNumber para todas las ENI RDMA admitidas por el tipo de instancia. Por lo tanto, después de adjuntar una ENI RDMA sin un QueuePairNumber especificado, no se pueden agregar más ENI RDMA (las ENI normales no se ven afectadas por este límite).	22
SecurityGroupIds	array	No	Los ID de uno o más grupos de seguridad a los que pertenece el controlador de interfaz de red (NIC). Los grupos de seguridad y la ENI deben estar en la misma VPC. Los valores válidos de N dependen de la cuota para el número máximo de grupos de seguridad a los que puede pertenecer una ENI. Para obtener más información, consulte Límites. Nota Al invocar esta operación, debe establecer `SecurityGroupId` o `SecurityGroupIds.N`, pero no ambos.	sg-bp1fg655nh68xyz9i****
	string	No	Los ID de uno o más grupos de seguridad a los que pertenece el controlador de interfaz de red (NIC). Los grupos de seguridad y la ENI deben estar en la misma VPC. Los valores válidos de N dependen de la cuota para el número máximo de grupos de seguridad a los que puede pertenecer una ENI. Para obtener más información, consulte Límites. Nota Al invocar esta operación, debe establecer `SecurityGroupId` o `SecurityGroupIds.N`, pero no ambos.	sg-bp1fg655nh68xyz9i****
PrivateIpAddress	array	No	Una o más direcciones IP privadas secundarias seleccionadas de las direcciones libres dentro del bloque CIDR del vSwitch al que pertenece el controlador de interfaz de red (NIC). Valores válidos de N: 0 a 10. Nota Al asignar direcciones IP privadas secundarias, no puede especificar el parámetro `PrivateIpAddress.N` y el parámetro `SecondaryPrivateIpAddressCount` al mismo tiempo.	172.17..
	string	No	Una o más direcciones IP privadas secundarias seleccionadas de las direcciones libres dentro del bloque CIDR del vSwitch al que pertenece el controlador de interfaz de red (NIC). Valores válidos de N: 0 a 10. Nota Al asignar direcciones IP privadas secundarias, no puede especificar el parámetro `PrivateIpAddress.N` y el parámetro `SecondaryPrivateIpAddressCount` al mismo tiempo.	172.17..
Ipv6Address	array	No	Una o más direcciones IPv6 para asignar al controlador de interfaz de red (NIC). Puede especificar hasta 10 direcciones IPv6. Valores válidos de N: 1 a 10. Ejemplo: Ipv6Address.1=2001:db8:1234:1a00::** Nota** Si desea establecer direcciones IPv6 para el controlador de interfaz de red (NIC), debe establecer el parámetro `Ipv6Addresses.N` o el parámetro `Ipv6AddressCount`, pero no ambos.	2001:db8:1234:1a00::****
	string	No	Una o más direcciones IPv6 para asignar al controlador de interfaz de red (NIC). Puede especificar hasta 10 direcciones IPv6. Valores válidos de N: 1 a 10. Ejemplo: Ipv6Address.1=2001:db8:1234:1a00::** Nota** Si desea establecer direcciones IPv6 para el controlador de interfaz de red (NIC), debe establecer el parámetro `Ipv6Addresses.N` o el parámetro `Ipv6AddressCount`, pero no ambos.	2001:db8:1234:1a00::****
Ipv6AddressCount	integer	No	El número de direcciones IPv6 para generar aleatoriamente para el controlador de interfaz de red (NIC). Valores válidos: 1 a 10. Nota Si desea establecer direcciones IPv6 para el controlador de interfaz de red (NIC), debe establecer el parámetro `Ipv6Addresses.N` o el parámetro `Ipv6AddressCount`, pero no ambos.	1
Ipv4Prefix	array	No	Uno o más prefijos IPv4 para asignar al controlador de interfaz de red (NIC). Valores válidos de N: 1 a 10. Nota Si desea establecer prefijos IPv4 para el controlador de interfaz de red (NIC), debe establecer el parámetro Ipv4Prefix.N o el parámetro Ipv4PrefixCount, pero no ambos.
	string	No	Uno o más prefijos IPv4 para asignar al controlador de interfaz de red (NIC). Valores válidos de N: 1 a 10. Nota Si desea establecer prefijos IPv4 para el controlador de interfaz de red (NIC), debe establecer el parámetro Ipv4Prefix.N o el parámetro Ipv4PrefixCount, pero no ambos.	192.168../28
Ipv4PrefixCount	integer	No	El número de prefijos IPv4 para asignar al controlador de interfaz de red (NIC). Valores válidos: 1 a 10. Nota Si desea establecer prefijos IPv4 para el controlador de interfaz de red (NIC), debe establecer el parámetro Ipv4Prefix.N o el parámetro Ipv4PrefixCount, pero no ambos.	1
Ipv6Prefix	array	No	Uno o más prefijos IPv6 para asignar al controlador de interfaz de red (NIC). Valores válidos de N: 1 a 10. Nota Si desea establecer prefijos IPv6 para el controlador de interfaz de red (NIC), debe establecer el parámetro Ipv6Prefix.N o el parámetro Ipv6PrefixCount, pero no ambos.
	string	No	Uno o más prefijos IPv6 para asignar al controlador de interfaz de red (NIC). Valores válidos de N: 1 a 10. Nota Si desea establecer prefijos IPv6 para el controlador de interfaz de red (NIC), debe establecer el parámetro Ipv6Prefix.N o el parámetro Ipv6PrefixCount, pero no ambos.	2001:db8:1234:1a00:****::/80
Ipv6PrefixCount	integer	No	El número de prefijos IPv6 para asignar al controlador de interfaz de red (NIC). Valores válidos: 1 a 10. Nota Si desea establecer prefijos IPv6 para el controlador de interfaz de red (NIC), debe establecer el parámetro Ipv6Prefix.N o el parámetro Ipv6PrefixCount, pero no ambos.	1
DeleteOnRelease	boolean	No	Especifica si se debe conservar la ENI cuando se libera la instancia asociada. Valores válidos: true: no conserva la ENI. false: conserva la ENI.	true
TxQueueSize	integer	No	La profundidad de la cola de salida del controlador de interfaz de red (NIC). Tenga en cuenta los siguientes puntos: La profundidad de la cola de salida del controlador de interfaz de red (NIC) debe ser igual a la profundidad de la cola de entrada. Valores válidos: 8192 a 16384. El valor debe ser una potencia de 2. Una mayor profundidad de la cola de salida aumenta el rendimiento de salida, pero consume más memoria. Nota Este parámetro no está disponible públicamente.	8192
RxQueueSize	integer	No	La profundidad de la cola de entrada del controlador de interfaz de red (NIC). Tenga en cuenta los siguientes puntos: La profundidad de la cola de entrada del controlador de interfaz de red (NIC) debe ser igual a la profundidad de la cola de salida. Valores válidos: 8192 a 16384. El valor debe ser una potencia de 2. Una mayor profundidad de la cola de entrada aumenta el rendimiento de entrada, pero consume más memoria. Nota Este parámetro no está disponible públicamente.	8192
NetworkInterfaceTrafficConfig	object	No	El conjunto de parámetros de configuración de tráfico del controlador de interfaz de red (NIC).
QueueNumber	integer	No	El número de colas para el controlador de interfaz de red (NIC).	8
NetworkInterfaceTrafficMode	string	No	El patrón de comunicación del controlador de interfaz de red (NIC).	HighPerformance
QueuePairNumber	integer	No	El número de colas para la ENI RDMA.	8
TxQueueSize	integer	No	La profundidad de la cola de salida del controlador de interfaz de red (NIC). Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente. Si desea utilizar este parámetro, envíe un ticket para solicitar acceso. Tenga en cuenta los siguientes puntos: Este parámetro solo se aplica a tipos de instancias de ECS de séptima generación y posteriores. Actualmente, este parámetro solo se aplica a imágenes de Linux. Una mayor profundidad de la cola de salida del controlador de interfaz de red (NIC) aumenta el rendimiento de salida y reduce la probabilidad de pérdida de paquetes, pero consume más memoria.	8192
RxQueueSize	integer	No	La profundidad de la cola de entrada del controlador de interfaz de red (NIC). Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente. Si desea utilizar este parámetro, envíe un ticket para solicitar acceso. Tenga en cuenta los siguientes puntos: Este parámetro solo se aplica a tipos de instancias de ECS de séptima generación y posteriores. Actualmente, este parámetro solo se aplica a imágenes de Linux. Una mayor profundidad de la cola de entrada del controlador de interfaz de red (NIC) aumenta el rendimiento de entrada y reduce la probabilidad de pérdida de paquetes, pero consume más memoria.	8192
ConnectionTrackingConfiguration	object	No	La configuración de seguimiento de conectividad de red. Antes de utilizar este parámetro, lea Gestión de tiempos de espera de conexión.
TcpEstablishedTimeout	integer	No	El período de tiempo de espera para conexiones TCP establecidas. Unidad: segundos. Valores válidos: [30, 60, 80, 100, 200, 300, 500, 700, 910]. Valor predeterminado: 910.	910
TcpClosedAndTimeWaitTimeout	integer	No	El período de tiempo de espera para conexiones TCP en los estados TIME_WAIT y CLOSED. Unidad: segundos. Valores válidos: números enteros del 3 al 15. Valor predeterminado: 3. Nota Si su instancia de ECS se utiliza con NLB/CLB, el período de tiempo de espera predeterminado para conexiones en estado `TIME_WAIT` es de 15 segundos.	3
UdpTimeout	integer	No	El período de tiempo de espera para flujos UDP. Unidad: segundos. Valores válidos: [10, 20, 30, 60, 80, 100]. Valor predeterminado: 30. Nota Si su instancia de ECS se utiliza con NLB/CLB, el valor predeterminado es de 100 segundos.	30
EnhancedNetwork	object	No	Nota Este parámetro no está disponible públicamente.
EnableSriov	boolean	No	Nota Este parámetro no está disponible públicamente.	true
EnableRss	boolean	No	Nota Este parámetro no está disponible públicamente.	true
VirtualFunctionTotalQueueNumber	integer	No
VirtualFunctionQuantity	integer	No
EnableExpress	boolean	No
SourceDestCheck	boolean	No	Especifica si se debe habilitar la verificación de origen/destino. Le recomendamos habilitar esta función para mejorar la seguridad de la red. Valores válidos: true: habilitado. false: deshabilitado. Valor predeterminado: false. Nota Esta función solo se admite en regiones específicas. Antes de utilizar esta función, lea Verificación de origen/destino.	false
EnablePrimaryIPv6	boolean	No

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Status	string	El estado del controlador de interfaz de red (NIC).	Available
Type	string	El tipo del controlador de interfaz de red (NIC).	Secondary
VpcId	string	El ID de la VPC a la que pertenece la ENI.	vpc-bp1j7w3gc1cexjqd****
NetworkInterfaceName	string	El nombre del controlador de interfaz de red (NIC).	my-eni-name
MacAddress	string	La dirección MAC del controlador de interfaz de red (NIC).	00:16:3e:12::
NetworkInterfaceId	string	El ID del controlador de interfaz de red (NIC).	eni-bp14v2sdd3v8htln****
ServiceID	integer	El ID del operador de red virtual (VNO) al que corresponde el controlador de interfaz de red (NIC).	12345678910
OwnerId	string	El ID de la cuenta propietaria del controlador de interfaz de red (NIC).	123456****
ServiceManaged	boolean	Indica si el usuario del controlador de interfaz de red (NIC) es un servicio de Alibaba Cloud o un VNO.	true
VSwitchId	string	El ID del vSwitch en la VPC.	vsw-bp16usj2p27htro3****
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Description	string	La descripción del controlador de interfaz de red (NIC).	testDescription
ResourceGroupId	string	El ID del grupo de recursos.	rg-2ze88m67qx5z****
ZoneId	string	El ID de la zona.	cn-hangzhou-e
PrivateIpAddress	string	La dirección IP privada del controlador de interfaz de red (NIC).	172.17..
SecurityGroupIds	object
SecurityGroupId	array	Los security groups a los que pertenece la ENI.
	string	El ID del security group.	sg-bp18kz60mefsicfg****
PrivateIpSets	object
PrivateIpSet	array<object>	La colección de objetos PrivateIpSet.
	object
PrivateIpAddress	string	La dirección IP privada de la instancia.	172.17..
Primary	boolean	Indica si la dirección IP es la dirección IP privada principal.	true
Tags	object
Tag	array<object>	Las etiquetas.
	object
TagValue	string	El valor de la etiqueta.	TestValue
TagKey	string	La clave de la etiqueta.	TestKey
Ipv6Sets	object
Ipv6Set	array<object>	Las direcciones IPv6 asignadas al controlador de interfaz de red (NIC).
	object	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
Ipv6Address	string	La dirección IPv6.	2001:db8:1234:1a00::****
Primary	boolean
Ipv4PrefixSets	object
Ipv4PrefixSet	array<object>	Los prefijos IPv4 asignados al controlador de interfaz de red (NIC).
	object
Ipv4Prefix	string	The IPv4 prefix.	192.168../28
Ipv6PrefixSets	object
Ipv6PrefixSet	array<object>	Los prefijos IPv6 asignados al controlador de interfaz de red (NIC).
	object
Ipv6Prefix	string	The IPv6 prefix.	2001:db8:1234:1a00:****::/80
SourceDestCheck	boolean	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.	false

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Status": "Available",
  "Type": "Secondary",
  "VpcId": "vpc-bp1j7w3gc1cexjqd****",
  "NetworkInterfaceName": "my-eni-name",
  "MacAddress": "00:16:3e:12:**:**",
  "NetworkInterfaceId": "eni-bp14v2sdd3v8htln****",
  "ServiceID": 12345678910,
  "OwnerId": "123456****",
  "ServiceManaged": true,
  "VSwitchId": "vsw-bp16usj2p27htro3****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Description": "testDescription",
  "ResourceGroupId": "rg-2ze88m67qx5z****",
  "ZoneId": "cn-hangzhou-e",
  "PrivateIpAddress": "172.17.**.**",
  "SecurityGroupIds": {
    "SecurityGroupId": [
      "sg-bp18kz60mefsicfg****"
    ]
  },
  "PrivateIpSets": {
    "PrivateIpSet": [
      {
        "PrivateIpAddress": "172.17.**.**",
        "Primary": true
      }
    ]
  },
  "Tags": {
    "Tag": [
      {
        "TagValue": "TestValue",
        "TagKey": "TestKey"
      }
    ]
  },
  "Ipv6Sets": {
    "Ipv6Set": [
      {
        "Ipv6Address": "2001:db8:1234:1a00::****",
        "Primary": false
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.**/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "SourceDestCheck": false
}

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.InvalidEcsState	%s	This operation is not allowed in the current cloud service status.
400	InvalidOperation.InvalidEniState	%s	The current state of the ENI does not allow this operation.
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	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	The specified tag key already exists. Tag keys must be unique.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	The specified Tag.N.Key parameter is invalid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	The specified tag value is invalid.
400	JoinedGroupLimitExceed	%s	The maximum number of security groups to which the specified resource can be added has been reached. For more information, see the return value of the %s placeholder in the error message.
400	InvalidParameter.SecurityGroupIdRepeated	%s	The security group ID passed in is duplicate.
400	InvalidSecurityGroupId.SingleIdAndMultiIdConflict	%s
400	InvalidParameter.Conflict	%s	The specified parameter is invalid. Check whether parameter conflicts exist. %s is a variable. An error message is dynamically returned based on call conditions.
400	InvalidConnectionTrackingConfiguration.RegionOrUserNotSupported	The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.	The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.
400	InvalidOperation.EniCountExceeded	%s.	The maximum number of NICs in the Enterprise Security Group has been reached.
400	InvalidPrivateIpAddress.Duplicated	The specified private IP address "%s" is duplicated.	The specified IP address is already in use.
400	IncorrectVSwitchStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".	The operation is not supported in the current state of the vSwitch.
400	InvalidEniQueueSize.RegionOrUserNotSupported	The specified parameter "RxQueueSize" or "TxQueueSize" is not supported in this region or this account is not allowed to use ENI QueueSize.	You are not authorized to specify the length of NIC queues or cannot specify the length of NIC queues in the current region.
400	InvalidParameter.EniQueueSize	The specified parameter "TxQueueSize" and "RxQueueSize" are not equal or the value must be 8192 or 16384.	The specified parameter TxQueueSize and RxQueueSize are not equal or not the allowed value.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specified ENI connection tracking configuration "%s" must be between %s and %s.	The network connection configuration specified by the network card exceeds the allowable range
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.	The current VSwitch does not have enough Ip
400	Throttling	Request was denied due to request throttling.	The request is throttled.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".	The current VSwitch status does not support this operation.
400	InvalidParameter.EniEnhancedNetwork	The input parameter "EnhancedNetwork" is illegal, when EnableSriov is true, VirtualFunctionTotalQueueNumber must not be empty, and VirtualFunctionQuantity must be 1 to 256. When EnableSriov is empty or false, VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty.	The specified network enhancement function parameter is illegal. When the EnableSriov is set to true, the VirtualFunctionTotalQueueNumber must not be empty and the VirtualFunctionQuantity value range is 1-256; When the EnableSriov is empty or set to false, the VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty
400	InvalidOperation.EnablePrimaryIPv6	The specified ENI can not enable primary IPv6 or already has primary IPv6.	The specified ENI can not enable primary IPv6 or already has primary IPv6.
400	InvalidVSwitch.Ipv4NotEnabled	The specify VSwitch of ECS does not support IPv4.
401	InvalidOperation.SecurityGroupNotAuthorized	The specified security group is not authorized to operate.	You do not have permission to operate the current security group.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support IP prefix feature.	The region does not support IP prefix allocation.
500	ServiceUnavailable	The request processing has failed due to some unknown error.	Request timed out, please try again.
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	InValidParameter	%s
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 maximum number of instances in the security group has been reached.
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	This operation is not allowed for the current network interface type.
403	InvalidVSwitchId.IpNotEnough	%s	The number of available IP addresses on the specified vSwitch is insufficient.
403	InvalidVSwitchId.IpInvalid	%s	The specified private IP address is invalid.
403	QuotaExceed.Tags	%s	The number of specified tags exceeds the upper limit. %s is a variable. An error message is dynamically returned based on call conditions.
403	InvalidIp.Address	%s	The IP entered is not in the correct format or is not in the optional CIDR range.
403	InvalidIp.IpRepeated	%s	The specified IP address already exists.
403	MaxEniPrivateIpsCountExceeded	%s	The maximum number of secondary private IP addresses that can be assigned to the specified ENI has been exceeded. For more information, see the return value of the %s placeholder in the error message.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	You cannot modify security groups managed by cloud services.
403	InvalidOperation.TrunkingIsNotAllowed	%s	The trunk network card is not operational.
403	InvalidParameter.InvalidEniQueueNumber	%s	The number of Elastic Network Interface (ENI) queues is incorrect. For more information, see the actual return result of the %s placeholder in the error message.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	The number of Elastic Network Interface (ENI) queues exceeds the upper limit. For more information, see the actual return result of the %s placeholder in the error message.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	The maximum number of queues for all ENIs on an instance has been exceeded. For more information, see the return value of the %s placeholder in the error message.
403	InvalidParameter.EniTrafficMode	%s
403	InvalidOperation.HighPerformanceTrafficModeIsNotAllowed	%s
403	InvalidParameter.QueuePairNumberMustEmpty	%s
403	InvalidParameter.InvalidQueuePairNumber	%s
403	InvalidParams.NetworkInterfaceName	%s
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	The IP address prefix is invalid and is not in the CIDR format.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.	The IP address prefix is invalid and is not in the reserved CIDR block of the vSwitch.
403	InvalidOperation.Ipv4CountExceeded	%s	The operation is valid because the maximum number of IPv4 addresses has been reached.
403	InvalidOperation.Ipv6CountExceeded	%s	The operation is valid because the maximum number of IPv6 addresses has been reached.
403	InvalidOperation.HighPerformanceTrafficModeEniUnsupported	High performance traffic mode does not support the current ENI type. Expected ENI type is "%s" but the current ENI type is "%s".	High performance traffic mode does not support the current ENI type.
403	AclLimitExceed	%s	The number of ACL rules for an ENI or instance exceeds the upper limit.
403	InvalidIp.IpPrefixMaskInvalid	The IP prefix mask %s is illegal which must be between %s and %s.	The IP prefix mask is invalid and is not in the valid range.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified VSwitch does not have enough IP prefixes.	The number of IP prefixes in the specified switch is insufficient.
403	InvalidIp.IpPrefixMaskNotSame	The IP prefixes %s are illegal.The IP prefix mask must be the same.	The IP prefix masks are not the same.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can't associate security group of different types.	The specified instance cannot be added to both a common security group and an enterprise security group. You can call the DescribeSecurityGroups query to specify the type of security group.
403	InvalidOperation.BoundingEniSlaveQuotaExceed	The number of Slave ENIs exceeds the limit of Bond ENI.	The number of Slave ENIs exceeds the limit of Bond ENI.
403	InvalidIp.IpPrefixNotAvailable	The IP prefix is not available.	The IP prefix is not free.
403	InvalidIp.IpPrefixMaskIllegal	The current IP prefix mask is illegal.	Illegal IP prefix mask.
403	InvalidIp.IpPrefixNotStrict	The IP prefix "%s" must be strict CIDR format.	Invalid IP prefix, not strictly cidr.
403	InvalidOperation.NotSupport	The specified region does not support allocating IPv6 when creating ENI.	The specified region does not support allocating IPv6 when creating ENI.
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.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	The specified resource group does not exist.
404	InvalidOperation.MaxEniIpv6IpsCountExceeded	The ipv6 address count exceed limitation.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.	The specified VSwitch does not support IPv6.
404	InvalidOperation.EnableIpv6Failed	The specified VSwitch does not support Ipv6 feature.
404	InvalidOperation.AddressAlreadyAllocated	The specified ipv6 has been already allocated.
404	InvalidOperation.AddressNotInVSwitchCidr	The specified ipv6 does not match VSwitch cidr scope.
404	InvalidOperation.SlaveEniMustHaveBondingEni	Ensure you create the corresponding Bond ENI before creating Slave ENI.	You must create a Bond network card before creating a Slave network card.
404	InvalidOperation.EniTrafficModeNotSupportIpv6	The High Performance(RDMA) traffic mode does not support IPv6.	ENIs that use the RDMA communication mode do not support IPv6.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified VSwitch does not have CIDR reservation.	The specified switch does not have a reserved segment available.

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.