Memodifikasi EC2 Instance Connect Endpoint

Anda dapat mengubah Titik Akhir EC2 Instance Connect yang ada menggunakan AWS CLI atau SDK. EC2 Konsol Amazon tidak mendukung modifikasi titik akhir.

Sebelum memulai, Anda harus memiliki izin IAM yang diperlukan. Untuk informasi selengkapnya, lihat Izin untuk membuat, mendeskripsikan, memodifikasi, dan menghapus Titik Akhir EC2 Instance Connect.

Parameter yang dapat Anda modifikasi

Anda dapat mengubah parameter EC2 Instance Connect Endpoint berikut:

Grup keamanan

Anda dapat menentukan grup keamanan baru untuk Titik Akhir EC2 Instance Connect. Grup keamanan baru menggantikan grup keamanan saat ini.

Saat memodifikasi grup keamanan, Anda harus menentukan:

• Setidaknya satu grup keamanan, bahkan jika itu hanya grup keamanan default di VPC.

• Kelompok keamanan, bukan nama-nama. IDs

Jenis alamat IP

Anda dapat menentukan jenis alamat IP baru untuk Endpoint EC2 Instance Connect.

Nilai yang valid: ipv4 | dualstack | ipv6

Pertahankan pengaturan IP klien

Anda dapat menentukan apakah akan mempertahankan alamat IP klien sebagai sumbernya.

catatan

Melestarikan IP klien hanya didukung pada Endpoint IPv4 EC2 Instance Connect. Saat mengaktifkanPreserveClientIp, jenis alamat IP titik akhir yang ada harusipv4, atau jika memodifikasi jenis alamat IP dalam permintaan yang sama, nilai baru harus. ipv4

AWS CLI

Untuk memodifikasi Titik Akhir EC2 Instance Connect

Gunakan modify-instance-connect-endpointperintah dan tentukan EC2 Instance Connect Endpoint dan parameter yang akan dimodifikasi. Contoh berikut memodifikasi semua parameter dalam satu permintaan.

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

Berikut ini adalah output contoh.

{
    "Return": true
}

Untuk memantau status pembaruan

Selama modifikasi, status Titik Akhir EC2 Instance Connect berubah menjadiupdate-in-progress. Proses pembaruan berjalan secara asinkron dan dilengkapi dengan status atau. update-complete update-failed Titik akhir menggunakan konfigurasi lamanya hingga status berubah menjadiupdate-complete.

Gunakan describe-instance-connect-endpointsperintah untuk memantau status pembaruan. --queryParameter menyaring hasil ke State lapangan.

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

Berikut ini adalah output contoh.

update-complete

PowerShell

Untuk memodifikasi Titik Akhir EC2 Instance Connect

Gunakan Edit-EC2InstanceConnectEndpointcmdlet dan tentukan Endpoint Instance EC2 Connect dan parameter yang akan dimodifikasi. Contoh berikut memodifikasi semua parameter dalam satu permintaan.

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

Berikut ini adalah output contoh.

True

Untuk memantau status pembaruan

Selama modifikasi, status Titik Akhir EC2 Instance Connect berubah menjadiupdate-in-progress. Proses pembaruan berjalan secara asinkron dan dilengkapi dengan status atau. update-complete update-failed Titik akhir menggunakan konfigurasi lamanya hingga status berubah menjadiupdate-complete.

Gunakan Get-EC2InstanceConnectEndpointperintah untuk memantau status pembaruan. .State.Valuememfilter hasil ke State lapangan.

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

Berikut ini adalah output contoh.

update-complete