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

Atribui um ou mais endereços IP privados secundários a interfaces de rede elásticas (ENIs). Você pode especificar endereços IP privados ociosos do vSwitch ao qual as interfaces de rede elásticas (ENIs) pertencem ou especificar o número de endereços IP privados a serem alocados automaticamente.

Descrição da operação

Somente interfaces de rede elásticas (ENIs) no estado Available ou InUse são suportadas.
Ao operar a interface de rede (NIC) primária, a instância à qual a interface de rede (NIC) está anexada deve estar no estado Running ou Stopped.
Quando uma interface de rede elástica (ENI) está no estado Available, você pode alocar até 49 endereços IP privados secundários para a ENI. Depois que a ENI é anexada a uma instância, o número de endereços IP privados secundários que podem ser alocados à ENI está sujeito ao tipo de instância. Para mais informações, consulte Famílias de instâncias.
Após chamar esta operação, você pode obter as informações do endereço IP privado secundário alocado a partir da resposta.

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:AssignPrivateIpAddresses

create

*Interface de rede.

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região das interfaces de rede elásticas (ENIs). Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NetworkInterfaceId	string	Sim	O ID da interface de rede elástica (ENI).	eni-bp67acfmxazb4p****
SecondaryPrivateIpAddressCount	integer	Não	O número de endereços IP privados a serem atribuídos automaticamente a partir dos endereços IP ociosos do vSwitch. Ao atribuir endereços IP privados secundários, você não pode especificar `PrivateIpAddress.N` e `SecondaryPrivateIpAddressCount` simultaneamente.	1
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
PrivateIpAddress	array	Não	Um ou mais endereços IP privados secundários selecionados a partir dos endereços IP privados ociosos do vSwitch ao qual as interfaces de rede elásticas (ENIs) pertencem. Valores válidos de N: Quando as interfaces de rede elásticas (ENIs) estão no estado Available (`Available`): 1 a 32. Quando as interfaces de rede elásticas (ENIs) estão no estado `InUse`: sujeito ao tipo de instância. Para mais informações, consulte Famílias de instâncias. Ao alocar endereços IP privados secundários, você não pode especificar `PrivateIpAddress.N` e `SecondaryPrivateIpAddressCount` simultaneamente.	10.1..
	string	Não	Um ou mais endereços IP privados secundários selecionados a partir dos endereços IP privados ociosos do vSwitch ao qual as interfaces de rede elásticas (ENIs) pertencem. Valores válidos de N: Quando as interfaces de rede elásticas (ENIs) estão no estado Available (`Available`): 1 a 32. Quando as interfaces de rede elásticas (ENIs) estão no estado `InUse`: sujeito ao tipo de instância. Para mais informações, consulte Famílias de instâncias. Nota Ao alocar endereços IP privados secundários, você não pode especificar `PrivateIpAddress.N` e `SecondaryPrivateIpAddressCount` simultaneamente.	10.1..
Ipv4Prefix	array	Não	Um ou mais prefixos IPv4 a serem especificados para as interfaces de rede elásticas (ENIs). Valores válidos de N: 1 a 10. Nota Para definir prefixos IPv4 para as interfaces de rede elásticas (ENIs), você deve definir o parâmetro Ipv4Prefix.N ou o parâmetro Ipv4PrefixCount, mas não ambos.
	string	Não	Um ou mais prefixos IPv4 a serem especificados para as interfaces de rede elásticas (ENIs). Valores válidos de N: 1 a 10. Nota Para definir prefixos IPv4 para as interfaces de rede elásticas (ENIs), você deve definir o parâmetro Ipv4Prefix.N ou o parâmetro Ipv4PrefixCount, mas não ambos.	192.168../28
Ipv4PrefixCount	integer	Não	O número de prefixos IPv4 gerados aleatoriamente a serem especificados para as interfaces de rede elásticas (ENIs). Valores válidos: 1 a 10. Nota Para definir prefixos IPv4 para as interfaces de rede elásticas (ENIs), você deve definir o parâmetro Ipv4Prefix.N ou o parâmetro Ipv4PrefixCount, mas não ambos.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AssignedPrivateIpAddressesSet	object	As informações sobre as interfaces de rede elásticas (ENIs) às quais os endereços IP privados secundários são atribuídos.
NetworkInterfaceId	string	O ID da interface de rede elástica (ENI).	eni-bp125p95hhdhn3ot****
PrivateIpSet	object
PrivateIpAddress	array	O conjunto de endereços IP privados atribuídos.
	string	O endereço IP privado atribuído.	192.168..
Ipv4PrefixSet	object
Ipv4Prefixes	array	O conjunto de prefixos IPv4 atribuídos.
	string	O prefixo IPv4 atribuído.	192.168../28

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AssignedPrivateIpAddressesSet": {
    "NetworkInterfaceId": "eni-bp125p95hhdhn3ot****",
    "PrivateIpSet": {
      "PrivateIpAddress": [
        "192.168.**.**"
      ]
    },
    "Ipv4PrefixSet": {
      "Ipv4Prefixes": [
        "192.168.**.**/28"
      ]
    }
  }
}

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.
400	InvalidOperation.Unsupported	%s
400	UnsupportedParameter	%s	O parâmetro especificado não é suportado. Verifique se o parâmetro está correto.
400	InvalidParameter	%s	Os parâmetros da solicitação atual são inválidos. Tente novamente.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	Esta operação não é permitida no status atual do serviço de nuvem.
400	InvalidOperation.InvalidEniState	%s	O estado atual do controlador de interface de rede (NIC) não permite esta operação.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Você não pode desvincular a ENI primária de uma instância.
400	MissingParameter	%s	Um parâmetro obrigatório está ausente.
400	Forbidden.RegionId	%s	O serviço está atualmente indisponível nesta região.
400	InvalidAction	%s	A operação é inválida.
400	InvalidPrivateIpAddress.Duplicated	Specified private IP address is duplicated.
400	InvalidPrivateIpAddress.Malformed	%s
400	InvalidSecondaryPrivateIpAddressCount.Malformed	%s
400	InvalidParameter.Conflict	%s	Os parâmetros estão em conflito entre si.
400	InvalidOperation.InstanceNotSupportMulitipleIp	Assigning private ip for instance in cloud box is unsupported.	O ambiente CloudBox não oferece suporte à atribuição de vários endereços IP a uma instância.
400	IncorrectVSwitchStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created Available", but current state is "%s".	O vSwitch especificado está em estado pendente e não pode ser excluído.
400	QuotaExceeded.PrivateIpAddress	There are not enough private IPs in the specified VSwitch.	Os endereços IP privados no vSwitch foram esgotados. Use um vSwitch diferente.
400	InvalidStatus.InstanceIsMigrating	The ECS which ENI is attached to is migrating. Please try again later.	A instância à qual a ENI está anexada está sendo migrada. Tente novamente mais tarde.
400	InvalidEniId.Malformed	The specified parameter "NetworkInterfaceId" is not valid. Ensure you provide the full ENI id in the form eni-xxx.	O ID da ENI especificado está em um formato inválido.
400	InvalidVSwitch.IllegalStatus	The operation is not allowed in the current VSwitch state. Expecting state includes "Created", but current state is "%s".	O status atual do vSwitch não é compatível com esta operação.
400	InvalidVSwitch.Ipv4NotEnabled	The specify VSwitch of ECS does not support IPv4.
400	InvalidOperation.CidrAllocateNotEnough	There is no enough cidr to allocate.	Não há blocos CIDR suficientes disponíveis para alocação.
400	TaskConflict	The operation is too frequent, please wait a moment and try again.	As operações de EIP são muito frequentes.
400	InvalidEniId.NotFound	The specified ENI ID does not exist.	A instância especificada é inválida.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support IP prefix feature.	A região não oferece suporte à alocação de prefixos de IP.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente.
500	InvalidParameter.PrivateIpCount	The current privateIpCount is not in the range 1.0 through 100.0.	O privateIpCount atual não está dentro do intervalo de 1 a 100.
403	InvalidUserType.NotSupported	%s	O tipo de usuário é inválido.
403	Abs.InvalidAccount.NotFound	%s	A conta não foi encontrada ou a AccessKey expirou.
403	MissingParameter	%s
403	Forbidden.NotSupportRAM	%s	A execução desta operação não é compatível com usuários do Resource Access Management (RAM).
403	Forbidden.SubUser	%s	Seu usuário RAM atual não tem permissão para realizar operações neste recurso.
403	MaxEniCountExceeded	%s	O número máximo de controladores de interface de rede (NICs) foi excedido.
403	EniPerInstanceLimitExceeded	%s	O número de ENIs para este tipo de instância atingiu o limite máximo.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Esta operação não é permitida porque as zonas não correspondem.
403	InvalidOperation.VpcMismatch	%s	Esta operação não é permitida.
403	SecurityGroupInstanceLimitExceed	%s	O número máximo de instâncias no grupo de segurança foi atingido.
403	InvalidSecurityGroupId.NotVpc	%s	O grupo de segurança especificado é inválido.
403	InvalidOperation.InvalidEniType	%s	Esta operação não é permitida para o tipo de NIC atual.
403	InvalidVSwitchId.IpNotEnough	%s	O número de endereços IP disponíveis no vSwitch especificado é insuficiente.
403	InvalidVSwitchId.IpInvalid	%s	O endereço IP privado especificado é inválido.
403	InvalidIp.IpAssigned	%s	O endereço IP especificado já está atribuído.
403	MaxEniPrivateIpsCountExceeded	%s	O número de endereços IP privados secundários atribuídos à ENI especificada excede o limite. Para mais informações, consulte o resultado de retorno real do placeholder %s na mensagem de erro.
403	Operation.Conflict	%s	Esta operação entra em conflito com outra operação.
403	InvalidOperation.Ipv4CountExceeded	%s	O número de endereços IPv4 atingiu o limite máximo, o que torna a operação inválida.
403	InvalidOperation.EniServiceManaged	%s	A operação é inválida.
403	InvalidIp.IpRepeated	%s	O endereço IP especificado está duplicado.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	O prefixo de IP é inválido. Não está no formato CIDR.
403	InvalidIp.IpPrefixMaskIllegal	The current IP prefix mask is illegal.	A máscara de prefixo de IP é inválida.
403	InvalidIp.IpPrefixMaskNotSame	The IP prefixes %s are illegal.The IP prefix mask must be the same.	As máscaras de prefixo de IP não são iguais.
403	InvalidIp.IpPrefixNotAvailable	The IP prefix is not available.	O prefixo de IP não está disponível.
403	InvalidIp.IpPrefixNotStrict	The IP prefix "%s" must be strict CIDR format.	O prefixo de IP é inválido porque não é um bloco CIDR estrito.
403	InvalidVSwitchId.IpPrefixNotEnough	The specified VSwitch does not have enough IP prefixes.	O número de prefixos de IP no vSwitch especificado é insuficiente.
403	InvalidIp.IpPrefixMaskInvalid	The IP prefixes mask "%s" is illegal.Ensure the mask is between %s and %s.	A máscara de prefixo de IP é inválida e não está dentro do intervalo válido.
403	InvalidIp.IpPrefixMustInReserveSegment	The IP prefix must be in VSwitch reserved segment. Ensure you create reserved segment for the VSwitch.	O prefixo IP é inválido porque não está dentro do bloco CIDR reservado do vSwitch.
403	InvalidOperation.TrunkingIsNotAllowed	The account is not authorized to use trunk ENI or perform trunking operation.	As operações em ENIs trunk não são permitidas. Certifique-se de que sua conta tenha permissão para operar ENIs trunk. Se tiver dúvidas, abra um ticket.
403	InvalidOperation.InvalidEcsState	The status of current instances does not support this operation.	Esta operação não é permitida no status atual do serviço de nuvem.
404	InvalidEcsId.NotFound	%s	A instância especificada é inválida.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	O ID do vSwitch especificado não existe.
404	InvalidSecurityGroupId.NotFound	%s	O grupo de segurança especificado não existe nesta conta. Verifique se o ID do grupo de segurança está correto.
404	InvalidInstanceId.NotFound	%s
404	InvalidOperation.VSwitchCidrReservationNotExist	The specified VSwitch does not have CIDR reservation.	O vSwitch especificado não possui blocos CIDR reservados disponíveis.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.