CreateNetworkInterface - - Centro de documentación de Alibaba Cloud

Crea una interfaz de red elástica (ENI).

Notas de uso

Tome en cuenta los siguientes puntos:

Esta operación es síncrona. Una vez creada la ENI, pasa inmediatamente al estado Available y se puede asociar a una instancia de Elastic Compute Service (ECS).
Si el parámetro NetworkInterfaceId está vacío en la respuesta, no se creó ninguna ENI. Vuelva a llamar a la operación para crearla.
Una ENI solo se puede asociar a una única instancia que resida en una Virtual Private Cloud (VPC).
Cuando se desasocia una ENI de una instancia y se asocia a otra, los atributos de la ENI permanecen sin cambios y el tráfico de red se redirige a la nueva instancia.
Al llamar a esta operación para crear una ENI, puede asignar hasta 49 direcciones IP privadas secundarias a la ENI.
Si desea asignar direcciones IPv6 al crear una ENI, asegúrese de que IPv6 esté habilitado en el vSwitch con el que asociará la ENI. Para obtener más información, consulte What is an IPv6 gateway?
Existe un límite de cuota en la cantidad de ENI que se pueden crear por región de Alibaba Cloud y por cuenta. Consulte la cuota en la consola de ECS. Para obtener más información, consulte View and increase resource quotas.

Para consultar ejemplos de cómo llamar a esta operación, consulte Create an ENI.

Depuración

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

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateNetworkInterface	La operación que desea ejecutar. Establezca el valor en CreateNetworkInterface.
RegionId	String	Sí	cn-hangzhou	El ID de la región donde se creará la ENI. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N que se agregará a la ENI. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. La clave de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. La clave de la etiqueta no puede comenzar con acs: ni aliyun.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N que se agregará a la ENI. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. El valor de la etiqueta puede tener hasta 128 caracteres de longitud y no puede contener `http://` ni `https://`. El valor de la etiqueta no puede comenzar con acs:.
ResourceGroupId	String	No	rg-bp67acfmxazb4ph****	El ID del resource group al que se asignará la ENI. Llame a la operación ListResourceGroups para consultar la lista de resource groups más reciente.
VSwitchId	String	Sí	vsw-bp1s5fnvk4gn2tws03****	El ID del vSwitch en la VPC especificada. Las direcciones IP privadas se asignan a la ENI desde el bloque CIDR del vSwitch.
PrimaryIpAddress	String	No	172.17..	La dirección IP privada principal que se asignará a la ENI. La dirección IP especificada debe estar disponible dentro del bloque CIDR del vSwitch. Si no se especifica este parámetro, se asigna aleatoriamente una dirección IP disponible del bloque CIDR del vSwitch.
SecurityGroupId	String	No	sg-bp1fg655nh68xyz9i****	El ID del security group. El security group y la ENI deben pertenecer a la misma VPC. Nota Debe especificar `SecurityGroupId` o `SecurityGroupIds.N`, pero no ambos.
NetworkInterfaceName	String	No	testNetworkInterfaceName	El nombre de la ENI. El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con `http://` ni `https://`. El nombre puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-). Este parámetro está vacío de forma predeterminada.
Description	String	No	testDescription	La descripción de la ENI. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` ni `https://`. Este parámetro está vacío de forma predeterminada.
Visible	Boolean	No	null	Nota Este parámetro ya no se utiliza.
InstanceType	String	No	null	Nota Este parámetro ya no se utiliza.
BusinessType	String	No	null	Nota Este parámetro ya no se utiliza.
SecondaryPrivateIpAddressCount	Integer	No	1	La cantidad de direcciones IP privadas que ECS creará automáticamente. Valores válidos: 1 a 49.
QueueNumber	Integer	No	1	La cantidad de colas compatibles con la ENI. Valores válidos: 1 a 2048. Cuando asocie la ENI a una instancia, asegúrese de que el valor de este parámetro sea menor que la cantidad máxima de colas por ENI permitida para el tipo de instancia. Para consultar la cantidad máxima de colas por ENI permitida para un tipo de instancia, llame a la operación DescribeInstanceTypes y verifique el valor devuelto de `MaximumQueueNumberPerEni`. Este parámetro está vacío de forma predeterminada. Si no especifica este parámetro, se utiliza la cantidad predeterminada de colas por ENI correspondiente al tipo de instancia cuando asocia la ENI a dicha instancia. Para conocer la cantidad predeterminada de colas por ENI de un tipo de instancia, llame a la operación DescribeInstanceTypes y verifique el valor devuelto de `SecondaryEniQueueNumber`.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud. Para obtener más información, consulte How to ensure idempotence.
NetworkInterfaceTrafficMode	String	No	Standard	El modo de comunicación de la ENI. Valores válidos: Standard: utiliza el modo de comunicación TCP. HighPerformance: utiliza el modo de comunicación de acceso directo a memoria remota (RDMA) con Elastic RDMA Interface (ERI) habilitado. Nota El valor HighPerformance solo es compatible con la familia de instancias optimizadas para RDMA c7re. La cantidad máxima de ENI en modo RDMA que se pueden asociar a una instancia c7re depende del tipo de instancia. La familia de instancias c7re se encuentra en vista previa por invitación en Beijing Zone K. Para obtener más información, consulte Overview of instance families. Valor predeterminado: Standard.
QueuePairNumber	Integer	No	22	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
SecurityGroupIds.N	String	No	sg-bp1fg655nh68xyz9i****	El ID del security group N al que se asignará la ENI. El security group y la ENI deben pertenecer a la misma VPC. Los valores válidos de N dependen de la cantidad máxima de security groups a los que se puede asignar una ENI. Para obtener más información, consulte Limits. Nota Debe especificar `SecurityGroupId` o `SecurityGroupIds.N`, pero no ambos.
PrivateIpAddress.N	String	No	172.17..	La dirección IP privada secundaria N que se asignará a la ENI. Esta dirección IP debe estar disponible dentro del bloque CIDR del vSwitch con el que se asociará la ENI. Valores válidos de N: 0 a 10. Nota Para asignar direcciones IP privadas secundarias a la ENI, debe especificar los parámetros `PrivateIpAddress.N` o `SecondaryPrivateIpAddressCount`, pero no ambos.
Ipv6Address.N	String	No	2001:db8:1234:1a00::****	La dirección IPv6 N que se asignará a la ENI. Valores válidos de N: 1 a 10. Ejemplo: Ipv6Address.1=2001:db8:1234:1a00::** Nota** Para asignar direcciones IPv6 a la ENI, debe especificar `Ipv6Addresses.N` o `Ipv6AddressCount`, pero no ambos.
Ipv6AddressCount	Integer	No	1	La cantidad de direcciones IPv6 generadas aleatoriamente que se asignarán a la ENI. Valores válidos: 1 a 10. Nota Para asignar direcciones IPv6 a la ENI, debe especificar `Ipv6Addresses.N` o `Ipv6AddressCount`, pero no ambos.
Ipv4Prefix.N	String	No	192.168../28	El prefijo IPv4 N que se asignará a la ENI. Valores válidos de N: 1 a 10. Nota Para asignar prefijos IPv4 a la ENI, debe especificar Ipv4Prefix.N o Ipv4PrefixCount, pero no ambos.
Ipv4PrefixCount	Integer	No	1	La cantidad de prefijos IPv4 que se asignarán a la ENI. Valores válidos: 1 a 10. Nota Para asignar prefijos IPv4 a la ENI, debe especificar Ipv4Prefix.N o Ipv4PrefixCount, pero no ambos.
Ipv6Prefix.N	String	No	2001:db8:1234:1a00:****::/80	El prefijo IPv6 N que se asignará a la ENI. Valores válidos de N: 1 a 10. Nota Para asignar prefijos IPv6 a la ENI, debe especificar Ipv6Prefix.N o Ipv6PrefixCount, pero no ambos.
Ipv6PrefixCount	Integer	No	1	La cantidad de prefijos IPv6 que se asignarán a la ENI. Valores válidos: 1 a 10. Nota Para asignar prefijos IPv6 a la ENI, debe especificar Ipv6Prefix.N o Ipv6PrefixCount, pero no ambos.
DeleteOnRelease	Boolean	No	true	Especifica si se debe liberar la ENI cuando se libera la instancia asociada. Valores válidos: true false

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Status	String	Available	El estado de la ENI.
Type	String	Secondary	El tipo de la ENI.
VpcId	String	vpc-bp1j7w3gc1cexjqd****	El ID de la VPC a la que pertenece la ENI.
NetworkInterfaceName	String	my-eni-name	El nombre de la ENI.
MacAddress	String	00:16:3e:12::	La dirección de control de acceso a medios (MAC) de la ENI.
NetworkInterfaceId	String	eni-bp14v2sdd3v8htln****	El ID de la ENI.
ServiceID	Long	12345678910	El ID del distribuidor al que pertenece la ENI.
OwnerId	String	123456****	El ID de la cuenta a la que pertenece la ENI.
ServiceManaged	Boolean	true	Indica si el usuario de la ENI es un servicio de Alibaba Cloud o un distribuidor.
VSwitchId	String	vsw-bp16usj2p27htro3****	El ID del vSwitch.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
Description	String	testDescription	La descripción de la ENI.
ResourceGroupId	String	rg-2ze88m67qx5z****	El ID del resource group al que pertenece la ENI.
ZoneId	String	cn-hangzhou-e	El ID de zona de la ENI.
PrivateIpAddress	String	172.17..	La dirección IP privada de la ENI.
SecurityGroupIds	Array of String	sg-bp18kz60mefsicfg****	Los ID de los security groups a los que pertenece la ENI.
PrivateIpSets	Array of PrivateIpSet		Las direcciones IP privadas de la ENI.
PrivateIpSet
PrivateIpAddress	String	172.17..	La dirección IP privada de la ENI.
Primary	Boolean	true	Indica si la dirección IP es la dirección IP privada principal.
Tags	Array of Tag		Las etiquetas de la ENI.
Tag
TagValue	String	TestValue	El valor de la etiqueta de la ENI.
TagKey	String	TestKey	La clave de la etiqueta de la ENI.
Ipv6Sets	Array of Ipv6Set		Las direcciones IPv6 asignadas a la ENI.
Ipv6Set
Ipv6Address	String	2001:db8:1234:1a00::****	La dirección IPv6 asignada a la ENI.
Ipv4PrefixSets	Array of Ipv4PrefixSet		Los prefijos IPv4 asignados a la ENI.
Ipv4PrefixSet
Ipv4Prefix	String	192.168../28	El prefijo IPv4 asignado a la ENI.
Ipv6PrefixSets	Array of Ipv6PrefixSet		Los prefijos IPv6 asignados a la ENI.
Ipv6PrefixSet
Ipv6Prefix	String	2001:db8:1234:1a00:****::/80	El prefijo IPv6 asignado a la ENI.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=CreateNetworkInterface
&RegionId=cn-hangzhou
&SecurityGroupIds.1=sg-bp18kz60mefsicfg****
&VSwitchId=vsw-bp1s5fnvk4gn2tws03****
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&ResourceGroupId=rg-bp67acfmxazb4ph****
&PrimaryIpAddress=172.17.**.**
&NetworkInterfaceName=testNetworkInterfaceName
&Description=testDescription
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6AddressCount=1
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<CreateNetworkInterfaceResponse>
    <Description>testDescription</Description>
    <Status>Available</Status>
    <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
    <ServiceManaged>false</ServiceManaged>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <ResourceGroupId>rg-2ze88m67qx5z****</ResourceGroupId>
    <ZoneId>cn-hangzhou-e</ZoneId>
    <VSwitchId>vsw-bp16usj2p27htro3****</VSwitchId>
    <NetworkInterfaceName>my-eni-name</NetworkInterfaceName>
    <MacAddress>00:16:3e:12:**:**</MacAddress>
    <NetworkInterfaceId>eni-bp14v2sdd3v8htln****</NetworkInterfaceId>
    <SecurityGroupIds>
        <SecurityGroupId>sg-bp18kz60mefsicfg****</SecurityGroupId>
    </SecurityGroupIds>
    <Type>Secondary</Type>
    <Ipv6Sets>
        <Ipv6Set>
            <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
        </Ipv6Set>
    </Ipv6Sets>
    <VpcId>vpc-bp1j7w3gc1cexjqd****</VpcId>
    <OwnerId>123456****</OwnerId>
    <Tags>
        <Tag>
            <TagKey>TestKey</TagKey>
            <TagValue>TestValue</TagValue>
        </Tag>
    </Tags>
    <PrivateIpSets>
        <PrivateIpSet>
            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
            <Primary>true</Primary>
        </PrivateIpSet>
    </PrivateIpSets>
</CreateNetworkInterfaceResponse>

Formato JSON

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

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

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 realizar en la instancia en su estado actual.
400	InvalidOperation.InvalidEniState	%s	Esta operación no se puede realizar en la ENI en su estado actual.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	La ENI principal no se puede desasociar de la instancia.
400	Forbidden.RegionId	%s	El servicio no está disponible en la región por el momento.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clave de la etiqueta ya existe. Las claves de etiqueta deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key no válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value no válido.
400	InvalidOperation.EniCountExceeded	The maximum number of eni in a enterprise security group is exceeded.	Se superó la cantidad máxima de ENI en el security group avanzado.
400	IncorrectVSwitchStatus	The current status of vSwitch does not support this operation.	La operación no se puede realizar en el vSwitch en su estado actual.
400	JoinedGroupLimitExceed	%s	Se superó la cantidad máxima de security groups a los que se puede asignar el recurso especificado. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.	La dirección IP privada especificada ya está en uso. Pruebe con una dirección IP diferente.
400	InvalidParameter.Conflict	%s	Valor de parámetro no válido. Compruebe si existen conflictos de parámetros. %s es una variable. Se devuelve un mensaje de error dinámicamente según las condiciones de la llamada.
400	IncorrectVSwitchStatus	The current status of virtual switch does not support this operation.	El vSwitch especificado está en estado Pending y no se puede eliminar.
403	InvalidUserType.NotSupported	%s	Su cuenta no admite esta operación.
403	Abs.InvalidAccount.NotFound	%s	No se encontró su cuenta de Alibaba Cloud o su par de AccessKey ha caducado.
403	Forbidden.NotSupportRAM	%s	Los usuarios de Resource Access Management (RAM) no tienen permisos para realizar 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ó la cantidad máxima de ENI que se pueden gestionar.
403	EniPerInstanceLimitExceeded	%s	Se superó la cantidad máxima 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 VPC en la operación corresponde a otros parámetros.
403	SecurityGroupInstanceLimitExceed	%s	Se superó la cantidad máxima de instancias en el security group especificado.
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 realizar en este tipo de ENI.
403	InvalidVSwitchId.IpNotEnough	%s	La cantidad de direcciones IP disponibles en el vSwitch especificado es insuficiente.
403	InvalidVSwitchId.IpInvalid	%s	Dirección IP privada no válida.
403	QuotaExceed.Tags	%s	Se superó la cantidad máxima de etiquetas. %s es una variable. Se devuelve un mensaje de error dinámicamente según las condiciones de la llamada.
403	InvalidIp.IpRepeated	%s	La dirección IP ya existe.
403	MaxEniPrivateIpsCountExceeded	%s	Se superó la cantidad máxima de direcciones IP privadas secundarias que se pueden asignar a la ENI especificada. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	No puede modificar security groups gestionados por servicios en la nube.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valor de QueueNumber no válido. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Se superó la cantidad máxima de colas por ENI. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Se superó la cantidad máxima de colas para todas las ENI en una instancia. Para obtener más información, consulte el valor devuelto del marcador de posición %s en el mensaje de error.
403	InvalidIp.IpPrefixMaskNotSame	The ip prefixes %s are illegal which mask must be same.	Las máscaras de prefijo IP no son iguales.
403	InvalidIp.IpPrefixMaskInvalid	The ip prefixes mask %s is illegal which must be between %s and %s.	La máscara de prefijo IP no es válida y no se encuentra dentro del rango permitido.
403	InvalidIp.IpPrefixMaskIllegal	The ip prefix mask is illegal.	La máscara de prefijo IP no es válida.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	El prefijo IP no es válido y no tiene formato CIDR.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.	El prefijo IP no es válido y no se encuentra en el bloque CIDR reservado del vSwitch.
403	InvalidIp.IpPrefixNotAvailable	The ip prefix is/are not available.	El prefijo IP no está disponible.
403	InvalidIp.IpPrefixNotStrict	The ip prefix must be strict cidr format.	El prefijo IP no es válido y no tiene formato CIDR estricto.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified vSwitch has not enough ip prefix.	La cantidad de prefijos IP en el vSwitch especificado es insuficiente.
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	El ID de security group especificado no existe.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	El resource group no existe.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.	El vSwitch especificado no es compatible con IPv6.
404	InvalidOperation.AddressAlreadyAllocated	The specified ip address has been already allocated.	La dirección IP ya está en uso.
404	InvalidOperation.SlaveEniMustHaveBondingEni	Create slave eni must have bonding eni first.	Debe crear ENI de enlace antes de poder crear ENI secundarias.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified vSwitch has no cidr reservation.	No hay ningún bloque CIDR reservado disponible para el vSwitch especificado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Inténtelo de nuevo más tarde.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support ip prefix.	No se pueden asignar prefijos IP en la región.

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