Modificación de un punto de conexión de EC2 Instance Connect - Amazon Elastic Compute Cloud
Parámetros que puede modificar

Modificación de un punto de conexión de EC2 Instance Connect

Puede modificar los puntos de conexión de Instance Connect de EC2 existentes mediante la AWS CLI o un SDK. La consola de Amazon EC2 no admite la modificación de puntos de conexión.

Antes de poder comenzar, debe tener los permisos de IAM necesarios. Para obtener más información, consulte Permisos para crear, describir, modificar y eliminar los puntos de conexión de EC2 Instance Connect.

Parámetros que puede modificar

Puede modificar los parámetros de punto de conexión de EC2 Instance Connect:

Grupos de seguridad

Puede especificar nuevos grupos de seguridad para el punto de conexión de EC2 Instance Connect. Los nuevos grupos de seguridad sustituyen a los grupos de seguridad actuales.

Al modificar los grupos de seguridad, debe especificar:

  • Al menos un grupo de seguridad, aunque solo sea el grupo de seguridad predeterminado de la VPC.

  • Los ID de los grupos de seguridad, no los nombres.

Tipo de dirección IP

Puede especificar un nuevo tipo de dirección IP para el punto de conexión de EC2 Instance Connect.

Valores válidos: ipv4 | dualstack | ipv6

Conservación de la configuración de IP del cliente

Puede especificar si desea conservar la dirección IP del cliente como origen.

nota

La conservación de la IP del cliente solo se admite en los puntos de conexión IPv4 de EC2 Instance Connect. Al habilitar PreserveClientIp, el tipo de dirección IP existente en el punto de conexión debe ser ipv4, o si se modifica el tipo de dirección IP en la misma solicitud, el nuevo valor debe ser ipv4.

AWS CLI
Modificación de un punto de conexión de EC2 Instance Connect

Utilice el comando modify-instance-connect-endpoint y especifique el punto de conexión de EC2 Instance Connect y los parámetros a modificar. El siguiente ejemplo modifica todos los parámetros en una única solicitud.

aws ec2 modify-instance-connect-endpoint \
    --instance-connect-endpoint-id eice-0123456789example \
    --security-group-ids sg-0123456789example \
    --ip-address-type dualstack \
    --no-preserve-client-ip

A continuación, se muestra un ejemplo del resultado.

{
    "Return": true
}
Monitoreo del estado de la actualización

Durante la modificación, el estado del punto de conexión de EC2 Instance Connect cambia a update-in-progress. El proceso de actualización se ejecuta de forma asíncrona y finaliza con un estado update-complete o update-failed. El punto de conexión utiliza su configuración anterior hasta que el estado cambie a update-complete.

Utilice el comando describe-instance-connect-endpoints para monitorear el estado de la actualización. El parámetro --query filtra los resultados y los envía al campo State.

aws ec2 describe-instance-connect-endpoints \
    --instance-connect-endpoint-ids eice-0123456789example \
    --query InstanceConnectEndpoints[*].State --output text

A continuación, se muestra un ejemplo del resultado.

update-complete
PowerShell
Modificación de un punto de conexión de EC2 Instance Connect

Utilice el cmdlet Edit-EC2InstanceConnectEndpoint y especifique el punto de conexión de EC2 Instance Connect y los parámetros a modificar. El siguiente ejemplo modifica todos los parámetros en una única solicitud.

Edit-EC2InstanceConnectEndpoint `
    -InstanceConnectEndpointId eice-0123456789example `
    -SecurityGroupIds sg-0123456789example `
    -IpAddressType dualstack `
    -PreserveClientIp $false

A continuación, se muestra un ejemplo del resultado.

True
Monitoreo del estado de la actualización

Durante la modificación, el estado del punto de conexión de EC2 Instance Connect cambia a update-in-progress. El proceso de actualización se ejecuta de forma asíncrona y finaliza con un estado update-complete o update-failed. El punto de conexión utiliza su configuración anterior hasta que el estado cambie a update-complete.

Utilice el comando Get-EC2InstanceConnectEndpoint para monitorear el estado de la actualización. .State.Valuefiltra los resultados en el campo State.

(Get-EC2InstanceConnectEndpoint -InstanceConnectEndpointId "eice-0123456789example").State.Value

A continuación, se muestra un ejemplo del resultado.

update-complete