Einen EC2 Instance Connect-Endpunkt ändern

Sie können bestehende EC2 Instance Connect-Endpoints mit dem AWS CLI oder einem SDK ändern. Die EC2 Amazon-Konsole unterstützt keine Endpunktmodifikation.

Bevor Sie beginnen, müssen Sie über die erforderlichen IAM-Berechtigungen verfügen. Weitere Informationen finden Sie unter Berechtigungen zum Erstellen, Beschreiben, Ändern und Löschen von EC2 Instance Connect-Endpoints.

Parameter, die Sie ändern können

Sie können die folgenden EC2 Instance Connect-Endpunktparameter ändern:

Sicherheitsgruppen

Sie können neue Sicherheitsgruppen für den EC2 Instance Connect-Endpunkt angeben. Die neuen Sicherheitsgruppen ersetzen die aktuellen Sicherheitsgruppen.

Wenn Sie die Sicherheitsgruppen ändern, müssen Sie Folgendes angeben:

• Mindestens eine Sicherheitsgruppe, auch wenn es sich nur um die Standardsicherheitsgruppe in der VPC handelt.

• Die IDs der Sicherheitsgruppen, nicht die Namen.

IP-Adresstyp

Sie können einen neuen IP-Adresstyp für den EC2 Instance Connect-Endpunkt angeben.

Zulässige Werte: ipv4 | dualstack | ipv6

Client-IP-Einstellung beibehalten

Sie können angeben, ob die Client-IP-Adresse als Quelle beibehalten werden soll.

Anmerkung

Die Beibehaltung der Client-IP wird nur auf IPv4 EC2 Instance Connect-Endpunkten unterstützt. Bei der Aktivierung PreserveClientIp muss entweder der bestehende IP-Adresstyp des Endpunkts verwendet werdenipv4, oder wenn der IP-Adresstyp in derselben Anfrage geändert wird, muss der neue Wert seinipv4.

AWS CLI

So ändern Sie einen EC2 Instance Connect-Endpunkt

Verwenden Sie den modify-instance-connect-endpointBefehl und geben Sie den EC2 Instance Connect-Endpunkt und die zu ändernden Parameter an. Im folgenden Beispiel werden alle Parameter in einer einzigen Anfrage geändert.

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

Es folgt eine Beispielausgabe.

{
    "Return": true
}

Um den Aktualisierungsstatus zu überwachen

Während der Änderung ändert sich der Status des EC2 Instance Connect-Endpunkts aufupdate-in-progress. Der Aktualisierungsvorgang wird asynchron ausgeführt und mit dem update-failed Status „update-completeOder“ abgeschlossen. Der Endpunkt verwendet seine alte Konfiguration, bis der Status auf update-complete geändert wird.

Verwenden Sie den describe-instance-connect-endpointsBefehl, um den Aktualisierungsstatus zu überwachen. Der --query Parameter filtert die Ergebnisse nach dem State Feld.

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

Es folgt eine Beispielausgabe.

update-complete

PowerShell

So ändern Sie einen EC2 Instance Connect-Endpunkt

Verwenden Sie das Edit-EC2InstanceConnectEndpointCmdlet und geben Sie den EC2 Instance Connect-Endpunkt und die zu ändernden Parameter an. Im folgenden Beispiel werden alle Parameter in einer einzigen Anforderung geändert.

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

Es folgt eine Beispielausgabe.

True

Um den Aktualisierungsstatus zu überwachen

Während der Änderung ändert sich der Status des EC2 Instance Connect-Endpunkts aufupdate-in-progress. Der Aktualisierungsvorgang wird asynchron ausgeführt und mit dem update-failed Status „update-completeOder“ abgeschlossen. Der Endpunkt verwendet seine alte Konfiguration, bis der Status auf update-complete geändert wird.

Verwenden Sie den Get-EC2InstanceConnectEndpointBefehl, um den Aktualisierungsstatus zu überwachen. .State.Valuefiltert die Ergebnisse in das State Feld.

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

Es folgt eine Beispielausgabe.

update-complete