Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Referensi alat Amazon EC2 AMI
Anda dapat menggunakan perintah alat AMI untuk membuat dan mengelola Linux yang didukung Amazon S3. AMIs Untuk menyiapkan alat, lihat [Siapkan alat Amazon EC2 AMI](set-up-ami-tools.md).
Untuk informasi tentang kunci akses Anda, lihat [Mengelola kunci akses untuk pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) di *Panduan Pengguna IAM*.
**Topics**
+ [ec2- ami-tools-version](#ami-tools-version)
+ [ec2-bundle-image](#ami-bundle-image)
+ [ec2-bundle-vol](#ami-bundle-vol)
+ [ec2-delete-bundle](#ami-delete-bundle)
+ [ec2-download-bundle](#ami-download-bundle)
+ [ec2-migrate-manifest](#ami-migrate-manifest)
+ [ec2-unbundle](#ami-unbundle)
+ [ec2-upload-bundle](#ami-upload-bundle)
+ [Opsi umum untuk alat AMI](#common-args-ami)
## ec2- ami-tools-version
### Deskripsi
Menjelaskan versi alat AMI.
### Sintaksis
**ec2-ami-tools-version**
### Output
Informasi versi.
### Contoh
Perintah contoh ini menampilkan informasi versi untuk alat AMI yang Anda gunakan.
```
[ec2-user ~]$ ec2-ami-tools-version
1.5.2 20071010
```
## ec2-bundle-image
### Deskripsi
Membuat AMI Linux yang didukung Amazon S3 dari image sistem operasi yang dibuat dalam file loopback.
### Sintaksis
****ec2-bundle-image** -c *path* -k *path* -u *account* -i *path* [-d *path*] [--ec2cert *path*] [-r *architecture*] [--productcodes *code1*,*code2*,...] [-B *mapping*] [-p *prefix*]**
### Opsi
*jalur* `-c, --cert`
File sertifikat kunci publik RSA yang dienkode PEM.
Wajib: Ya
*jalur* `-k, --privatekey`
Jalur menuju file kunci RSA yang dienkode PEM. Anda akan perlu menentukan kunci ini untuk membuka paketan ini, jadi simpanlah di tempat yang aman. Perhatikan bahwa kunci tidak harus didaftarkan ke AWS akun Anda.
Wajib: Ya
*akun* `-u, --user `
ID AWS akun pengguna, tanpa tanda hubung.
Wajib: Ya
*jalur* `-i, --image`
Jalur ke gambar yang akan dipaketkan.
Wajib: Ya
*jalur* `-d, --destination`
Direktori untuk membuat paketan.
Default: `/tmp`
Wajib: Tidak
*jalur* `--ec2cert`
Jalur ke sertifikat kunci publik Amazon EC2 X.509 digunakan untuk mengenkripsi manifes gambar.
Wilayah `us-gov-west-1` dan `cn-north-1` menggunakan sertifikat kunci publik non-default dan jalur ke sertifikat tersebut harus ditetapkan dengan opsi ini. Jalur ke sertifikat berbeda-beda tergantung metode instalasi alat AMI. Untuk Amazon Linux, sertifikat terletak di `/opt/aws/amitools/ec2/etc/ec2/amitools/`. Jika Anda menginstal alat AMI dari file RPM atau ZIP di [Siapkan alat Amazon EC2 AMI](set-up-ami-tools.md), sertifikat berada di `$EC2_AMITOOL_HOME/etc/ec2/amitools/`.
Wajib: Hanya untuk Wilayah `us-gov-west-1` dan `cn-north-1`.
*arsitektur* `-r, --arch`
Arsitektur gambar. Jika Anda tidak memberikan arsitektur pada baris perintah, Anda akan diminta memberikannya saat pembuatan paketan dimulai.
Nilai yang valid: `i386` \$1 `x86_64`
Wajib: Tidak
*kode1,kode2,...* `--productcodes`
Kode produk yang dilampirkan ke gambar pada waktu pendaftaran, dipisahkan dengan koma.
Wajib: Tidak
*pemetaan* `-B, --block-device-mapping`
Menentukan bagaimana perangkat blok terpapar ke instans AMI ini jika tipe instans mendukung perangkat yang ditentukan.
Tentukan daftar pasangan kunci-nilai yang dipisahkan koma, di mana setiap kunci adalah nama virtual dan setiap nilai adalah nama perangkat yang terkait. Nama virtual mencakup hal berikut:
+ `ami`—Perangkat sistem file root, seperti yang terlihat oleh instans
+ `root`—Perangkat sistem file root, seperti yang terlihat oleh kernel
+ `swap`—Perangkat pertukaran, seperti yang terlihat oleh instans
+ `ephemeralN`—Volume penyimpanan instans ke-N
Wajib: Tidak
*awalan* `-p, --prefix`
Awalan nama file untuk file AMI yang dipaketkan.
Default: Nama file gambar. Misalnya, jika jalur gambar adalah `/var/spool/my-image/version-2/debian.img`, awalan default-nya adalah `debian.img`.
Wajib: Tidak
*kernel\$1id* `--kernel`
Tidak lagi digunakan. Gunakan [register-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-image.html) untuk mengatur kernel.
Wajib: Tidak
*ramdisk\$1id* `--ramdisk`
Tidak lagi digunakan. Gunakan [register-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-image.html) untuk mengatur disk RAM jika diperlukan.
Wajib: Tidak
### Output
Pesan status yang menjelaskan tahap dan status proses pembuatan paketan.
### Contoh
Contoh ini membuat paketan AMI dari gambar sistem operasi yang dibuat dalam file loopback.
```
[ec2-user ~]$ ec2-bundle-image -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -u 111122223333 -i image.img -d bundled/ -r x86_64
Please specify a value for arch [i386]:
Bundling image file...
Splitting bundled/image.gz.crypt...
Created image.part.00
Created image.part.01
Created image.part.02
Created image.part.03
Created image.part.04
Created image.part.05
Created image.part.06
Created image.part.07
Created image.part.08
Created image.part.09
Created image.part.10
Created image.part.11
Created image.part.12
Created image.part.13
Created image.part.14
Generating digests for each part...
Digests generated.
Creating bundle manifest...
ec2-bundle-image complete.
```
## ec2-bundle-vol
### Deskripsi
Membuat AMI Linux yang didukung Amazon S3 dengan mengompresi, mengenkripsi, dan menandatangani salinan volume root untuk instance.
Amazon EC2 mencoba mewarisi kode produk, pengaturan kernel, pengaturan disk RAM, dan memblokir pemetaan perangkat dari instance.
Secara default, proses paketan mengecualikan file yang mungkin berisi informasi sensitif. File ini termasuk `*.sw`, `*.swo`, `*.swp`, `*.pem`, `*.priv`, `*id_rsa*`, `*id_dsa*` `*.gpg`, `*.jks`, `*/.ssh/authorized_keys`, dan `*/.bash_history`. Untuk menyertakan semua file ini, gunakan opsi `--no-filter`. Untuk menyertakan beberapa file ini, gunakan opsi `--include`.
Untuk informasi selengkapnya, lihat [Buat AMI yang didukung Amazon S3](creating-an-ami-instance-store.md).
### Sintaksis
****ec2-bundle-vol** -c *path* -k *path* -u *account* [-d *path*] [--ec2cert *path*] [-r *architecture*] [--productcodes *code1*,*code2*,...] [-B *mapping*] [--all] [-e *directory1*,*directory2*,...] [-i *file1*,*file2*,...] [--no-filter] [-p *prefix*] [-s *size*] [--[no-]inherit] [-v *volume*] [-P *type*] [-S *script*] [--fstab *path*] [--generate-fstab] [--grub-config *path*]**
### Opsi
*jalur* `-c, --cert`
File sertifikat kunci publik RSA yang dienkode PEM.
Wajib: Ya
*jalur* `-k, --privatekey `
Jalur menuju file kunci RSA yang dienkode PEM milik pengguna.
Wajib: Ya
*akun* `-u, --user`
ID AWS akun pengguna, tanpa tanda hubung.
Wajib: Ya
*tujuan* `-d, --destination`
Direktori untuk membuat paketan.
Default: `/tmp`
Wajib: Tidak
*jalur* `--ec2cert`
Jalur ke sertifikat kunci publik Amazon EC2 X.509 digunakan untuk mengenkripsi manifes gambar.
Wilayah `us-gov-west-1` dan `cn-north-1` menggunakan sertifikat kunci publik non-default dan jalur ke sertifikat tersebut harus ditetapkan dengan opsi ini. Jalur ke sertifikat berbeda-beda tergantung metode instalasi alat AMI. Untuk Amazon Linux, sertifikat terletak di `/opt/aws/amitools/ec2/etc/ec2/amitools/`. Jika Anda menginstal alat AMI dari file RPM atau ZIP di [Siapkan alat Amazon EC2 AMI](set-up-ami-tools.md), sertifikat berada di `$EC2_AMITOOL_HOME/etc/ec2/amitools/`.
Wajib: Hanya untuk Wilayah `us-gov-west-1` dan `cn-north-1`.
*arsitektur* `-r, --arch `
Arsitektur gambar. Jika Anda tidak memberikannya pada baris perintah, Anda akan diminta untuk memberikannya saat pembuatan paketan dimulai.
Nilai yang valid: `i386` \$1 `x86_64`
Wajib: Tidak
*kode1,kode2,...* `--productcodes`
Kode produk yang dilampirkan ke gambar pada waktu pendaftaran, dipisahkan dengan koma.
Wajib: Tidak
*pemetaan* `-B, --block-device-mapping`
Menentukan bagaimana perangkat blok terpapar ke instans AMI ini jika tipe instans mendukung perangkat yang ditentukan.
Tentukan daftar pasangan kunci-nilai yang dipisahkan koma, di mana setiap kunci adalah nama virtual dan setiap nilai adalah nama perangkat yang terkait. Nama virtual mencakup hal berikut:
+ `ami`—Perangkat sistem file root, seperti yang terlihat oleh instans
+ `root`—Perangkat sistem file root, seperti yang terlihat oleh kernel
+ `swap`—Perangkat pertukaran, seperti yang terlihat oleh instans
+ `ephemeralN`—Volume penyimpanan instans ke-N
Wajib: Tidak
`-a, --all`
Membuat paketan semua direktori, termasuk yang ada di sistem file yang dipasang dari jauh.
Wajib: Tidak
*direktori1,direktori2,...* `-e, --exclude `
Daftar jalur dan file direktori mutlak yang akan dikecualikan dari operasi paketan. Parameter ini menimpa opsi `--all`. Jika ada pengecualian, direktori dan subdirektori yang tercantum dengan parameter tidak akan dipaketkan dengan volume.
Wajib: Tidak
*file1,file2,...* `-i, --include `
Daftar file yang akan disertakan dalam operasi paketan. File yang ditentukan akan dikecualikan dari AMI karena mungkin mengandung informasi sensitif.
Wajib: Tidak
`--no-filter`
Jika ditentukan, kami tidak akan mengecualikan file dari AMI karena file tersebut mungkin berisi informasi sensitif.
Wajib: Tidak
*awalan* `-p, --prefix `
Awalan nama file untuk file AMI yang dipaketkan.
Default: `image`
Wajib: Tidak
*ukuran* `-s, --size`
Ukuran, dalam MB (1024 \$1 1024 byte), dari file gambar yang akan dibuat. Ukuran maksimalnya adalah 10240 MB.
Default: 10240
Wajib: Tidak
`--[no-]inherit`
Mengindikasikan apakah gambar harus mewarisi metadata instans (default-nya adalah mewarisi). Pembuatan paketan gagal jika Anda mengaktifkan `--inherit`, tetapi metadata instans tidak dapat diakses.
Wajib: Tidak
*volume* `-v, --volume `
Jalur mutlak ke volume yang dipasang dari tempat untuk membuat paketan.
Default: Direktori root (/)
Wajib: Tidak
*tipe* `-P, --partition`
Menunjukkan apakah gambar disk harus menggunakan tabel partisi. Jika Anda tidak menentukan tipe tabel partisi, default-nya adalah tipe yang digunakan pada perangkat blok induk volume, jika berlaku. Jika tidak, default-nya adalah `gpt`.
Nilai yang valid: `mbr` \$1 `gpt` \$1 `none`
Wajib: Tidak
*skrip* `-S, --script`
Skrip kustomisasi akan dijalankan tepat sebelum pembuatan paketan. Skrip harus menantikan satu argumen, titik pemasangan volume.
Wajib: Tidak
*jalur* `--fstab`
Jalur ke fstab yang akan dipaketkan ke dalam gambar. Jika ini tidak ditentukan, Amazon EC2 bundles /etc/fstab.
Wajib: Tidak
`--generate-fstab`
Bundel volume menggunakan fstab EC2 yang disediakan Amazon.
Wajib: Tidak
`--grub-config`
Jalur menuju file konfigurasi grub alternatif untuk dipaketkan ke dalam gambar. Secara default, `ec2-bundle-vol` menunggu `/boot/grub/menu.lst` atau `/boot/grub/grub.conf` ada pada gambar hasil klona. Opsi ini memungkinkan Anda menentukan jalur ke file konfigurasi grub alternatif, yang kemudian akan disalin menggantikan default (jika ada).
Wajib: Tidak
*kernel\$1id* `--kernel`
Tidak lagi digunakan. Gunakan [register-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-image.html) untuk mengatur kernel.
Wajib: Tidak
*ramdisk\$1id*`--ramdisk`
Tidak lagi digunakan. Gunakan [register-image](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-image.html) untuk mengatur disk RAM jika diperlukan.
Wajib: Tidak
### Output
Pesan status yang menjelaskan tahap dan status proses pemaketan.
### Contoh
Contoh ini membuat AMI paketan dengan mengompresi, mengenkripsi, dan menandatangani snapshot sistem file root mesin lokal.
```
[ec2-user ~]$ ec2-bundle-vol -d /mnt -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -u 111122223333 -r x86_64
Copying / into the image file /mnt/image...
Excluding:
sys
dev/shm
proc
dev/pts
proc/sys/fs/binfmt_misc
dev
media
mnt
proc
sys
tmp/image
mnt/img-mnt
1+0 records in
1+0 records out
mke2fs 1.38 (30-Jun-2005)
warning: 256 blocks unused.
Splitting /mnt/image.gz.crypt...
Created image.part.00
Created image.part.01
Created image.part.02
Created image.part.03
...
Created image.part.22
Created image.part.23
Generating digests for each part...
Digests generated.
Creating bundle manifest...
Bundle Volume complete.
```
## ec2-delete-bundle
### Deskripsi
Menghapus paketan tertentu dari penyimpanan Amazon S3. Setelah menghapus paketan, Anda tidak dapat meluncurkan instans dari AMI terkait.
### Sintaksis
****ec2-delete-bundle** -b *bucket* -a *access\$1key\$1id* -s *secret\$1access\$1key* [-t *token*] [--url *url*] [--region *region*] [--sigv *version*] [-m *path*] [-p *prefix*] [--clear] [--retry] [-y]**
### Opsi
*bucket* `-b, --bucket `
Nama bucket Amazon S3 yang berisi paketan AMI, diikuti dengan awalan jalur opsional yang dibatasi ‘/’
Wajib: Ya
*access\$1key\$1id* `-a, --access-key`
ID kunci AWS akses.
Wajib: Ya
*secret\$1access\$1key* `-s, --secret-key`
Kunci akses AWS rahasia.
Wajib: Ya
*token* `-t, --delegation-token`
Token delegasi untuk diteruskan ke AWS permintaan. Untuk informasi selengkapnya, lihat [Kredensyal keamanan sementara](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) di Panduan Pengguna *IAM*.
Wajib: Hanya saat Anda menggunakan kredensial keamanan sementara.
Default: Nilai dari variabel lingkungan `AWS_DELEGATION_TOKEN` (jika diatur).
*wilayah*`--region`
Wilayah yang akan digunakan dalam tanda tangan permintaan.
Default: `us-east-1`
Wajib: Wajib jika menggunakan tanda tangan versi 4
*version* `--sigv`
Versi tanda tangan yang digunakan ketika menandatangani permintaan.
Nilai yang valid: `2` \$1 `4`
Default: `4`
Wajib: Tidak
*path*`-m, --manifest`
Jalur ke file manifes.
Wajib: Anda harus menentukan `--prefix` atau `--manifest`.
*awalan* `-p, --prefix`
Awalan nama file AMI yang dipaketkan. Berikan seluruh awalan. Misalnya, jika awalannya adalah image.img, gunakan `-p image.img` dan bukan `-p image`.
Wajib: Anda harus menentukan `--prefix` atau `--manifest`.
`--clear`
Menghapus bucket Amazon S3 jika kosong setelah menghapus paketan tertentu.
Wajib: Tidak
`--retry`
Otomatis mencoba ulang semua kesalahan Amazon S3, hingga lima kali per operasi.
Wajib: Tidak
`-y, --yes`
Secara otomatis mengasumsikan jawaban semua permintaan adalah ya.
Wajib: Tidak
### Output
Amazon EC2 menampilkan pesan status yang menunjukkan tahapan dan status proses penghapusan.
### Contoh
Contoh ini menghapus paketan dari Amazon S3.
```
[ec2-user ~]$ ec2-delete-bundle -b amzn-s3-demo-bucket -a your_access_key_id -s your_secret_access_key
Deleting files:
amzn-s3-demo-bucket/image.manifest.xml
amzn-s3-demo-bucket/image.part.00
amzn-s3-demo-bucket/image.part.01
amzn-s3-demo-bucket/image.part.02
amzn-s3-demo-bucket/image.part.03
amzn-s3-demo-bucket/image.part.04
amzn-s3-demo-bucket/image.part.05
amzn-s3-demo-bucket/image.part.06
Continue? [y/n]
y
Deleted amzn-s3-demo-bucket/image.manifest.xml
Deleted amzn-s3-demo-bucket/image.part.00
Deleted amzn-s3-demo-bucket/image.part.01
Deleted amzn-s3-demo-bucket/image.part.02
Deleted amzn-s3-demo-bucket/image.part.03
Deleted amzn-s3-demo-bucket/image.part.04
Deleted amzn-s3-demo-bucket/image.part.05
Deleted amzn-s3-demo-bucket/image.part.06
ec2-delete-bundle complete.
```
## ec2-download-bundle
### Deskripsi
Mengunduh Linux yang didukung Amazon S3 yang ditentukan AMIs dari penyimpanan Amazon S3.
### Sintaksis
****ec2-download-bundle** -b *bucket* -a *access\$1key\$1id* -s *secret\$1access\$1key* -k *path* [--url *url*] [--region *region*] [--sigv *version*] [-m *file*] [-p *prefix*] [-d *directory*] [--retry]**
### Opsi
*bucket* `-b, --bucket`
Nama bucket Amazon S3 tempat paketan berada, diikuti dengan awalan jalur opsional yang dibatasi ‘/’.
Wajib: Ya
*access\$1key\$1id* `-a, --access-key`
ID kunci AWS akses.
Wajib: Ya
*secret\$1access\$1key* `-s, --secret-key`
Kunci akses AWS rahasia.
Wajib: Ya
*jalur* `-k, --privatekey`
Kunci privat yang digunakan untuk mendekripsi manifes.
Wajib: Ya
*url* `--url`
URL layanan Amazon S3.
Default: `https://s3.amazonaws.com/`
Wajib: Tidak
*wilayah* `--region`
Wilayah yang akan digunakan dalam tanda tangan permintaan.
Default: `us-east-1`
Wajib: Wajib jika menggunakan tanda tangan versi 4
*versi* `--sigv`
Versi tanda tangan yang digunakan ketika menandatangani permintaan.
Nilai yang valid: `2` \$1 `4`
Default: `4`
Wajib: Tidak
*file* `-m, --manifest`
Nama file manifes (tanpa jalur). Kami sarankan Anda untuk menentukan manifes (`-m`) atau awalan(`-p`).
Wajib: Tidak
*awalan* `-p, --prefix `
Awalan nama file untuk file AMI yang dipaketkan.
Default: `image`
Wajib: Tidak
*direktori* `-d, --directory `
Direktori tempat paketan yang diunduh disimpan. Direktori harus ada.
Default: Direktori kerja saat ini.
Wajib: Tidak
`--retry`
Otomatis mencoba ulang semua kesalahan Amazon S3, hingga lima kali per operasi.
Wajib: Tidak
### Output
Pesan status yang menunjukkan berbagai tahap proses pengunduhan ditampilkan.
### Contoh
Contoh ini membuat direktori `bundled` (menggunakan perintah Linux **mkdir**) dan mengunduh paketan dari bucket Amazon S3 `amzn-s3-demo-bucket`.
```
[ec2-user ~]$ mkdir bundled
[ec2-user ~]$ ec2-download-bundle -b amzn-s3-demo-bucket/bundles/bundle_name -m image.manifest.xml -a your_access_key_id -s your_secret_access_key -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -d mybundle
Downloading manifest image.manifest.xml from amzn-s3-demo-bucket to mybundle/image.manifest.xml ...
Downloading part image.part.00 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.00 ...
Downloaded image.part.00 from amzn-s3-demo-bucket
Downloading part image.part.01 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.01 ...
Downloaded image.part.01 from amzn-s3-demo-bucket
Downloading part image.part.02 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.02 ...
Downloaded image.part.02 from amzn-s3-demo-bucket
Downloading part image.part.03 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.03 ...
Downloaded image.part.03 from amzn-s3-demo-bucket
Downloading part image.part.04 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.04 ...
Downloaded image.part.04 from amzn-s3-demo-bucket
Downloading part image.part.05 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.05 ...
Downloaded image.part.05 from amzn-s3-demo-bucket
Downloading part image.part.06 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.06 ...
Downloaded image.part.06 from amzn-s3-demo-bucket
```
## ec2-migrate-manifest
### Deskripsi
Memodifikasi AMI Linux yang didukung Amazon S3 (misalnya, sertifikat, kernel, dan disk RAM) sehingga mendukung Wilayah yang berbeda.
### Sintaksis
****ec2-migrate-manifest** -c *path* -k *path* -m *path* \$1(-a *access\$1key\$1id* -s *secret\$1access\$1key* --region *region*) \$1 (--no-mapping)\$1 [--ec2cert *ec2\$1cert\$1path*] [--kernel *kernel-id*] [--ramdisk *ramdisk\$1id*]**
### Opsi
*jalur* `-c, --cert`
File sertifikat kunci publik RSA yang dienkode PEM.
Wajib: Ya
*jalur* `-k, --privatekey`
Jalur menuju file kunci RSA yang dienkode PEM milik pengguna.
Wajib: Ya
*jalur* `--manifest`
Jalur ke file manifes.
Wajib: Ya
*access\$1key\$1id* `-a, --access-key`
ID kunci AWS akses.
Wajib: Wajib jika menggunakan pemetaan otomatis.
*secret\$1access\$1key* `-s, --secret-key `
Kunci akses AWS rahasia.
Wajib: Wajib jika menggunakan pemetaan otomatis.
*wilayah* `--region`
Wilayah untuk dicari di file pemetaan.
Wajib: Wajib jika menggunakan pemetaan otomatis.
`--no-mapping`
Menonaktifkan pemetaan otomatis kernel dan disk RAM.
Selama migrasi, Amazon EC2 mengganti disk kernel dan RAM dalam file manifes dengan kernel dan disk RAM yang dirancang untuk wilayah tujuan. Kecuali parameter `--no-mapping` diberikan, `ec2-migrate-bundle` dapat menggunakan operasi `DescribeRegions` dan `DescribeImages` untuk melakukan pemetaan otomatis.
Wajib: Wajib jika Anda tidak menyediakan opsi `-a`, `-s`, dan `--region` yang digunakan untuk pemetaan otomatis.
*jalur* `--ec2cert`
Jalur ke sertifikat kunci publik Amazon EC2 X.509 digunakan untuk mengenkripsi manifes gambar.
Wilayah `us-gov-west-1` dan `cn-north-1` menggunakan sertifikat kunci publik non-default dan jalur ke sertifikat tersebut harus ditetapkan dengan opsi ini. Jalur ke sertifikat berbeda-beda tergantung metode instalasi alat AMI. Untuk Amazon Linux, sertifikat terletak di `/opt/aws/amitools/ec2/etc/ec2/amitools/`. Jika Anda menginstal alat AMI dari file ZIP di [Siapkan alat Amazon EC2 AMI](set-up-ami-tools.md), sertifikat berada di `$EC2_AMITOOL_HOME/etc/ec2/amitools/`.
Wajib: Hanya untuk Wilayah `us-gov-west-1` dan `cn-north-1`.
*kernel\$1id* `--kernel`
ID kernel yang akan dipilih.
Kami menyarankan Anda menggunakan PV-GRUB dibandingkan kernel dan disk RAM. Untuk informasi selengkapnya, lihat [Kernel yang disediakan pengguna](https://docs.aws.amazon.com/linux/al2/ug/UserProvidedKernels.html) di *Panduan Pengguna Amazon Linux 2*.
Wajib: Tidak
*ramdisk\$1id* `--ramdisk`
ID disk RAM yang akan dipilih.
Kami menyarankan Anda menggunakan PV-GRUB dibandingkan kernel dan disk RAM. Untuk informasi selengkapnya, lihat [Kernel yang disediakan pengguna](https://docs.aws.amazon.com/linux/al2/ug/UserProvidedKernels.html) di *Panduan Pengguna Amazon Linux 2*.
Wajib: Tidak
### Output
Pesan status yang menjelaskan tahap dan status proses pembuatan paketan.
### Contoh
Contoh ini menyalin AMI yang ditentukan dalam manifes `my-ami.manifest.xml` dari AS ke UE.
```
[ec2-user ~]$ ec2-migrate-manifest --manifest my-ami.manifest.xml --cert cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem --privatekey pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem --region eu-west-1
Backing up manifest...
Successfully migrated my-ami.manifest.xml It is now suitable for use in eu-west-1.
```
## ec2-unbundle
### Deskripsi
Membuat ulang bundel dari AMI Linux yang didukung Amazon S3.
### Sintaksis
****ec2-unbundle** -k *path* -m *path* [-s *source\$1directory*] [-d *destination\$1directory*]**
### Opsi
*jalur* `-k, --privatekey`
Jalur menuju file kunci RSA yang dienkode PEM.
Wajib: Ya
*jalur* `-m, --manifest`
Jalur ke file manifes.
Wajib: Ya
*source\$1directory* `-s, --source`
Direktori yang berisi paketan.
Default: Direktori saat ini.
Wajib: Tidak
*destination\$1directory* `-d, --destination`
Direktori tempat membongkar paketan AMI. Direktori tujuan harus ada.
Default: Direktori saat ini.
Wajib: Tidak
### Contoh
Contoh Linux dan UNIX ini membongkar paketan AMI yang ditentukan dalam file `image.manifest.xml`.
```
[ec2-user ~]$ mkdir unbundled
$ ec2-unbundle -m mybundle/image.manifest.xml -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -s mybundle -d unbundled
$ ls -l unbundled
total 1025008
-rw-r--r-- 1 root root 1048578048 Aug 25 23:46 image.img
```
### Output
Pesan status yang menunjukkan berbagai tahap proses pembongkaran paketan ditampilkan.
## ec2-upload-bundle
### Deskripsi
Mengunggah bundel untuk AMI Linux yang didukung Amazon S3 ke Amazon S3 dan menetapkan daftar kontrol akses (ACLs) yang sesuai pada objek yang diunggah. Untuk informasi selengkapnya, lihat [Buat AMI yang didukung Amazon S3](creating-an-ami-instance-store.md).
**catatan**
Untuk mengunggah objek ke bucket S3 untuk AMI Linux yang didukung Amazon S3, ACLs harus diaktifkan untuk bucket. Jika tidak, Amazon tidak EC2 akan dapat mengatur ACLs objek yang akan diunggah. Jika bucket tujuan Anda menggunakan setelan yang diberlakukan pemilik bucket untuk Kepemilikan Objek S3, ini tidak akan berfungsi karena ACLs dinonaktifkan. Untuk informasi selengkapnya, lihat [Mengontrol kepemilikan objek dan menonaktifkan bucket ACLs Anda](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html).
### Sintaksis
****ec2-upload-bundle** -b *bucket* -a *access\$1key\$1id* -s *secret\$1access\$1key* [-t *token*] -m *path* [--url *url*] [--region *region*] [--sigv *version*] [--acl *acl*] [-d *directory*] [--part *part*] [--retry] [--skipmanifest]**
### Opsi
*bucket* `-b, --bucket`
Nama bucket Amazon S3 untuk menyimpan paketan, diikuti dengan awalan jalur opsional yang dibatasi ‘/’. Jika bucket tidak tersedia, bucket akan dibuat jika namanya tersedia. Selain itu, jika bucket tidak ada dan versi alat AMI adalah 1.5.18 atau yang lebih baru, perintah ini akan ACLs menetapkan bucket.
Wajib: Ya
*access\$1key\$1id* `-a, --access-key`
ID kunci AWS akses Anda.
Wajib: Ya
*secret\$1access\$1key* `-s, --secret-key`
Kunci akses AWS rahasia Anda.
Wajib: Ya
*token* `-t, --delegation-token`
Token delegasi untuk diteruskan ke AWS permintaan. Untuk informasi selengkapnya, lihat [Kredensyal keamanan sementara](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) di Panduan Pengguna *IAM*.
Wajib: Hanya saat Anda menggunakan kredensial keamanan sementara.
Default: Nilai dari variabel lingkungan `AWS_DELEGATION_TOKEN` (jika diatur).
*jalur* `-m, --manifest`
Jalur ke file manifes. File manifes dibuat selama proses pembuatan paketan dan dapat ditemukan di direktori yang berisi paketan tersebut.
Wajib: Ya
*url* `--url`
Tidak lagi digunakan. Gunakan opsi `--region` sebagai gantinya kecuali jika bucket Anda dibatasi ke lokasi `EU` (dan bukan `eu-west-1`). Bendera `--location` adalah satu-satunya cara untuk menarget batasan lokasi tertentu.
URL layanan titik akhir Amazon S3.
Default: `https://s3.amazonaws.com/`
Wajib: Tidak
*wilayah* `--region`
Wilayah yang akan digunakan dalam tanda tangan permintaan untuk bucket S3 tujuan.
+ Jika bucket tidak ada dan Anda tidak menentukan Wilayah, alat akan membuat bucket tanpa batasan lokasi (di `us-east-1`).
+ Jika bucket tidak ada dan Anda menentukan Wilayah, alat akan membuat bucket di Wilayah yang ditentukan.
+ Jika bucket tersedia dan Anda tidak menentukan Wilayah, alat ini akan menggunakan lokasi bucket.
+ Jika bucket tersedia dan Anda menentukan `us-east-1` sebagai Wilayah, alat ini akan menggunakan lokasi aktual bucket tanpa pesan kesalahan apa pun, setiap file yang cocok akan ditimpa.
+ Jika bucket tersedia dan Anda menetapkan Wilayah (selain `us-east-1`) yang tidak sesuai dengan lokasi aktual bucket, alat akan keluar dengan kesalahan.
Jika bucket Anda dibatasi ke lokasi `EU` (dan bukan `eu-west-1`), gunakan bendera `--location` sebagai gantinya. Bendera `--location` adalah satu-satunya cara untuk menarget batasan lokasi tertentu.
Default: `us-east-1`
Wajib: Wajib jika menggunakan tanda tangan versi 4
*versi* `--sigv`
Versi tanda tangan yang digunakan ketika menandatangani permintaan.
Nilai yang valid: `2` \$1 `4`
Default: `4`
Wajib: Tidak
*acl* `--acl`
Kebijakan daftar kontrol akses dari gambar yang dipaketkan.
Nilai yang valid: `public-read` \$1 `aws-exec-read`
Default: `aws-exec-read`
Wajib: Tidak
*direktori* `-d, --directory`
Direktori yang berisi bagian AMI yang dipaketkan.
Default: Direktori yang berisi file manifes (lihat opsi `-m`).
Wajib: Tidak
*bagian* `--part`
Mulai mengunggah bagian tertentu dan semua bagian berikutnya. Sebagai contoh, `--part 04`.
Wajib: Tidak
`--retry`
Otomatis mencoba ulang semua kesalahan Amazon S3, hingga lima kali per operasi.
Wajib: Tidak
`--skipmanifest`
Tidak mengunggah manifes.
Wajib: Tidak
*lokasi* `--location`
Tidak lagi digunakan. Gunakan opsi `--region` sebagai gantinya, kecuali jika bucket Anda dibatasi ke lokasi `EU` (dan bukan `eu-west-1`). Bendera `--location` adalah satu-satunya cara untuk menarget batasan lokasi tersebut.
Batasan lokasi tujuan bucket Amazon S3. Jika bucket tersedia dan Anda menetapkan lokasi yang tidak sesuai dengan lokasi aktual bucket, alat akan keluar dengan kesalahan. Jika bucket tersedia dan Anda tidak menentukan lokasi, alat ini akan menggunakan lokasi bucket. Jika bucket tidak tersedia dan Anda menentukan lokasi, alat akan membuat bucket di lokasi yang ditentukan. Jika bucket tidak ada dan Anda tidak menentukan lokasi, alat akan membuat bucket tanpa batasan lokasi (di `us-east-1`).
Default: Jika `--region` ditentukan, lokasi diatur ke Wilayah yang ditentukan. Jika `--region` tidak ditentukan, lokasi secara default menjadi `us-east-1`.
Wajib: Tidak
### Output
Amazon EC2 menampilkan pesan status yang menunjukkan tahapan dan status proses unggahan.
### Contoh
Contoh ini mengunggah paketan yang ditentukan oleh manifes `image.manifest.xml`.
```
[ec2-user ~]$ ec2-upload-bundle -b amzn-s3-demo-bucket/bundles/bundle_name -m image.manifest.xml -a your_access_key_id -s your_secret_access_key
Creating bucket...
Uploading bundled image parts to the S3 bucket amzn-s3-demo-bucket ...
Uploaded image.part.00
Uploaded image.part.01
Uploaded image.part.02
Uploaded image.part.03
Uploaded image.part.04
Uploaded image.part.05
Uploaded image.part.06
Uploaded image.part.07
Uploaded image.part.08
Uploaded image.part.09
Uploaded image.part.10
Uploaded image.part.11
Uploaded image.part.12
Uploaded image.part.13
Uploaded image.part.14
Uploading manifest ...
Uploaded manifest.
Bundle upload completed.
```
## Opsi umum untuk alat AMI
Sebagian besar alat AMI menerima parameter opsional berikut.
`--help, -h`
Menampilkan pesan bantuan.
`--version`
Menampilkan versi dan pemberitahuan hak cipta.
`--manual`
Menampilkan entri manual.
`--batch`
Berjalan dalam mode batch, menahan perintah interaktif.
`--debug`
Menampilkan informasi yang dapat berguna saat pemecahan masalah.