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

Observações de uso

Você pode especificar endereços IPv6 dentro do bloco CIDR do vSwitch conectado à ENI ou definir a quantidade de endereços IPv6 gerados automaticamente para a interface. Observe os seguintes pontos:

O protocolo IPv6 deve estar ativado no vSwitch ao qual a ENI está conectada. Para mais informações, consulte Ativar IPv6 para um vSwitch.
A ENI deve estar no estado Available (Available) ou InUse (InUse).
Para atribuir endereços IPv6 a uma ENI primária, verifique se a instância do Elastic Compute Service (ECS) associada a ela está no estado Running (Running) ou Stopped (Stopped).
O número máximo de endereços IPv6 atribuíveis a uma ENI varia conforme o tipo de instância.
- Se a ENI estiver no estado Available (Available), ela poderá receber até 10 endereços IPv6.
- Caso a ENI já esteja vinculada a uma instância ECS, o limite de endereços IPv6 dependerá do tipo da instância. Para mais detalhes, consulte Famílias de instâncias.
Após a chamada da operação, a resposta conterá os endereços IPv6 atribuídos à ENI.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AssignIpv6Addresses	A operação a ser executada. Defina o valor como AssignIpv6Addresses.
RegionId	String	Sim	cn-hangzhou	ID da região da ENI. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
NetworkInterfaceId	String	Sim	eni-bp1iqejowblx6h8j****	ID da ENI.
Ipv6AddressCount	Integer	Não	1	Número de endereços IPv6 a gerar aleatoriamente para a ENI. Valores válidos: 1 a 10. Nota Especifique `Ipv6Addresses.N` ou `Ipv6AddressCount`, mas não ambos.
Ipv6Address.N	String	Não	2001:db8:1234:1a00::****	Endereço IPv6 N a atribuir à ENI. Valores válidos de N: 1 a 10. Exemplo: Ipv6Address.1=2001:db8:1234:1a00::** Nota** Especifique `Ipv6Addresses.N` ou `Ipv6AddressCount`, mas não ambos.
Ipv6Prefix.N	String	Não	2001:db8:1234:1a00:****::/80	Prefixo IPv6 N a atribuir à 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	Número de prefixos IPv6 a atribuir à ENI. Valores válidos: 1 a 10. Nota Para atribuir prefixos IPv6 à ENI, especifique Ipv6Prefix.N ou Ipv6PrefixCount, mas não ambos.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas certifique-se de que ele seja exclusivo 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.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
NetworkInterfaceId	String	eni-bp1iqejowblx6h8j****	ID da ENI.
Ipv6Sets	Array of String	2001:db8:1234:1a00::****	Endereços IPv6 atribuídos à ENI.
Ipv6PrefixSets	Array of String	2001:db8:1234:1a00:****::/80	Prefixos IPv6 atribuídos à ENI.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=AssignIpv6Addresses
&NetworkInterfaceId=eni-bp1iqejowblx6h8j****
&RegionId=cn-hangzhou
&Ipv6Address.1=2001:db8:1234:1a00::****
&Ipv6Address.2=2001:db8:1234:1a01::****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AssignIpv6AddressesResponse>
    <Ipv6Sets>
        <Ipv6Address>2001:db8:1234:1a00::****</Ipv6Address>
        <Ipv6Address>2001:db8:1234:1a01::****</Ipv6Address>
    </Ipv6Sets>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <NetworkInterfaceId>eni-bp1iqejowblx6h8j****</NetworkInterfaceId>
</AssignIpv6AddressesResponse>

Formato JSON

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

{
  "Ipv6Sets" : {
    "Ipv6Address" : [ "2001:db8:1234:1a00::****", "2001:db8:1234:1a01::****" ]
  },
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "NetworkInterfaceId" : "eni-bp1iqejowblx6h8j****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	UnsupportedParameter	%s	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	MissingParameter	%s	Parâmetro obrigatório não especificado.
400	InvalidParams.EniId	%s	Valor de NetworkInterfaceId inválido.
400	InvalidOperation.InvalidEcsState	%s	Não é possível executar esta operação na instância no estado atual.
400	InvalidOperation.InvalidEniState	%s	Não é possível executar esta operação na ENI no estado atual.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.	O endereço IP privado especificado já está em uso. Tente outro endereço IP.
400	IncorrectVSwitchStatus	The current status of vSwitch does not support this operation.	Não é possível executar esta operação no vSwitch no estado atual.
400	InvalidParameter.Conflict	%s	Valor de parâmetro inválido. Verifique se há conflitos de parâmetros. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
403	InvalidUserType.NotSupported	%s	Sua conta não suporta esta operação.
403	Abs.InvalidAccount.NotFound	%s	Conta Alibaba Cloud não encontrada ou par AccessKey expirado.
403	Forbedden.NotSupportRAM	%s	Usuários do Resource Access Management (RAM) não têm permissões necessárias para executar esta operação.
403	Forbbiden.SubUser	%s	Você não tem autorização para gerenciar este recurso. Entre em contato com o proprietário da conta Alibaba Cloud para obter autorização.
403	InvalidOperation.InvalidEniType	%s	Operação não suportada para o tipo atual da ENI.
403	MaxEniIpv6IpsCountExceeded	%s	O número máximo de endereços IPv6 atribuíveis à ENI foi excedido.
403	InvalidIp.IpUnassigned	%s	O endereço IP especificado não está atribuído.
403	InvalidIp.IpRepeated	%s	O endereço IP especificado já existe.
403	InvalidIp.IpAssigned	%s	O endereço IP especificado já está atribuído.
403	InvalidOperation.Ipv4CountExceeded	%s	O número máximo de endereços IPv4 foi excedido.
403	InvalidOperation.Ipv6CountExceeded	%s	O número máximo de endereços IPv6 foi excedido.
403	InvalidOperation.Ipv6NotSupport	%s	Endereços IPv6 não suportam a operação.
403	InvalidVSwitch.Ipv6NotTurnOn	%s	O recurso IPv6 não está ativado no vSwitch atual. Ative-o e tente novamente.
403	InvalidVSwitchId.IpInvalid	%s	O endereço IP privado especificado é inválido.
403	Forbidden.RegionId	%s	Serviço indisponível na região atual.
403	InvalidOperation.EniServiceManaged	%s	A operação é inválida.
403	SecurityGroupInstanceLimitExceed	%s	O número máximo de instâncias no grupo de segurança especificado foi excedido.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	O prefixo IP é inválido e não está no formato CIDR.
403	InvalidIp.IpPrefixMaskIllegal	The ip prefix mask is illegal.	A máscara de prefixo IP é inválida.
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.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.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 não está disponível.
403	InvalidIp.IpPrefixNotStrict	The ip prefix must be strict cidr format.	O prefixo IP é inválido e não está no formato CIDR.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified vSwitch has not enough ip prefix.	O número de prefixos IP no vSwitch especificado é insuficiente.
403	MissingParameter	These parameters %s cannot be both empty.	Parâmetro obrigatório não especificado. Os parâmetros obrigatórios não podem estar vazios.
404	InvalidEniId.NotFound	%s	ID da ENI especificado não encontrado.
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.