Asigna una o más direcciones IP privadas secundarias a una interfaz de red elástica (ENI). Puede especificar direcciones IP privadas disponibles dentro del bloque CIDR del vSwitch conectado a la ENI. También puede indicar una cantidad de direcciones IP privadas para que se asignen automáticamente desde el bloque CIDR del vSwitch a la ENI.
Notas de uso
La ENI a la que desea asignar direcciones IP privadas secundarias debe estar en estado Available (Available) o In Use (In Use).
Al asignar direcciones IP privadas secundarias a una ENI principal, la instancia de Elastic Compute Service (ECS) asociada a dicha ENI debe encontrarse en estado Running (Running) o Stopped (Stopped).
Cuando una ENI está en estado Available (Available), es posible asignarle hasta 49 direcciones IP privadas secundarias. Si la ENI se encuentra vinculada a una instancia, la cantidad de direcciones IP privadas secundarias que se le pueden asignar depende del tipo de instancia. Para obtener más información, consulte Descripción general de familias de instancias.
Después de invocar esta operación para una ENI, obtenga las direcciones IP privadas secundarias asignadas a partir de la respuesta.
Depuración
Parámetros de solicitud
|
Parámetro |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
Action |
String |
Sí |
AssignPrivateIpAddresses |
La operación que desea ejecutar. Establezca el valor en AssignPrivateIpAddresses. |
|
RegionId |
String |
Sí |
cn-hangzhou |
El ID de región de la ENI. Puede invocar la operación DescribeRegions para consultar la lista de regiones más reciente. |
|
NetworkInterfaceId |
String |
Sí |
eni-bp67acfmxazb4p**** |
El ID de la ENI. |
|
SecondaryPrivateIpAddressCount |
Integer |
No |
1 |
La cantidad de direcciones IP privadas que se asignarán automáticamente desde el bloque CIDR del vSwitch conectado a la ENI. Para asignar direcciones IP privadas secundarias a la ENI, no especifique simultáneamente |
|
ClientToken |
String |
No |
123e4567-e89b-12d3-a456-426655440000 |
El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero asegúrese de que sea único entre distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia. |
|
PrivateIpAddress.N |
String |
No |
10.1.. |
Dirección IP privada secundaria N, seleccionada dentro del bloque CIDR del vSwitch conectado a la ENI. Valores válidos de N:
Nota
Para asignar direcciones IP privadas secundarias a la ENI, no especifique simultáneamente |
|
Ipv4Prefix.N |
String |
No |
192.168../28 |
Prefijo IPv4 N. Valores válidos de N: 1 a 10. Nota
Para asignar prefijos IPv4 a la ENI, especifique Ipv4Prefix.N o Ipv4PrefixCount, pero no ambos. |
|
Ipv4PrefixCount |
Integer |
No |
1 |
La cantidad de prefijos IPv4 que se generarán aleatoriamente para la ENI. Valores válidos: 1 a 10. Nota
Para asignar prefijos IPv4 a la ENI, especifique Ipv4Prefix.N o Ipv4PrefixCount, pero no ambos. |
Parámetros de respuesta
|
Parámetro |
Tipo |
Ejemplo |
Descripción |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
El ID de la solicitud. |
|
AssignedPrivateIpAddressesSet |
Object |
Las direcciones IP privadas secundarias asignadas a la ENI. |
|
|
NetworkInterfaceId |
String |
eni-bp125p95hhdhn3ot**** |
El ID de la ENI. |
|
PrivateIpSet |
Array of String |
192.168.. |
Las direcciones IP privadas secundarias. |
|
Ipv4PrefixSet |
Array of String |
192.168../28 |
Los prefijos IPv4. |
Ejemplos
Solicitudes de ejemplo
https://ecs.aliyuncs.com/?Action=AssignPrivateIpAddresses
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&PrivateIpAddress.1=10.1.**.**
&PrivateIpAddress.2=10.1.**.**
&<Common request parameters>Respuestas exitosas de ejemplo
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 error
|
Código de estado HTTP |
Código de error |
Mensaje de error |
Descripción |
|
400 |
Throttling |
Request was denied due to request throttling. |
La solicitud se limitó debido al control de flujo. |
|
400 |
UnsupportedParameter |
%s |
Un parámetro especificado no es compatible. |
|
400 |
InvalidParameter |
%s |
Un parámetro no válido. |
|
400 |
InvalidInstanceID.Malformed |
%s |
Valor de InstanceId no válido. |
|
400 |
InvalidOperation.InvalidEcsState |
%s |
No se puede ejecutar esta operación en la instancia en su estado actual. |
|
400 |
InvalidOperation.InvalidEniState |
%s |
No se puede ejecutar esta operación en la ENI en su estado actual. |
|
400 |
InvalidOperation.DetachPrimaryEniNotAllowed |
%s |
No se puede desvincular la ENI de la instancia. |
|
400 |
MissingParameter |
%s |
No se especificó un parámetro obligatorio. |
|
400 |
Forbidden.RegionId |
%s |
El servicio no está disponible en la región por el momento. |
|
400 |
InvalidAction |
%s |
La operación no es válida. |
|
400 |
IncorrectVSwitchStatus |
The current status of vSwitch does not support this operation. |
No se puede ejecutar esta operación en el vSwitch en su estado actual. |
|
400 |
InvalidPrivateIpAddress.Duplicated |
Specified private IP address is duplicated. |
La dirección IP privada especificada ya está en uso. Intente con otra dirección IP. |
|
400 |
InvalidParameter.Conflict |
%s |
Un parámetro especificado no es válido. Compruebe si existen conflictos de parámetros. %s es una variable. Se devuelve dinámicamente un mensaje de error según las condiciones de la llamada. |
|
403 |
InvalidUserType.NotSupported |
%s |
Su cuenta no admite esta operación. |
|
403 |
Abs.InvalidAccount.NotFound |
%s |
Su cuenta de Alibaba Cloud no existe o su par de AccessKey ha caducado. |
|
403 |
Forbidden.NotSupportRAM |
%s |
Los usuarios de Resource Access Management (RAM) no tienen acceso a esta operación. |
|
403 |
Forbidden.SubUser |
%s |
No tiene acceso al recurso. Póngase en contacto con el propietario de la cuenta de Alibaba Cloud. |
|
403 |
MaxEniCountExceeded |
%s |
Se superó la cantidad máxima de ENI que se pueden gestionar. |
|
403 |
EniPerInstanceLimitExceeded |
%s |
Se alcanzó la cantidad máxima de ENI que se pueden vincular a la instancia. |
|
403 |
InvalidOperation.AvailabilityZoneMismatch |
%s |
La operación no es válida. |
|
403 |
InvalidOperation.VpcMismatch |
%s |
La operación no es válida. Compruebe si la virtual private cloud (VPC) de la operación corresponde a los demás parámetros. |
|
403 |
SecurityGroupInstanceLimitExceed |
%s |
Se alcanzó la cantidad máxima de instancias en el security group especificado. |
|
403 |
InvalidSecurityGroupId.NotVpc |
%s |
Valor de SecurityGroupId no válido. El tipo de red del security group especificado no es VPC. |
|
403 |
InvalidOperation.InvalidEniType |
%s |
No se puede ejecutar esta operación en este tipo de ENI. |
|
403 |
InvalidVSwitchId.IpNotEnough |
%s |
No hay suficientes direcciones IP disponibles dentro del bloque CIDR del vSwitch especificado. |
|
403 |
InvalidVSwitchId.IpInvalid |
%s |
Dirección IP privada no válida. |
|
403 |
InvalidIp.IpAssigned |
%s |
La dirección IP especificada ya está asignada. |
|
403 |
MaxEniPrivateIpsCountExceeded |
%s |
Se superó la cantidad máxima de direcciones IP privadas secundarias que se pueden asignar a la ENI. Para obtener más información, consulte el valor devuelto por el marcador %s en el mensaje de error. |
|
403 |
Operation.Conflict |
%s |
Esta operación entra en conflicto con otra operación en curso. Inténtelo de nuevo más tarde. |
|
403 |
InvalidOperation.Ipv4CountExceeded |
%s |
Se alcanzó la cantidad máxima de direcciones IPv4. |
|
403 |
InvalidOperation.EniServiceManaged |
%s |
La operación no es válida. |
|
403 |
InvalidIp.IpRepeated |
%s |
La dirección IP ya existe. |
|
403 |
InvalidIp.IpPrefixIllegal |
The ip prefixes %s is/are illegal. |
Los prefijos IP no son válidos y no están en notación CIDR. |
|
403 |
InvalidIp.IpPrefixMaskIllegal |
The ip prefix mask is illegal. |
La máscara de prefijo IP no es válida. |
|
403 |
InvalidIp.IpPrefixMaskInvalid |
The ip prefixes mask %s is illegal which must be between %s and %s. |
Las máscaras de prefijo IP no son válidas. |
|
403 |
InvalidIp.IpPrefixMaskNotSame |
The ip prefixes %s are illegal which mask must be same. |
Las máscaras de prefijo IP no son iguales. |
|
403 |
InvalidIp.IpPrefixMustInReserveSegment |
The ip prefix must in vswitch reserve segment. |
El prefijo IP no es válido y no se encuentra en el bloque CIDR reservado del vSwitch. |
|
403 |
InvalidIp.IpPrefixNotAvailable |
The ip prefix is/are not available. |
El prefijo IP no está disponible. |
|
403 |
InvalidIp.IpPrefixNotStrict |
The ip prefix must be strict cidr format. |
El prefijo IP no es válido y no está en notación CIDR. |
|
403 |
InvalidVSwitchId.IpPrefixNotEnough |
The specified vSwitch has not enough ip prefix. |
No hay suficientes prefijos IP disponibles dentro del bloque CIDR del vSwitch especificado. |
|
403 |
MissingParameter |
These parameters %s cannot be both empty. |
No se especificó un parámetro obligatorio. |
|
404 |
InvalidEcsId.NotFound |
%s |
No se encontró el ID de la instancia. |
|
404 |
InvalidEniId.NotFound |
%s |
No se encontró el ID de la ENI. |
|
404 |
InvalidVSwitchId.NotFound |
%s |
No se encontró el vSwitch. |
|
404 |
InvalidSecurityGroupId.NotFound |
%s |
No se encontró el ID del security group. |
|
404 |
InvalidInstanceId.NotFound |
%s |
No se encontró el valor de InstanceId. |
|
500 |
InvalidOperation.RegionNotSupportIpPrefix |
The current region does not support ip prefix. |
No se pueden asignar prefijos IP en la región. |
Para obtener una lista de códigos de error, consulte Códigos de error del servicio.