Atribui um ou mais endereços IP privados secundários a uma interface de rede elástica (ENI). Especifique endereços IP privados disponíveis no bloco CIDR do vSwitch conectado à ENI ou defina uma quantidade para que o sistema os atribua automaticamente a partir desse bloco.
Observações de uso
A ENI deve estar no estado Available (Available) ou InUse (InUse) para receber endereços IP privados secundários.
Ao atribuir endereços IP privados secundários a uma ENI primária, a instância do Elastic Compute Service (ECS) associada deve estar no estado Running (Running) ou Stopped (Stopped).
Se a ENI estiver no estado Available (Available), é possível atribuir até 49 endereços IP privados secundários. Caso esteja vinculada a uma instância, o limite depende do tipo da instância. Para mais detalhes, consulte Visão geral das famílias de instâncias.
Após chamar esta operação para uma ENI, obtenha os endereços IP privados secundários atribuídos na resposta.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Yes |
AssignPrivateIpAddresses |
Operação a ser executada. Defina o valor como AssignPrivateIpAddresses. |
|
RegionId |
String |
Yes |
cn-hangzhou |
ID da região da ENI. Chame a operação DescribeRegions para obter a lista atualizada de regiões. |
|
NetworkInterfaceId |
String |
Yes |
eni-bp67acfmxazb4p**** |
ID da ENI. |
|
SecondaryPrivateIpAddressCount |
Integer |
No |
1 |
Quantidade de endereços IP privados a serem atribuídos automaticamente a partir do bloco CIDR do vSwitch conectado à ENI. Para atribuir endereços IP privados secundários à ENI, não especifique simultaneamente |
|
ClientToken |
String |
No |
123e4567-e89b-12d3-a456-426655440000 |
Token de cliente usado para garantir a idempotência da solicitação. Gere o token no cliente, garantindo que seja único para cada solicitação distinta. O token aceita apenas caracteres ASCII e tem limite de 64 caracteres. Para mais informações, consulte Como garantir a idempotência. |
|
PrivateIpAddress.N |
String |
No |
10.1.. |
Endereço IP privado secundário N, escolhido dentro do bloco CIDR do vSwitch conectado à ENI. Valores válidos para N:
Nota
Para atribuir endereços IP privados secundários à ENI, não especifique simultaneamente |
|
Ipv4Prefix.N |
String |
No |
192.168../28 |
Prefixo IPv4 N. Valores válidos para N: 1 a 10. Nota
Para atribuir prefixos IPv4 à ENI, especifique Ipv4Prefix.N ou Ipv4PrefixCount, mas não ambos. |
|
Ipv4PrefixCount |
Integer |
No |
1 |
Número de prefixos IPv4 a serem gerados aleatoriamente para a ENI. Valores válidos: 1 a 10. Nota
Para atribuir prefixos IPv4 à ENI, especifique Ipv4Prefix.N ou Ipv4PrefixCount, mas não ambos. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
ID da solicitação. |
|
AssignedPrivateIpAddressesSet |
Object |
Endereços IP privados secundários atribuídos à ENI. |
|
|
NetworkInterfaceId |
String |
eni-bp125p95hhdhn3ot**** |
ID da ENI. |
|
PrivateIpSet |
Array of String |
192.168.. |
Endereços IP privados secundários. |
|
Ipv4PrefixSet |
Array of String |
192.168../28 |
Prefixos IPv4. |
Exemplos
Exemplos de solicitações
https://ecs.aliyuncs.com/?Action=AssignPrivateIpAddresses
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&PrivateIpAddress.1=10.1.**.**
&PrivateIpAddress.2=10.1.**.**
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<AssignPrivateIpAddressesResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<AssignedPrivateIpAddressesSet>
<PrivateIpSet>
<PrivateIpAddress>192.168.**.**</PrivateIpAddress>
</PrivateIpSet>
<NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
</AssignedPrivateIpAddressesSet>
</AssignPrivateIpAddressesResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"AssignedPrivateIpAddressesSet" : {
"PrivateIpSet" : {
"PrivateIpAddress" : [ "192.168.**.**" ]
},
"NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****"
}
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
Throttling |
Request was denied due to request throttling. |
A solicitação foi limitada devido ao controle de fluxo. |
|
400 |
UnsupportedParameter |
%s |
Um parâmetro especificado não é suportado. |
|
400 |
InvalidParameter |
%s |
Parâmetro inválido. |
|
400 |
InvalidInstanceID.Malformed |
%s |
Valor de InstanceId inválido. |
|
400 |
InvalidOperation.InvalidEcsState |
%s |
Não é possível executar esta operação no estado atual da instância. |
|
400 |
InvalidOperation.InvalidEniState |
%s |
Não é possível executar esta operação no estado atual da ENI. |
|
400 |
InvalidOperation.DetachPrimaryEniNotAllowed |
%s |
Não é possível desanexar a ENI da instância. |
|
400 |
MissingParameter |
%s |
Um parâmetro obrigatório não foi especificado. |
|
400 |
Forbidden.RegionId |
%s |
O serviço está indisponível nesta região no momento. |
|
400 |
InvalidAction |
%s |
A operação é inválida. |
|
400 |
IncorrectVSwitchStatus |
The current status of vSwitch does not support this operation. |
Não é possível realizar a operação no estado atual do vSwitch. |
|
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 |
InvalidParameter.Conflict |
%s |
Um parâmetro especificado é inválido. Verifique se há conflitos entre parâmetros. %s é uma variável; uma mensagem de erro é retornada dinamicamente conforme as condições da chamada. |
|
403 |
InvalidUserType.NotSupported |
%s |
Sua conta não suporta esta operação. |
|
403 |
Abs.InvalidAccount.NotFound |
%s |
Sua conta Alibaba Cloud não existe ou seu par AccessKey expirou. |
|
403 |
Forbidden.NotSupportRAM |
%s |
Usuários do Resource Access Management (RAM) não têm acesso a 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 gerenciáveis foi excedido. |
|
403 |
EniPerInstanceLimitExceeded |
%s |
O limite máximo de ENIs anexáveis à instância foi atingido. |
|
403 |
InvalidOperation.AvailabilityZoneMismatch |
%s |
A operação é inválida. |
|
403 |
InvalidOperation.VpcMismatch |
%s |
Operação inválida. Verifique se a Virtual Private Cloud (VPC) informada corresponde aos demais parâmetros. |
|
403 |
SecurityGroupInstanceLimitExceed |
%s |
O número máximo de instâncias no grupo de segurança especificado foi atingido. |
|
403 |
InvalidSecurityGroupId.NotVpc |
%s |
Valor de SecurityGroupId inválido. O tipo de rede do grupo de segurança especificado não é VPC. |
|
403 |
InvalidOperation.InvalidEniType |
%s |
Não é possível executar esta operação neste tipo de ENI. |
|
403 |
InvalidVSwitchId.IpNotEnough |
%s |
Endereços IP disponíveis insuficientes no bloco CIDR do vSwitch especificado. |
|
403 |
InvalidVSwitchId.IpInvalid |
%s |
Endereço IP privado inválido. |
|
403 |
InvalidIp.IpAssigned |
%s |
O endereço IP especificado já foi atribuído. |
|
403 |
MaxEniPrivateIpsCountExceeded |
%s |
O número máximo de endereços IP privados secundários atribuíveis à ENI foi excedido. Para mais detalhes, consulte o valor retornado no placeholder %s da mensagem de erro. |
|
403 |
Operation.Conflict |
%s |
Esta operação entra em conflito com outra em andamento. Tente novamente mais tarde. |
|
403 |
InvalidOperation.Ipv4CountExceeded |
%s |
O número máximo de endereços IPv4 foi atingido. |
|
403 |
InvalidOperation.EniServiceManaged |
%s |
A operação é inválida. |
|
403 |
InvalidIp.IpRepeated |
%s |
O endereço IP já existe. |
|
403 |
InvalidIp.IpPrefixIllegal |
The ip prefixes %s is/are illegal. |
Os prefixos IP são inválidos e não estão em notação CIDR. |
|
403 |
InvalidIp.IpPrefixMaskIllegal |
The ip prefix mask is illegal. |
A máscara do prefixo IP é inválida. |
|
403 |
InvalidIp.IpPrefixMaskInvalid |
The ip prefixes mask %s is illegal which must be between %s and %s. |
As máscaras dos prefixos IP são inválidas. |
|
403 |
InvalidIp.IpPrefixMaskNotSame |
The ip prefixes %s are illegal which mask must be same. |
As máscaras dos prefixos 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á em notação CIDR estrita. |
|
403 |
InvalidVSwitchId.IpPrefixNotEnough |
The specified vSwitch has not enough ip prefix. |
Prefixos IP insuficientes no bloco CIDR do vSwitch especificado. |
|
403 |
MissingParameter |
These parameters %s cannot be both empty. |
Um parâmetro obrigatório não foi especificado. |
|
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 vSwitch não foi encontrado. |
|
404 |
InvalidSecurityGroupId.NotFound |
%s |
O ID do grupo de segurança não foi encontrado. |
|
404 |
InvalidInstanceId.NotFound |
%s |
O valor de InstanceId não foi 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.