Modifica un endpoint EC2 Instance Connect - Amazon Elastic Compute Cloud
Parametri che puoi modificare

Modifica un endpoint EC2 Instance Connect

Puoi modificare gli endpoint EC2 Instance Connect esistenti utilizzando AWS CLI o un SDK. La console Amazon EC2 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

Puoi modificare i parametri dell’endpoint EC2 Instance Connect:

Gruppi di sicurezza

Puoi 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, devi specificare:

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

  • Gli ID dei gruppi di sicurezza, non i nomi.

Tipo di indirizzo IP

Puoi specificare un nuovo tipo di indirizzo IP per l’endpoint EC2 Instance Connect.

Valori validi: ipv4 | dualstack | ipv6

Conserva l’impostazione dell’IP del client

Puoi specificare se conservare l’indirizzo IP del client come origine.

Nota

La conservazione dell’IP del client è supportata soltanto sugli endpoint EC2 Instance Connect di IPv4. Quando si abilita PreserveClientIp, il tipo di indirizzo IP esistente dell’endpoint deve essere ipv4, oppure, 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

Utilizza il comando modify-instance-connect-endpoint e specifica 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 cambia in update-in-progress. Il processo di aggiornamento viene eseguito in modo asincrono e viene completato con uno stato update-complete o update-failed. L’endpoint utilizza la sua vecchia configurazione fino a quando lo stato non cambia a update-complete.

Utilizza il comando describe-instance-connect-endpoints per monitorare lo stato dell’aggiornamento. Il parametro --query filtra i risultati nel campo State.

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

Utilizza il cmdlet Edit-EC2InstanceConnectEndpoint e specifica 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 cambia in update-in-progress. Il processo di aggiornamento viene eseguito in modo asincrono e viene completato con uno stato update-complete o update-failed. L’endpoint utilizza la sua vecchia configurazione fino a quando lo stato non cambia a update-complete.

Utilizza il comando Get-EC2InstanceConnectEndpoint per monitorare lo stato dell’aggiornamento. .State.Value filtra i risultati nel campo State.

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

Di seguito è riportato un output di esempio.

update-complete