Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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.
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
