CreateNetworkInterface - : Central de Documentação do Alibaba Cloud

Cria uma interface de rede elástica (ENI).

Observações de uso

Observe os seguintes pontos:

Esta é uma operação síncrona. Após a criação, a ENI entra imediatamente no estado Available (Disponível) e pode ser associada a uma instância do Elastic Compute Service (ECS).
Se o parâmetro NetworkInterfaceId estiver vazio na resposta, nenhuma ENI foi criada. Chame a operação novamente para criar a ENI.
Uma ENI só pode ser associada a uma única instância em uma Virtual Private Cloud (VPC).
Ao desassociar uma ENI de uma instância e associá-la a outra, os atributos da ENI permanecem inalterados e o tráfego de rede é redirecionado para a nova instância.
Ao chamar esta operação para criar uma ENI, você pode atribuir até 49 endereços IP privados secundários à interface.
Para atribuir endereços IPv6 durante a criação da ENI, verifique se o IPv6 está ativado no vSwitch ao qual a ENI será associada. Para mais informações, consulte O que é um gateway IPv6?
Há uma cota para o número de ENIs criadas por conta em cada região da Alibaba Cloud. Visualize a cota no console do ECS. Para mais informações, consulte Visualizar e aumentar cotas de recursos.

Para obter exemplos de como chamar esta operação, consulte Criar uma ENI.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CreateNetworkInterface	A operação a ser executada. Defina o valor como CreateNetworkInterface.
RegionId	String	Sim	cn-hangzhou	O ID da região onde a ENI será criada. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
Tag.N.Key	String	Não	TestKey	A chave da tag N a ser adicionada à ENI. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 128 caracteres e não deve conter `http://` ou `https://`. Além disso, não pode começar com acs: ou aliyun.
Tag.N.Value	String	Não	TestValue	O valor da tag N a ser adicionado à ENI. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 128 caracteres e não deve conter `http://` ou `https://`. Também não pode começar com acs:.
ResourceGroupId	String	Não	rg-bp67acfmxazb4ph****	O ID do grupo de recursos ao qual a ENI será atribuída. Chame a operação ListResourceGroups para consultar a lista de grupos de recursos mais recente.
VSwitchId	String	Sim	vsw-bp1s5fnvk4gn2tws03****	O ID do vSwitch na VPC especificada. Os endereços IP privados são atribuídos à ENI dentro do bloco CIDR do vSwitch.
PrimaryIpAddress	String	Não	172.17..	O endereço IP privado primário a ser atribuído à ENI. O endereço IP especificado deve estar disponível dentro do bloco CIDR do vSwitch. Se este parâmetro não for especificado, um endereço IP disponível será atribuído aleatoriamente dentro do bloco CIDR do vSwitch.
SecurityGroupId	String	Não	sg-bp1fg655nh68xyz9i****	O ID do grupo de segurança. O grupo de segurança e a ENI devem pertencer à mesma VPC. Nota Especifique `SecurityGroupId` ou `SecurityGroupIds.N`, mas não ambos.
NetworkInterfaceName	String	Não	testNetworkInterfaceName	O nome da ENI. Deve ter entre 2 e 128 caracteres. Precisa começar com uma letra e não pode iniciar com `http://` ou `https://`. Pode conter letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-). Este parâmetro está vazio por padrão.
Description	String	Não	testDescription	A descrição da ENI. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`. Este parâmetro está vazio por padrão.
Visible	Boolean	Não	null	Nota Este parâmetro não é mais utilizado.
InstanceType	String	Não	null	Nota Este parâmetro não é mais utilizado.
BusinessType	String	Não	null	Nota Este parâmetro não é mais utilizado.
SecondaryPrivateIpAddressCount	Integer	Não	1	A quantidade de endereços IP privados a serem criados automaticamente pelo ECS. Valores válidos: 1 a 49.
QueueNumber	Integer	Não	1	O número de filas suportadas pela ENI. Valores válidos: 1 a 2048. Ao associar a ENI a uma instância, garanta que o valor deste parâmetro seja menor que o número máximo de filas por ENI permitido para o tipo de instância. Para verificar o limite de filas por ENI de um tipo de instância, chame a operação DescribeInstanceTypes e verifique o valor retornado de `MaximumQueueNumberPerEni`. Este parâmetro está vazio por padrão. Se não for especificado, o número padrão de filas por ENI do tipo de instância será usado durante a associação. Para conhecer o valor padrão de filas por ENI de um tipo de instância, chame a operação DescribeInstanceTypes e verifique o valor retornado de `SecondaryEniQueueNumber`.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Gere o token no cliente, assegurando que seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.
NetworkInterfaceTrafficMode	String	Não	Standard	O modo de comunicação da ENI. Valores válidos: Standard: utiliza o modo de comunicação TCP. HighPerformance: utiliza o modo de comunicação RDMA (Remote Direct Memory Access) com a Elastic RDMA Interface (ERI) ativada. Nota O valor HighPerformance é suportado apenas pela família de instâncias aprimoradas para RDMA c7re. O número máximo de ENIs em modo RDMA associáveis a uma instância c7re depende do tipo de instância. A família c7re está em prévia por convite na Zona K de Pequim. Para mais informações, consulte Visão geral das famílias de instâncias. Valor padrão: Standard.
QueuePairNumber	Integer	Não	22	Nota Este parâmetro está em prévia por convite e não está disponível publicamente.
SecurityGroupIds.N	String	Não	sg-bp1fg655nh68xyz9i****	O ID do grupo de segurança N ao qual a ENI será atribuída. O grupo de segurança e a ENI devem pertencer à mesma VPC. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais uma ENI pode ser atribuída. Para mais informações, consulte Limites. Nota Especifique `SecurityGroupId` ou `SecurityGroupIds.N`, mas não ambos.
PrivateIpAddress.N	String	Não	172.17..	O endereço IP privado secundário N a ser atribuído à ENI. Este endereço deve estar disponível dentro do bloco CIDR do vSwitch ao qual a ENI será associada. Valores válidos de N: 0 a 10. Nota Para atribuir endereços IP privados secundários à ENI, especifique os parâmetros `PrivateIpAddress.N` ou `SecondaryPrivateIpAddressCount`, mas não ambos.
Ipv6Address.N	String	Não	2001:db8:1234:1a00::****	O endereço IPv6 N a ser atribuído à ENI. Valores válidos de N: 1 a 10. Exemplo: Ipv6Address.1=2001:db8:1234:1a00::** Nota** Para atribuir endereços IPv6 à ENI, especifique `Ipv6Addresses.N` ou `Ipv6AddressCount`, mas não ambos.
Ipv6AddressCount	Integer	Não	1	A quantidade de endereços IPv6 gerados aleatoriamente a serem atribuídos à ENI. Valores válidos: 1 a 10. Nota Para atribuir endereços IPv6 à ENI, especifique `Ipv6Addresses.N` ou `Ipv6AddressCount`, mas não ambos.
Ipv4Prefix.N	String	Não	192.168../28	O prefixo IPv4 N a ser atribuído à ENI. Valores válidos de N: 1 a 10. Nota Para atribuir prefixos IPv4 à ENI, especifique Ipv4Prefix.N ou Ipv4PrefixCount, mas não ambos.
Ipv4PrefixCount	Integer	Não	1	A quantidade de prefixos IPv4 a serem atribuídos à ENI. Valores válidos: 1 a 10. Nota Para atribuir prefixos IPv4 à ENI, especifique Ipv4Prefix.N ou Ipv4PrefixCount, mas não ambos.
Ipv6Prefix.N	String	Não	2001:db8:1234:1a00:****::/80	O prefixo IPv6 N a ser atribuído à ENI. Valores válidos de N: 1 a 10. Nota Para atribuir prefixos IPv6 à ENI, especifique Ipv6Prefix.N ou Ipv6PrefixCount, mas não ambos.
Ipv6PrefixCount	Integer	Não	1	A quantidade de prefixos IPv6 a serem atribuídos à ENI. Valores válidos: 1 a 10. Nota Para atribuir prefixos IPv6 à ENI, especifique Ipv6Prefix.N ou Ipv6PrefixCount, mas não ambos.
DeleteOnRelease	Boolean	Não	true	Define se a ENI deve ser liberada quando a instância associada for liberada. Valores válidos: true false

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Status	String	Available	O status da ENI.
Type	String	Secondary	O tipo da ENI.
VpcId	String	vpc-bp1j7w3gc1cexjqd****	O ID da VPC à qual a ENI pertence.
NetworkInterfaceName	String	my-eni-name	O nome da ENI.
MacAddress	String	00:16:3e:12::	O endereço MAC (Media Access Control) da ENI.
NetworkInterfaceId	String	eni-bp14v2sdd3v8htln****	O ID da ENI.
ServiceID	Long	12345678910	O ID do distribuidor ao qual a ENI pertence.
OwnerId	String	123456****	O ID da conta à qual a ENI pertence.
ServiceManaged	Boolean	true	Indica se o usuário da ENI é um serviço da Alibaba Cloud ou um distribuidor.
VSwitchId	String	vsw-bp16usj2p27htro3****	O ID do vSwitch.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.
Description	String	testDescription	A descrição da ENI.
ResourceGroupId	String	rg-2ze88m67qx5z****	O ID do grupo de recursos ao qual a ENI pertence.
ZoneId	String	cn-hangzhou-e	O ID da zona da ENI.
PrivateIpAddress	String	172.17..	O endereço IP privado da ENI.
SecurityGroupIds	Array of String	sg-bp18kz60mefsicfg****	Os IDs dos grupos de segurança aos quais a ENI pertence.
PrivateIpSets	Array of PrivateIpSet		Os endereços IP privados da ENI.
PrivateIpSet
PrivateIpAddress	String	172.17..	O endereço IP privado da ENI.
Primary	Boolean	true	Indica se o endereço IP é o endereço IP privado primário.
Tags	Array of Tag		As tags da ENI.
Tag
TagValue	String	TestValue	O valor da tag da ENI.
TagKey	String	TestKey	A chave da tag da ENI.
Ipv6Sets	Array of Ipv6Set		Os endereços IPv6 atribuídos à ENI.
Ipv6Set
Ipv6Address	String	2001:db8:1234:1a00::****	O endereço IPv6 atribuído à ENI.
Ipv4PrefixSets	Array of Ipv4PrefixSet		Os prefixos IPv4 atribuídos à ENI.
Ipv4PrefixSet
Ipv4Prefix	String	192.168../28	O prefixo IPv4 atribuído à ENI.
Ipv6PrefixSets	Array of Ipv6PrefixSet		Os prefixos IPv6 atribuídos à ENI.
Ipv6PrefixSet
Ipv6Prefix	String	2001:db8:1234:1a00:****::/80	O prefixo IPv6 atribuído à ENI.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

XML formato

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>

JSON formato

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	MissingParameter	%s	Um parâmetro obrigatório não foi especificado.
400	UnsupportedParameter	%s	Um parâmetro especificado não é suportado.
400	InvalidParameter	%s	Valor de parâmetro inválido.
400	InvalidInstanceID.Malformed	%s	Formato de InstanceId inválido.
400	InvalidOperation.InvalidEcsState	%s	Esta operação não pode ser executada na instância no estado atual.
400	InvalidOperation.InvalidEniState	%s	Esta operação não pode ser executada na ENI no estado atual.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	A ENI primária não pode ser desassociada da instância.
400	Forbidden.RegionId	%s	O serviço está indisponível na região no momento.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves de tag devem ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value inválido.
400	InvalidOperation.EniCountExceeded	The maximum number of eni in a enterprise security group is exceeded.	O número máximo de ENIs no grupo de segurança avançado foi excedido.
400	IncorrectVSwitchStatus	The current status of vSwitch does not support this operation.	A operação não pode ser executada no vSwitch no estado atual.
400	JoinedGroupLimitExceed	%s	O número máximo de grupos de segurança aos quais o recurso especificado pode ser atribuído foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.	O endereço IP privado especificado já está em uso. Tente um endereço IP diferente.
400	InvalidParameter.Conflict	%s	Valor de parâmetro inválido. Verifique se existem conflitos de parâmetros. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
400	IncorrectVSwitchStatus	The current status of virtual switch does not support this operation.	O vSwitch especificado está no estado Pending e não pode ser excluído.
403	InvalidUserType.NotSupported	%s	Sua conta não suporta esta operação.
403	Abs.InvalidAccount.NotFound	%s	Sua conta Alibaba Cloud não foi encontrada ou seu par AccessKey expirou.
403	Forbidden.NotSupportRAM	%s	Usuários do Resource Access Management (RAM) não têm permissão para executar esta operação.
403	Forbidden.SubUser	%s	Você não tem acesso ao recurso. Entre em contato com o proprietário da conta Alibaba Cloud.
403	MaxEniCountExceeded	%s	O número máximo de ENIs que podem ser gerenciadas foi excedido.
403	EniPerInstanceLimitExceeded	%s	O número máximo de ENIs que podem ser associadas à instância foi excedido.
403	InvalidOperation.AvailabilityZoneMismatch	%s	A operação é inválida.
403	InvalidOperation.VpcMismatch	%s	A operação é inválida. Verifique se a VPC na operação corresponde aos outros parâmetros.
403	SecurityGroupInstanceLimitExceed	%s	O número máximo de instâncias no grupo de segurança especificado foi excedido.
403	InvalidSecurityGroupId.NotVpc	%s	ID de grupo de segurança inválido. O tipo de rede do grupo de segurança especificado não é VPC.
403	InvalidOperation.InvalidEniType	%s	Esta operação não pode ser executada neste tipo de ENI.
403	InvalidVSwitchId.IpNotEnough	%s	O número de endereços IP disponíveis no vSwitch especificado é insuficiente.
403	InvalidVSwitchId.IpInvalid	%s	Endereço IP privado inválido.
403	QuotaExceed.Tags	%s	O número máximo de tags foi excedido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
403	InvalidIp.IpRepeated	%s	O endereço IP já existe.
403	MaxEniPrivateIpsCountExceeded	%s	O número máximo de endereços IP privados secundários que podem ser atribuídos à ENI especificada foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Não é possível modificar grupos de segurança gerenciados por serviços de nuvem.
403	InvalidParameter.InvalidEniQueueNumber	%s	Valor de QueueNumber inválido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número máximo de filas por ENI foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número máximo de filas para todas as ENIs em uma instância foi excedido. Para mais informações, consulte o valor retornado no espaço reservado %s da mensagem de erro.
403	InvalidIp.IpPrefixMaskNotSame	The ip prefixes %s are illegal which mask must be same.	As máscaras de prefixo IP não são iguais.
403	InvalidIp.IpPrefixMaskInvalid	The ip prefixes mask %s is illegal which must be between %s and %s.	A máscara de prefixo IP é inválida e não está dentro do intervalo válido.
403	InvalidIp.IpPrefixMaskIllegal	The ip prefix mask is illegal.	A máscara de prefixo IP é inválida.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	O prefixo IP é inválido e não está no formato CIDR.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.	O prefixo IP é inválido e não está no bloco CIDR reservado do vSwitch.
403	InvalidIp.IpPrefixNotAvailable	The ip prefix is/are not available.	O prefixo IP está indisponível.
403	InvalidIp.IpPrefixNotStrict	The ip prefix must be strict cidr format.	O prefixo IP é inválido e não está no formato CIDR estrito.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified vSwitch has not enough ip prefix.	O número de prefixos IP no vSwitch especificado é insuficiente.
404	InvalidEcsId.NotFound	%s	O ID da instância não foi encontrado.
404	InvalidEniId.NotFound	%s	O ID da ENI não foi encontrado.
404	InvalidVSwitchId.NotFound	%s	O ID do vSwitch não foi encontrado.
404	InvalidSecurityGroupId.NotFound	%s	O ID do grupo de segurança especificado não existe.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos não existe.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.	O vSwitch especificado não suporta IPv6.
404	InvalidOperation.AddressAlreadyAllocated	The specified ip address has been already allocated.	O endereço IP já está em uso.
404	InvalidOperation.SlaveEniMustHaveBondingEni	Create slave eni must have bonding eni first.	É necessário criar ENIs de vínculo antes de criar ENIs secundárias.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified vSwitch has no cidr reservation.	Nenhum bloco CIDR reservado está disponível para o vSwitch especificado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support ip prefix.	Não é possível atribuir prefixos IP nesta região.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.