Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Ubah jenis instans Amazon EC2 dengan skrip bash di AWS CLI
Contoh skrip bash untuk Amazon EC2 ini mengubah jenis instans untuk instans Amazon EC2 menggunakan (). AWS Command Line Interface AWS CLI Ini menghentikan instance jika sedang berjalan, mengubah jenis instance, dan kemudian, jika diminta, memulai ulang instance. Skrip Shell adalah program yang dirancang untuk berjalan di antarmuka baris perintah.
**catatan**
Untuk contoh perintah tambahan, lihat [referensi](https://docs.aws.amazon.com/cli/latest/reference/index.html).
**Topics**
+ [Sebelum Anda mulai](#cli-services-ec2-instance-type-script-prereqs)
+ [Tentang contoh ini](#cli-services-ec2-instance-type-script-about)
+ [Parameter](#cli-services-ec2-instance-type-script-params)
+ [Berkas](#cli-services-ec2-instance-type-script-files.title)
+ [Referensi](#cli-services-ec2-instance-type-script-references)
## Sebelum Anda mulai
Sebelum Anda dapat menjalankan salah satu contoh di bawah ini, hal-hal berikut perlu diselesaikan.
+ Instal dan konfigurasikan AWS CLI. Untuk informasi selengkapnya, lihat [Menginstal atau memperbarui ke versi terbaru dari AWS CLI](getting-started-install.md) dan [Otentikasi dan akses kredensional untuk AWS CLI](cli-chap-authentication.md).
+ Profil yang Anda gunakan harus memiliki izin yang memungkinkan AWS operasi dilakukan oleh contoh.
+ Instans Amazon EC2 yang sedang berjalan di akun yang Anda memiliki izin untuk berhenti dan memodifikasinya. Jika Anda menjalankan skrip pengujian, ia meluncurkan instance untuk Anda, menguji mengubah jenisnya, dan kemudian mengakhiri instance.
+ Sebagai praktik AWS terbaik, berikan kode ini hak istimewa paling sedikit, atau hanya izin yang diperlukan untuk melakukan tugas. Untuk informasi selengkapnya, lihat [Memberikan Hak Istimewa Paling Sedikit](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) di Panduan Pengguna *AWS Identity and Access Management (IAM)*.
+ Kode ini belum diuji di semua AWS Wilayah. Beberapa AWS layanan hanya tersedia di Wilayah tertentu. Untuk informasi selengkapnya, lihat [Titik Akhir Layanan dan Kuota di Panduan](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) *Referensi AWS Umum*.
+ Menjalankan kode ini dapat mengakibatkan biaya ke AWS akun Anda. Adalah tanggung jawab Anda untuk memastikan bahwa sumber daya apa pun yang dibuat oleh skrip ini dihapus ketika Anda selesai dengan mereka.
## Tentang contoh ini
Contoh ini ditulis sebagai fungsi dalam file skrip shell `change_ec2_instance_type.sh` yang Anda dapat `source` dari skrip lain atau dari baris perintah. Setiap file skrip berisi komentar yang menjelaskan masing-masing fungsi. Setelah fungsi dalam memori, Anda dapat memanggilnya dari baris perintah. Misalnya, perintah berikut mengubah jenis instance yang ditentukan menjadi`t2.nano`:
```
$ source ./change_ec2_instance_type.sh
$ ./change_ec2_instance_type -i *instance-id* -t new-type
```
Untuk contoh lengkap dan file skrip yang dapat diunduh, lihat [Mengubah Jenis Instans Amazon EC2](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli/bash-linux/ec2/change-ec2-instance-type) di Repositori *AWS Contoh Kode*. *GitHub*
## Parameter
**-i** - *(string)* Menentukan ID contoh untuk memodifikasi.
**-t** - *(string)* Menentukan jenis instans Amazon EC2 untuk beralih ke.
**-r** - *(switch)* Secara default, ini tidak disetel. Jika `-r` disetel, restart instance setelah sakelar tipe.
**-f** - *(switch)* Secara default, skrip meminta pengguna untuk mengonfirmasi mematikan instance sebelum beralih. Jika `-f` disetel, fungsi tidak meminta pengguna sebelum mematikan instance untuk membuat sakelar tipe
**-v** - *(switch)* Secara default, skrip beroperasi secara diam-diam dan menampilkan output hanya jika terjadi kesalahan. Jika `-v` diatur, fungsi menampilkan status di seluruh operasinya.
## Berkas
**`change_ec2_instance_type.sh`**
File skrip utama berisi `change_ec2_instance_type()` fungsi yang melakukan tugas-tugas berikut:
+ Memverifikasi bahwa instans Amazon EC2 yang ditentukan ada.
+ Kecuali `-f` dipilih, memperingatkan pengguna sebelum menghentikan instance.
+ Mengubah jenis instance
+ Jika Anda menyetel`-r`, restart instance dan mengonfirmasi bahwa instance sedang berjalan
Lihat kode untuk `[change\$1ec2\$1instance\$1type.sh](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/aws-cli/bash-linux/ec2/change-ec2-instance-type/change_ec2_instance_type.sh)` aktif *GitHub*.
**`test_change_ec2_instance_type.sh`**
`test_change_ec2_instance_type.sh`Skrip file menguji berbagai jalur kode untuk `change_ec2_instance_type` fungsi tersebut. Jika semua langkah dalam skrip pengujian berfungsi dengan benar, skrip pengujian menghapus semua sumber daya yang dibuatnya.
Anda dapat menjalankan skrip pengujian dengan parameter berikut:
+ **-v** - *(switch)* Setiap tes menunjukkan pass/failure status saat mereka berjalan. Secara default, tes berjalan diam-diam dan output hanya mencakup pass/failure status keseluruhan akhir.
+ **-i** - *(beralih)* Skrip berhenti setelah setiap tes untuk memungkinkan Anda menelusuri hasil perantara dari setiap langkah. Memungkinkan Anda memeriksa status instans saat ini menggunakan konsol Amazon EC2. Script melanjutkan ke langkah berikutnya setelah Anda menekan *ENTER* pada prompt.
Lihat kode untuk `[test\$1change\$1ec2\$1instance\$1type.sh](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/aws-cli/bash-linux/ec2/change-ec2-instance-type/test_change_ec2_instance_type.sh)` aktif *GitHub*.
**`awsdocs_general.sh`**
File skrip `awsdocs_general.sh` menyimpan fungsi tujuan umum yang digunakan di seluruh contoh lanjutan untuk file AWS CLI.
Lihat kode untuk `[awsdocs\$1general.sh](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/aws-cli/bash-linux/ec2/change-ec2-instance-type/awsdocs_general.sh)` aktif *GitHub*.
## Referensi
**AWS CLI Referensi:**
+ `[aws ec2](https://docs.aws.amazon.com/cli/v1/reference/ec2/index.html)`
+ `[aws ec2 describe-instances](https://docs.aws.amazon.com/cli/v1/reference/ec2/describe-instances.html)`
+ `[aws ec2 modify-instance-attribute](https://docs.aws.amazon.com/cli/v1/reference/ec2/modify-instance-attribute.html)`
+ `[aws ec2 start-instances](https://docs.aws.amazon.com/cli/v1/reference/ec2/start-instances.html)`
+ `[aws ec2 stop-instances](https://docs.aws.amazon.com/cli/v1/reference/ec2/stop-instances.html)`
+ `[aws ec2 wait instance-running](https://docs.aws.amazon.com/cli/v1/reference/ec2/wait/instance-running.html)`
+ `[aws ec2 wait instance-stopped](https://docs.aws.amazon.com/cli/v1/reference/ec2/wait/instance-stopped.html)`
**Referensi lainnya:**
+ [Dokumentasi Cloud Komputasi Elastis Amazon](https://docs.aws.amazon.com/ec2/)
+ Untuk melihat dan berkontribusi pada AWS SDK dan contoh AWS CLI kode, lihat [Repositori Contoh AWS Kode](https://github.com/awsdocs/aws-doc-sdk-examples/) di. *GitHub*