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

Você pode criar uma interface de rede elástica (ENI) e especificar seu endereço IP privado principal.

Descrição da operação

Ao chamar esta operação, observe o seguinte:

Esta é uma operação síncrona. Uma interface de rede elástica recém-criada fica no estado Available e pode ser anexada a uma instância imediatamente.
Se a resposta não contiver um NetworkInterfaceId, tente criar a interface de rede elástica novamente.
Uma interface de rede elástica pode ser anexada a apenas uma instância em uma VPC.
Quando você reanexa uma interface de rede elástica a outra instância, suas propriedades permanecem inalteradas e o tráfego de rede é redirecionado para a nova instância.
Você pode atribuir até 49 endereços IP privados secundários ao criar uma interface de rede elástica.
Para atribuir um endereço IPv6 ao criar uma interface de rede elástica, certifique-se de que o IPv6 esteja habilitado para o VSwitch especificado. Para mais informações, consulte O que é um gateway IPv6.
Cada conta possui uma cota de recursos que limita o número de interfaces de rede elásticas que você pode criar em uma região do Alibaba Cloud. Você pode visualizar suas cotas de recursos no console do ECS. Para mais informações, consulte Visualizar e aumentar cotas de recursos.

Exemplos de solicitação

Criar uma interface de rede elástica

RegionId:  cn-hangzhou,   // Região China (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   // O ID do grupo de segurança.
VSwitchId:  vsw-bp19wo63nleroq22g****,   // O ID do VSwitch.

Criar uma interface de rede elástica e especificar um endereço IP privado principal

RegionId:  cn-hangzhou,   // Região China (Hangzhou).
SecurityGroupId:  sg-bp10jztp6b0sdsyl****,   // ID do grupo de segurança.
VSwitchId:  vsw-bp19wo63nleroq22g****,   // ID do VSwitch.
PrimaryIpAddress:  192.168.0.*,   // Endereço IP privado principal.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região na qual criar a interface de rede elástica. Você pode chamar a operação DescribeRegions para visualizar a lista mais recente de regiões do Alibaba Cloud.	cn-hangzhou
Tag	array<object>	Não	As tags a serem adicionadas à interface de rede elástica.
	object	Não	Uma tag para a interface de rede elástica.
Key	string	Não	A chave da tag. Valores válidos para N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	TestKey
Value	string	Não	O valor da tag. Valores válidos para N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 128 caracteres e não pode conter `http://` ou `https://`.	TestValue
ResourceGroupId	string	Não	O ID da região na qual criar a interface de rede elástica. Você pode chamar a operação DescribeRegions para visualizar a lista mais recente de regiões do Alibaba Cloud.	rg-bp67acfmxazb4ph****
VSwitchId	string	Sim	O ID do grupo de recursos. Você pode chamar a operação ListResourceGroups para consultar grupos de recursos.	vsw-bp1s5fnvk4gn2tws03****
PrimaryIpAddress	string	Não	O ID do VSwitch para a interface de rede elástica. Os endereços IP privados da interface de rede elástica são atribuídos a partir do bloco CIDR disponível do VSwitch. Importante A interface de rede elástica e a instância a ser anexada devem estar na mesma zona de disponibilidade, mas podem pertencer a VSwitches diferentes. .	172.17..
SecurityGroupId	string	Não	O endereço IP privado principal da interface de rede elástica. O endereço IP deve ser um endereço IP disponível dentro do bloco CIDR do VSwitch. Se este parâmetro não for especificado, o sistema atribui aleatoriamente um endereço IP disponível do bloco CIDR do VSwitch.	sg-bp1fg655nh68xyz9i****
NetworkInterfaceName	string	Não	O ID do grupo de segurança para a interface de rede elástica. O grupo de segurança e a interface de rede elástica devem estar na mesma VPC. Nota Você deve especificar `SecurityGroupId` ou `SecurityGroupIds.N`, mas não ambos.	testNetworkInterfaceName
Description	string	Não	O nome da interface de rede elástica. O nome deve ter de 2 a 128 caracteres e pode conter letras Unicode (como caracteres em inglês e chinês), dígitos (0-9), dois-pontos (:), underscores (_), pontos (.) e hífens (-). Valor padrão: vazio.	testDescription
Visible	boolean	Não	A descrição da interface de rede elástica. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`. Valor padrão: vazio.	null
InstanceType	string	Não	Nota Este parâmetro está obsoleto.	Secondary
BusinessType	string	Não	O tipo da interface de rede elástica. Valores válidos: `Secondary`: uma interface de rede elástica secundária. `Trunk`: uma interface de rede trunk. (Este recurso está disponível apenas por convite.) Valor padrão: `Secondary`.	null
SecondaryPrivateIpAddressCount	integer	Não	Nota Este parâmetro está obsoleto.	1
QueueNumber	integer	Não	O número de endereços IP privados secundários a serem atribuídos automaticamente à interface de rede elástica. Valores válidos: 1 a 49.	1
ClientToken	string	Não	O número de filas para a interface de rede elástica. Valores válidos: 1 a 2048. Quando anexada a uma instância, este valor deve ser menor que o número máximo de filas por interface de rede elástica que o tipo de instância suporta. Você pode chamar a operação DescribeInstanceTypes e verificar o valor `MaximumQueueNumberPerEni` na resposta para consultar este limite. Se você não especificar este parâmetro, o número padrão de filas para o tipo de instância será usado ao anexar.	123e4567-e89b-12d3-a456-426655440000
NetworkInterfaceTrafficMode	string	Não	Um token de cliente para garantir a idempotência da solicitação. Seu cliente gera este token, que deve ser único entre as 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.	Standard
QueuePairNumber	integer	Não	O modo de tráfego da interface de rede elástica. Valores válidos: `Standard`: usa o modo de tráfego TCP. `HighPerformance`: habilita a Elastic RDMA Interface (ERI) e usa o modo de tráfego RDMA. Nota Uma interface de rede elástica no modo de tráfego RDMA pode ser anexada apenas a um tipo de instância compatível com ERI. O número dessas interfaces de rede elásticas que podem ser anexadas é limitado pela família de instâncias. Para mais informações, consulte Famílias de instâncias, Configurar eRDMA em uma instância de nível empresarial. Valor padrão: `Standard`.	22
SecurityGroupIds	array	Não	O número de pares de filas para a interface de rede elástica habilitada para RDMA. Se você deseja anexar várias interfaces de rede elásticas habilitadas para RDMA a uma instância, recomendamos que especifique um valor de `QueuePairNumber` para cada interface de rede elástica. O valor deve ser baseado no valor máximo de `QueuePairNumber` suportado pelo tipo de instância e no número de interfaces de rede elásticas que você planeja usar. O número total de pares de filas para todas as interfaces de rede elásticas não pode exceder o valor máximo para o tipo de instância. Você pode chamar a operação DescribeInstanceTypes para consultar o valor máximo. Importante Se você não especificar `QueuePairNumber` para uma interface de rede elástica habilitada para RDMA, o sistema usará o valor máximo que o tipo de instância suporta como padrão. Consequentemente, você não poderá anexar mais interfaces de rede elásticas habilitadas para RDMA a essa instância. Isso não afeta interfaces de rede elásticas padrão. .	sg-bp1fg655nh68xyz9i****
	string	Não	The IDs of one or more security groups to which to add the elastic network interface. The security groups and the elastic network interface must be in the same VPC. The valid values of N depend on the maximum number of security groups to which an elastic network interface can be added. For more information, see Limits. Nota You must specify either `SecurityGroupId` or `SecurityGroupIds.N`, but not both.	sg-bp1fg655nh68xyz9i****
PrivateIpAddress	array	Não	Os IDs de um ou mais grupos de segurança aos quais adicionar a interface de rede elástica. Os grupos de segurança e a interface de rede elástica devem estar na mesma VPC. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais uma interface de rede elástica pode ser adicionada. Para mais informações, consulte Limites. Nota Você deve especificar `SecurityGroupId` ou `SecurityGroupIds.N`, mas não ambos.	172.17..
	string	Não	Os IDs de um ou mais grupos de segurança aos quais adicionar a interface de rede elástica. Os grupos de segurança e a interface de rede elástica devem estar na mesma VPC. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais uma interface de rede elástica pode ser adicionada. Para mais informações, consulte Limites. Nota Você deve especificar `SecurityGroupId` ou `SecurityGroupIds.N`, mas não ambos.	172.17..
Ipv6Address	array	Não	Um ou mais endereços IP privados secundários a serem atribuídos à interface de rede elástica. Os endereços IP devem ser endereços disponíveis do bloco CIDR do VSwitch ao qual a interface de rede elástica pertence. Valores válidos de N: 0 a 10. Nota Você não pode especificar `PrivateIpAddress.N` e `SecondaryPrivateIpAddressCount` simultaneamente para atribuir endereços IP privados secundários.	2001:db8:1234:1a00::****
	string	Não	Um ou mais endereços IP privados secundários a serem atribuídos à interface de rede elástica. Os endereços IP devem ser endereços disponíveis do bloco CIDR do VSwitch ao qual a interface de rede elástica pertence. Valores válidos de N: 0 a 10. Nota Você não pode especificar `PrivateIpAddress.N` e `SecondaryPrivateIpAddressCount` simultaneamente para atribuir endereços IP privados secundários.	2001:db8:1234:1a00::****
Ipv6AddressCount	integer	Não	Um ou mais endereços IPv6 a serem atribuídos à interface de rede elástica. Você pode especificar até 10 endereços IPv6. Valores válidos de N: 1 a 10. Exemplo: `Ipv6Address.1=2001:db8:1234:1a00::**` Nota** Você deve especificar `Ipv6Address.N` ou `Ipv6AddressCount`, mas não ambos, para atribuir endereços IPv6.	1
Ipv4Prefix	array	Não	O número de endereços IPv6 aleatórios a serem atribuídos à interface de rede elástica. Valores válidos: 1 a 10. Nota Você deve especificar `Ipv6Address.N` ou `Ipv6AddressCount`, mas não ambos, para atribuir endereços IPv6.
	string	Não	One or more IPv4 prefixes to assign to the elastic network interface. Valid values of N: 1 to 10. Nota You must specify either `Ipv4Prefix.N` or `Ipv4PrefixCount`, but not both, to assign IPv4 prefixes.	192.168../28
Ipv4PrefixCount	integer	Não	Um ou mais prefixos IPv4 a serem atribuídos à interface de rede elástica. Valores válidos de N: 1 a 10. Nota Você deve especificar `Ipv4Prefix.N` ou `Ipv4PrefixCount`, mas não ambos, para atribuir prefixos IPv4.	1
Ipv6Prefix	array	Não	O número de prefixos IPv4 a serem atribuídos à interface de rede elástica. Valores válidos: 1 a 10. Nota Você deve especificar `Ipv4Prefix.N` ou `Ipv4PrefixCount`, mas não ambos, para atribuir prefixos IPv4.
	string	Não	One or more IPv6 prefixes to assign to the elastic network interface. Valid values of N: 1 to 10. Nota You must specify either `Ipv6Prefix.N` or `Ipv6PrefixCount`, but not both, to assign IPv6 prefixes.	2001:db8:1234:1a00:****::/80
Ipv6PrefixCount	integer	Não	Um ou mais prefixos IPv6 a serem atribuídos à interface de rede elástica. Valores válidos de N: 1 a 10. Nota Você deve especificar `Ipv6Prefix.N` ou `Ipv6PrefixCount`, mas não ambos, para atribuir prefixos IPv6.	1
DeleteOnRelease	boolean	Não	O número de prefixos IPv6 a serem atribuídos à interface de rede elástica. Valores válidos: 1 a 10. Nota Você deve especificar `Ipv6Prefix.N` ou `Ipv6PrefixCount`, mas não ambos, para atribuir prefixos IPv6.	true
TxQueueSize	integer	Não	Especifica se a interface de rede elástica deve ser liberada quando a instância anexada for liberada. Valores válidos: `true`: A interface de rede elástica é liberada. `false`: A interface de rede elástica é retida.	8192
RxQueueSize	integer	Não	A profundidade da fila de transmissão (Tx) da interface de rede elástica. As profundidades das filas de transmissão (Tx) e recepção (Rx) devem ser iguais. O valor deve ser uma potência de 2 entre 8.192 e 16.384. Uma profundidade de fila Tx maior pode melhorar a taxa de transmissão, mas consome mais memória. Nota Este parâmetro não está disponível publicamente.	8192
NetworkInterfaceTrafficConfig	object	Não	A profundidade da fila de recepção (Rx) da interface de rede elástica. As profundidades das filas de recepção (Rx) e transmissão (Tx) devem ser iguais. O valor deve ser uma potência de 2 entre 8.192 e 16.384. Uma profundidade de fila Rx maior pode melhorar a taxa de recepção, mas consome mais memória. Nota Este parâmetro não está disponível publicamente.
QueueNumber	integer	Não	The number of queues for the elastic network interface.	8
NetworkInterfaceTrafficMode	string	Não	The traffic mode of the elastic network interface.	HighPerformance
QueuePairNumber	integer	Não	The number of queue pairs for the RDMA-enabled elastic network interface.	8
TxQueueSize	integer	Não	The transmit (Tx) queue depth of the elastic network interface. Nota This parameter is available by invitation only. To request access, submit a ticket. This parameter is applicable only to seventh-generation or later ECS instance types. This parameter is applicable only to Linux images. A larger Tx queue depth can improve transmit throughput and reduce the packet loss rate, but consumes more memory.	8192
RxQueueSize	integer	Não	The receive (Rx) queue depth of the elastic network interface. Nota This parameter is available by invitation only. To request access, submit a ticket. This parameter is applicable only to seventh-generation or later ECS instance types. This parameter is applicable only to Linux images. A larger Rx queue depth can improve receive throughput and reduce the packet loss rate, but consumes more memory.	8192
ConnectionTrackingConfiguration	object	Não	Os parâmetros de comunicação da interface de rede elástica.
TcpEstablishedTimeout	integer	Não	The timeout for an established TCP connection, in seconds. Valid values: 30, 60, 80, 100, 200, 300, 500, 700, and 910. Default value: 910.	910
TcpClosedAndTimeWaitTimeout	integer	Não	The timeout for a TCP connection in the TIME_WAIT or closing state, in seconds. Valid values: integers from 3 to 15. Default value: 3. Nota If your ECS instance works with NLB or CLB, the default timeout period for connections in the `TIME_WAIT` state is 15 seconds.	3
UdpTimeout	integer	Não	The timeout for a UDP stream, in seconds. Valid values: 10, 20, 30, 60, 80, and 100. Default value: 30. Nota If your ECS instance works with NLB or CLB, the default value is 100 seconds.	30
NetworkInterfaceTrafficMode		Não	O modo de tráfego da interface de rede elástica.
QueueNumber		Não	O número de filas para a interface de rede elástica.
QueuePairNumber		Não	O número de pares de filas para a interface de rede elástica habilitada para RDMA.
TxQueueSize		Não	A profundidade da fila de transmissão (Tx) da interface de rede elástica. Nota Este parâmetro está disponível apenas por convite. Para solicitar acesso, envie um ticket. Este parâmetro é aplicável apenas a tipos de instância ECS de sétima geração ou posterior. Este parâmetro é aplicável apenas a imagens Linux. Uma profundidade de fila Tx maior pode melhorar a taxa de transmissão e reduzir a taxa de perda de pacotes, mas consome mais memória.
RxQueueSize		Não	A profundidade da fila de recepção (Rx) da interface de rede elástica. Nota Este parâmetro está disponível apenas por convite. Para solicitar acesso, envie um ticket. Este parâmetro é aplicável apenas a tipos de instância ECS de sétima geração ou posterior. Este parâmetro é aplicável apenas a imagens Linux. Uma profundidade de fila Rx maior pode melhorar a taxa de recepção e reduzir a taxa de perda de pacotes, mas consome mais memória.
EnhancedNetwork	object	Não	As configurações de rastreamento de conexão. Antes de usar este parâmetro, leia Gerenciamento de tempo limite de conexão.
EnableSriov	boolean	Não	Nota This parameter is not publicly available.	true
EnableRss	boolean	Não	Nota This parameter is not publicly available.	true
VirtualFunctionTotalQueueNumber	integer	Não
VirtualFunctionQuantity	integer	Não
TcpClosedAndTimeWaitTimeout		Não	O tempo limite para uma conexão TCP no estado TIME_WAIT ou closing, em segundos. Valores válidos: inteiros de 3 a 15. Valor padrão: 3. Nota Se sua instância ECS trabalha com NLB ou CLB, o período de tempo limite padrão para conexões no estado `TIME_WAIT` é de 15 segundos.
UdpTimeout		Não	O tempo limite para um fluxo UDP, em segundos. Valores válidos: 10, 20, 30, 60, 80 e 100. Valor padrão: 30. Nota Se sua instância ECS trabalha com NLB ou CLB, o valor padrão é 100 segundos.
TcpEstablishedTimeout		Não	O tempo limite para uma conexão TCP estabelecida, em segundos. Valores válidos: 30, 60, 80, 100, 200, 300, 500, 700 e 910. Valor padrão: 910.
SourceDestCheck	boolean	Não	Nota Este parâmetro não está disponível publicamente.	false
		Não	Especifica se a verificação de origem/destino deve ser habilitada. Habilitar este recurso melhora a segurança da rede. Valores válidos: `true`: habilitado. `false`: desabilitado. Valor padrão: false. Nota Este recurso está disponível apenas em algumas regiões. Antes de usar este recurso, leia Verificação de origem/destino.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Status	string	O status da interface de rede elástica.	Available
Type	string	O tipo da interface de rede elástica.	Secondary
VpcId	string	O ID da VPC à qual a interface de rede elástica pertence.	vpc-bp1j7w3gc1cexjqd****
NetworkInterfaceName	string	O nome da interface de rede elástica.	my-eni-name
MacAddress	string	O endereço MAC da interface de rede elástica.	00:16:3e:12::
NetworkInterfaceId	string	O ID da interface de rede elástica.	eni-bp14v2sdd3v8htln****
ServiceID	integer	O ID do distribuidor da interface de rede elástica.	12345678910
OwnerId	string	O ID da conta proprietária da interface de rede elástica.	123456****
ServiceManaged	boolean	Especifica se a interface de rede elástica é gerenciada por um serviço em nuvem ou um distribuidor.	true
VSwitchId	string	O ID do vSwitch.	vsw-bp16usj2p27htro3****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Description	string	A descrição da interface de rede elástica.	testDescription
ResourceGroupId	string	O ID do grupo de recursos.	rg-2ze88m67qx5z****
ZoneId	string	O ID da zona.	cn-hangzhou-e
PrivateIpAddress	string	O endereço IP privado principal da interface de rede elástica.	172.17..
SecurityGroupIds	object	Os IDs dos grupos de segurança aos quais a interface de rede elástica pertence.
SecurityGroupId	array	Uma lista de IDs de grupos de segurança.
	string	O ID do grupo de segurança.	sg-bp18kz60mefsicfg****
PrivateIpSets	object	Os endereços IP privados atribuídos à interface de rede elástica.
PrivateIpSet	array<object>	Uma coleção de conjuntos de endereços IP privados.
	object
PrivateIpAddress	string	The private IP address.	172.17..
Primary	boolean	Indicates whether the IP address is the primary private IP address.	true
Tags	object	As tags da interface de rede elástica.
Tag	array<object>	A lista de tags.
	object
TagValue	string	The tag value.	TestValue
TagKey	string	The tag key.	TestKey
Ipv6Sets	object	Os endereços IPv6 atribuídos à interface de rede elástica.
Ipv6Set	array<object>	Os endereços IPv6 atribuídos à ENI.
	object	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.
Ipv6Address	string	The IPv6 address.	2001:db8:1234:1a00::****
Ipv4PrefixSets	object	Os prefixos IPv4 atribuídos à interface de rede elástica.
Ipv4PrefixSet	array<object>	Os prefixos IPv4 atribuídos à ENI.
	object
Ipv4Prefix	string	The IPv4 prefix.	192.168../28
Ipv6PrefixSets	object	Os prefixos IPv6 atribuídos à interface de rede elástica.
Ipv6PrefixSet	array<object>	Os prefixos IPv6 atribuídos à ENI.
	object
Ipv6Prefix	string	The IPv6 prefix.	2001:db8:1234:1a00:****::/80
SourceDestCheck	boolean	Nota Este parâmetro está em pré-visualização por convite e não está disponível publicamente.	false

Exemplos

Resposta de sucesso

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::****"
      }
    ]
  },
  "Ipv4PrefixSets": {
    "Ipv4PrefixSet": [
      {
        "Ipv4Prefix": "192.168.**.**/28"
      }
    ]
  },
  "Ipv6PrefixSets": {
    "Ipv6PrefixSet": [
      {
        "Ipv6Prefix": "2001:db8:1234:1a00:****::/80"
      }
    ]
  },
  "SourceDestCheck": false
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	MissingParameter	%s
400	UnsupportedParameter	%s
400	InvalidParameter	%s
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s
400	InvalidOperation.InvalidEniState	%s
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s
400	Forbidden.RegionId	%s
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.
400	JoinedGroupLimitExceed	%s
400	InvalidParameter.SecurityGroupIdRepeated	%s
400	InvalidSecurityGroupId.SingleIdAndMultiIdConflict	%s
400	InvalidParameter.Conflict	%s
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.
400	InvalidOperation.EniCountExceeded	%s.
400	InvalidPrivateIpAddress.Duplicated	The specified private IP address "%s" is duplicated.
400	IncorrectVSwitchStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".
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.
400	InvalidParameter.EniQueueSize	The specified parameter "TxQueueSize" and "RxQueueSize" are not equal or the value must be 8192 or 16384.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specified ENI connection tracking configuration "%s" must be between %s and %s.
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.
400	Throttling	Request was denied due to request throttling.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".
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.
401	InvalidOperation.SecurityGroupNotAuthorized	The specified security group is not authorized to operate.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support IP prefix feature.
500	ServiceUnavailable	The request processing has failed due to some unknown error.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	Forbidden.NotSupportRAM	%s
403	Forbidden.SubUser	%s
403	InValidParameter	%s
403	MaxEniCountExceeded	%s
403	EniPerInstanceLimitExceeded	%s
403	InvalidOperation.AvailabilityZoneMismatch	%s
403	InvalidOperation.VpcMismatch	%s
403	SecurityGroupInstanceLimitExceed	%s
403	InvalidSecurityGroupId.NotVpc	%s
403	InvalidOperation.InvalidEniType	%s
403	InvalidVSwitchId.IpNotEnough	%s
403	InvalidVSwitchId.IpInvalid	%s
403	QuotaExceed.Tags	%s
403	InvalidIp.Address	%s
403	InvalidIp.IpRepeated	%s
403	MaxEniPrivateIpsCountExceeded	%s
403	InvalidOperation.ResourceManagedByCloudProduct	%s
403	InvalidOperation.TrunkingIsNotAllowed	%s
403	InvalidParameter.InvalidEniQueueNumber	%s
403	InvalidOperation.MaxEniQueueNumberExceeded	%s
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s
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.
403	InvalidIp.IpPrefixMustInReserveSegment	The ip prefix must in vswitch reserve segment.
403	InvalidOperation.Ipv4CountExceeded	%s
403	InvalidOperation.Ipv6CountExceeded	%s
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".
403	AclLimitExceed	%s
403	InvalidIp.IpPrefixMaskInvalid	The IP prefix mask %s is illegal which must be between %s and %s.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified VSwitch does not have enough IP prefixes.
403	InvalidIp.IpPrefixMaskNotSame	The IP prefixes %s are illegal.The IP prefix mask must be the same.
403	EnterpriseGroupLimited.MutliGroupType	The specified instance can't associate security group of different types.
403	InvalidOperation.BoundingEniSlaveQuotaExceed	The number of Slave ENIs exceeds the limit of Bond ENI.
403	InvalidIp.IpPrefixNotAvailable	The IP prefix is not available.
403	InvalidIp.IpPrefixMaskIllegal	The current IP prefix mask is illegal.
403	InvalidIp.IpPrefixNotStrict	The IP prefix "%s" must be strict CIDR format.
403	InvalidOperation.NotSupport	The specified region does not support allocating IPv6 when creating ENI.
404	InvalidEcsId.NotFound	%s
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s
404	InvalidSecurityGroupId.NotFound	%s
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.
404	InvalidOperation.MaxEniIpv6IpsCountExceeded	The ipv6 address count exceed limitation.
404	InvalidOperation.VSwitchIpv6Disabled	The specified VSwitch does not support Ipv6 feature.
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.
404	InvalidOperation.EniTrafficModeNotSupportIpv6	The High Performance(RDMA) traffic mode does not support IPv6.
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified VSwitch does not have CIDR reservation.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.