Modificare un endpoint EC2 Instance Connect

Puoi modificare gli endpoint EC2 Instance Connect esistenti utilizzando AWS CLI o un SDK. La EC2 console Amazon non supporta la modifica degli endpoint.

Prima di iniziare, devi disporre delle autorizzazioni IAM richieste. Per ulteriori informazioni, consulta Autorizzazioni per creare, descrivere, modificare ed eliminare gli endpoint EC2 Instance Connect.

Parametri che puoi modificare

È possibile modificare i seguenti parametri dell'endpoint EC2 Instance Connect:

Gruppi di sicurezza

È possibile specificare nuovi gruppi di sicurezza per l'endpoint EC2 Instance Connect. I nuovi gruppi di sicurezza sostituiscono i gruppi di sicurezza attuali.

Quando si modificano i gruppi di sicurezza, è necessario specificare:

• Almeno un gruppo di sicurezza, anche se è solo il gruppo di sicurezza predefinito nel VPC.

• I gruppi IDs di sicurezza, non i nomi.

Tipo di indirizzo IP

È possibile specificare un nuovo tipo di indirizzo IP per l'endpoint EC2 Instance Connect.

Valori validi: ipv4 | dualstack | ipv6

Conserva l'impostazione IP del client

È possibile specificare se conservare l'indirizzo IP del client come origine.

Nota

La conservazione dell'IP del client è supportata solo sugli endpoint IPv4 EC2 Instance Connect. Quando si abilitaPreserveClientIp, deve essere il tipo di indirizzo IP esistente dell'endpoint oppureipv4, se si modifica il tipo di indirizzo IP nella stessa richiesta, il nuovo valore deve essere. ipv4

AWS CLI

Per modificare un endpoint EC2 Instance Connect

Utilizzate il modify-instance-connect-endpointcomando e specificate l'endpoint EC2 Instance Connect e i parametri da modificare. L'esempio seguente modifica tutti i parametri in una singola richiesta.

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

Di seguito è riportato un output di esempio.

{
    "Return": true
}

Per monitorare lo stato dell'aggiornamento

Durante la modifica, lo stato dell'endpoint EC2 Instance Connect diventa. update-in-progress Il processo di aggiornamento viene eseguito in modo asincrono e viene completato con uno stato o. update-complete update-failed L'endpoint utilizza la sua vecchia configurazione fino a quando lo stato non cambia a. update-complete

Utilizzate il describe-instance-connect-endpointscomando per monitorare lo stato dell'aggiornamento. Il --query parametro filtra i risultati nel State campo.

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

Di seguito è riportato un output di esempio.

update-complete

PowerShell

Per modificare un endpoint EC2 Instance Connect

Utilizzare il Edit-EC2InstanceConnectEndpointcmdlet e specificare l'endpoint EC2 Instance Connect e i parametri da modificare. L'esempio seguente modifica tutti i parametri in una singola richiesta.

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

Di seguito è riportato un output di esempio.

True

Per monitorare lo stato dell'aggiornamento

Durante la modifica, lo stato dell'endpoint EC2 Instance Connect diventa. update-in-progress Il processo di aggiornamento viene eseguito in modo asincrono e viene completato con uno stato o. update-complete update-failed L'endpoint utilizza la sua vecchia configurazione fino a quando lo stato non cambia a. update-complete

Utilizzate il Get-EC2InstanceConnectEndpointcomando per monitorare lo stato dell'aggiornamento. .State.Valuefiltra i risultati nel State campo.

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

Di seguito è riportato un output di esempio.

update-complete