Modifier un point de terminaison EC2 Instance Connect

Vous pouvez modifier les points de terminaison EC2 Instance Connect existants à l'aide du AWS CLI ou d'un SDK. La EC2 console Amazon ne prend pas en charge la modification des points de terminaison.

Avant de commencer, vous devez disposer des autorisations IAM requises. Pour de plus amples informations, veuillez consulter Autorisations pour créer, décrire, modifier et supprimer des points de terminaison EC2 Instance Connect.

Paramètres modifiables

Vous pouvez modifier les paramètres du point de terminaison EC2 Instance Connect suivants :

Groupes de sécurité

Vous pouvez spécifier de nouveaux groupes de sécurité pour le point de terminaison EC2 Instance Connect. Les nouveaux groupes de sécurité remplacent les groupes de sécurité actuels.

Lorsque vous modifiez les groupes de sécurité, vous devez spécifier :

• Au moins un groupe de sécurité, même s'il ne s'agit que du groupe de sécurité par défaut du VPC.

• Les groupes IDs de sécurité, pas les noms.

Type d’adresse IP

Vous pouvez spécifier un nouveau type d'adresse IP pour le point de terminaison EC2 Instance Connect.

Valeurs valides : ipv4 | dualstack | ipv6

Préserver le paramètre IP du client

Vous pouvez spécifier s'il convient de conserver l'adresse IP du client comme source.

Note

La préservation de l'adresse IP du client n'est prise en charge que sur les points de terminaison IPv4 EC2 Instance Connect. Lors de l'activationPreserveClientIp, le type d'adresse IP existant du point de terminaison doit être ouipv4, si vous modifiez le type d'adresse IP dans la même demande, la nouvelle valeur doit êtreipv4.

AWS CLI

Pour modifier un point de terminaison EC2 Instance Connect

Utilisez la modify-instance-connect-endpointcommande et spécifiez le point de terminaison EC2 Instance Connect et les paramètres à modifier. L'exemple suivant modifie tous les paramètres dans une seule demande.

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

Voici un exemple de sortie.

{
    "Return": true
}

Pour surveiller l'état de la mise à jour

Lors de la modification, le statut du point de terminaison EC2 Instance Connect passe àupdate-in-progress. Le processus de mise à jour s'exécute de manière asynchrone et se termine par un statut update-complete ouupdate-failed. Le point de terminaison utilise son ancienne configuration jusqu'à ce que l'état passe àupdate-complete.

Utilisez la describe-instance-connect-endpointscommande pour surveiller l'état de la mise à jour. Le --query paramètre filtre les résultats sur le State champ.

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

Voici un exemple de sortie.

update-complete

PowerShell

Pour modifier un point de terminaison EC2 Instance Connect

Utilisez l'Edit-EC2InstanceConnectEndpointapplet de commande et spécifiez le point de terminaison Instance EC2 Connect et les paramètres à modifier. L'exemple suivant modifie tous les paramètres dans une seule demande.

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

Voici un exemple de sortie.

True

Pour surveiller l'état de la mise à jour

Lors de la modification, le statut du point de terminaison EC2 Instance Connect passe àupdate-in-progress. Le processus de mise à jour s'exécute de manière asynchrone et se termine par un statut update-complete ouupdate-failed. Le point de terminaison utilise son ancienne configuration jusqu'à ce que l'état passe àupdate-complete.

Utilisez la Get-EC2InstanceConnectEndpointcommande pour surveiller l'état de la mise à jour. .State.Valuefiltre les résultats sur le State terrain.

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

Voici un exemple de sortie.

update-complete