ec2-ami-tools-version ec2-bundle-image ec2-bundle-vol ec2-delete-bundle ec2-download-bundle ec2-migrate-manifest ec2-unbundle ec2-upload-bundle 常用選項

Amazon EC2 AMI 工具參考

您可以使用AMI工具命令來建立和管理執行個體存放區支援的 Linux。AMIs欲設定這些工具，請參閱設置 Amazon EC2 AMI 工具。

如需有關存取金鑰的資訊，請參閱《使IAM用指南》中的〈管理使用IAM者的存取金鑰〉。

命令

ec2-ami-tools-version
ec2-bundle-image
ec2-bundle-vol
ec2-delete-bundle
ec2-download-bundle
ec2-migrate-manifest
ec2-unbundle
ec2-upload-bundle
AMI工具的常用選項

ec2-ami-tools-version

描述

描述AMI工具的版本。

語法

ec2-ami-tools-version

輸出

版本資訊。

範例

此範例指令會顯示您正在使用之AMI工具的版本資訊。


[ec2-user ~]$ ec2-ami-tools-version
1.5.2 20071010

ec2-bundle-image

描述

AMI從迴路檔案中建立的作業系統映像檔建立執行個體以商店為基礎的 Linux。

語法

ec2-bundle-image -c path -k path -u account -i path [-d path] [--ec2cert path] [-r architecture] [--productcodes code1,code2,...] [-B mapping] [-p prefix]

選項

-c, --cert path

使用者的PEM編碼RSA公開金鑰憑證檔案。

必要：是

-k, --privatekey path

PEM編碼RSA金鑰檔案的路徑。您必須指定此金鑰來解開此 bundle，因此請將其置於安全位置。請注意，密鑰不必註冊到您的 AWS 帳戶。

必要：是

-u, --user account

使用者的 AWS 帳號 ID，不含破折號。

必要：是

-i, --image path

欲綁定的映像路徑。

必要：是

-d, --destination path

欲建立 bundle 的目錄。

預設：/tmp

必要：否

--ec2cert path

用於加密映像資訊清單EC2之 Amazon X.509 公開金鑰憑證的路徑。

us-gov-west-1 和 cn-north-1 區域使用非預設的公有金鑰憑證，而該憑證的路徑必須以此選項加以指定。憑證的路徑會根據AMI工具的安裝方法而有所不同。以 Amazon Linux 而言，此憑證位於 /opt/aws/amitools/ec2/etc/ec2/amitools/。如果您從中的RPM或ZIP檔案安裝AMI工具設置 Amazon EC2 AMI 工具，則憑證位於$EC2_AMITOOL_HOME/etc/ec2/amitools/。

必要：僅適用於 us-gov-west-1 和 cn-north-1 區域。

-r, --arch architecture

映像架構。若您未於命令列提供架構，則會在綁定開始時提示您輸入架構。

有效值：i386 | x86_64

必要：否

--productcodes code1,code2,...

欲在註冊時連接至映像的產品代碼，以逗號分隔。

必要：否

-B, --block-device-mapping mapping

如果區塊裝置的執行個體類型支援指定的裝置，則定義區塊裝置AMI如何公開給此執行個體。

指定以逗號分隔的索引鍵/值組清單，其中索引鍵為虛擬名稱，而值為相對應的設備名稱。虛擬名稱包括下列：

ami - 執行個體所看見的根檔案系統設備
root - 核心所看見的根檔案系統設備
swap - 執行個體所看見的置換裝置
ephemeralN - 第 N 個執行個體存放磁碟區

必要：否

-p, --prefix prefix

捆綁AMI文件的文件名前綴。

預設：映像檔案名稱。舉例來說，若映像路徑為 /var/spool/my-image/version-2/debian.img，則預設字首為 debian.img。

必要：否

--kernel kernel_id

已廢除. 使用 register-image 來設定核心。

必要：否

--ramdisk ramdisk_id

已廢除。如果需要，使用寄存器映像來設置RAM磁盤。

必要：否

輸出

描述綁定程序階段與狀態的狀態訊息。

範例

此範例會AMI從迴路檔案中建立的作業系統映像建立隨附的。


[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

描述

AMI透過壓縮、加密和簽署執行個體的根裝置磁碟區副本，來建立執行個體存放區支援的 Linux。

Amazon EC2 嘗試從執行個體繼承產品代碼、核心設定、RAM磁碟設定和區塊裝置對應。

根據預設，bundle 程序不包含可能帶有敏感資訊的檔案。這些檔案包含 *.sw、*.swo、*.swp、*.pem、*.priv、*id_rsa*、*id_dsa* *.gpg、*.jks、*/.ssh/authorized_keys 和 */.bash_history。若要包含所有這些檔案，請使用 --no-filter 選項。若要包含這些檔案中的一部分，請使用 --include 選項。

如需詳細資訊，請參閱建立執行個體存放區支援 AMI。

語法

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]

選項

-c, --cert path

使用者的PEM編碼RSA公開金鑰憑證檔案。

必要：是

-k, --privatekey path

使用者PEM編碼RSA金鑰檔案的路徑。

必要：是

-u, --user account

使用者的 AWS 帳號 ID，不含破折號。

必要：是

-d, --destination destination

欲建立 bundle 的目錄。

預設：/tmp

必要：否

--ec2cert path

用於加密映像資訊清單EC2之 Amazon X.509 公開金鑰憑證的路徑。

必要：僅適用於 us-gov-west-1 和 cn-north-1 區域。

-r, --arch architecture

映像架構。若您未於命令列提供架構，則會在綁定開始時提示您提供架構。

有效值：i386 | x86_64

必要：否

--productcodes code1,code2,...

欲在註冊時連接至映像的產品代碼，以逗號分隔。

必要：否

-B, --block-device-mapping mapping

如果區塊裝置的執行個體類型支援指定的裝置，則定義區塊裝置AMI如何公開給此執行個體。

指定以逗號分隔的索引鍵/值組清單，其中索引鍵為虛擬名稱，而值為相對應的設備名稱。虛擬名稱包括下列：

ami - 執行個體所看見的根檔案系統設備
root - 核心所看見的根檔案系統設備
swap - 執行個體所看見的置換裝置
ephemeralN - 第 N 個執行個體存放磁碟區

必要：否

-a, --all

綁定所有目錄，包括遠端掛載之檔案系統上的目錄。

必要：否

-e, --exclude directory1,directory2,...

欲從 bundle 操作排除的絕對目錄路徑和檔案清單。此參數會覆寫 --all 選項。指定排除項目時，隨參數列出的目錄和子目錄將不會與磁碟區一同綁定。

必要：否

-i, --include file1,file2,...

欲納入 bundle 操作的檔案清單。否則，指定的檔案會從中排除，AMI因為它們可能包含敏感資訊。

必要：否

--no-filter

如果有指定，我們不會從中排除檔案，AMI因為檔案可能包含敏感資訊。

必要：否

-p, --prefix prefix

捆綁AMI文件的文件名前綴。

預設：image

必要：否

-s, --size size

欲建立的映像檔案大小，以 MB (1024 * 1024 位元) 表示。大小上限為 10240 MB。

預設：10240

必要：否

--[no-]inherit

指示映像是否繼承執行個體的中繼資料 (預設為繼承)。若啟用 --inherit 但無法存取執行個體中繼資料，則綁定會失敗。

必要：否

-v, --volume volume

欲從中建立 bundle 的掛載磁碟區絕對路徑。

預設：根目錄 (/)

必要：否

-P, --partition type

指示磁碟映像是否使用分割區表格。若未指定分割區表格類型，預設為用於磁碟區父區塊型儲存設備的類型 (若適用)，否則預設為 gpt。

有效值：mbr | gpt | none

必要：否

-S, --script script

欲在綁定前執行的自訂指令碼。此指令碼必須具備單一引數，亦即磁碟區的掛載點。

必要：否

--fstab path

欲綁定至映像的 fstab 路徑。如果沒有指定，Amazon EC2 捆綁包 /etc/fstab。

必要：否

--generate-fstab

使用 Amazon EC2 提供的 fstab 捆綁卷。

必要：否

--grub-config

欲綁定至映像的替代 grub 組態檔案路徑。根據預設，ec2-bundle-vol 預期所複製映像上應存在 /boot/grub/menu.lst 或 /boot/grub/grub.conf。此選項可讓您指定替代 grub 組態檔案路徑，並將其複製以覆蓋預設值 (如有)。

必要：否

--kernel kernel_id

已廢除. 使用 register-image 來設定核心。

必要：否

--ramdiskramdisk_id

已廢除。如果需要，使用寄存器映像來設置RAM磁盤。

必要：否

輸出

描述綁定階段與狀態的狀態訊息。

範例

此範例透AMI過壓縮、加密和簽署本機器根檔案系統的快照集來建立隨附的。


[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

描述

從 Amazon S3 儲存空間刪除指定 bundle。刪除套裝軟體之後，就無法從對應套件啟動執行個體AMI。

語法

ec2-delete-bundle -b bucket -a access_key_id -s secret_access_key [-t token] [--url url] [--region region] [--sigv version] [-m path] [-p prefix] [--clear] [--retry] [-y]

選項

-b, --bucket bucket

包含隨附的 Amazon S3 儲存貯體的名稱AMI，後面接著選用的 '/' 分隔路徑前綴

必要：是

-a, --access-key access_key_id

AWS 存取金鑰識別碼。

必要：是

-s, --secret-key secret_access_key

AWS 秘密存取金鑰。

必要：是

-t, --delegation-token token

要傳遞給 AWS 要求的委派權杖。如需詳細資訊，請參閱使用臨時安全登入資料。

必要：僅適用您使用暫時安全登入資料時。

預設：AWS_DELEGATION_TOKEN 環境變數的值 (如已設定)。

--regionregion

於請求簽章內使用的區域。

預設：us-east-1

必要：若使用簽章第 4 版則為必要

--sigvversion

簽署請求時使用的簽章版本。

有效值：2 | 4

預設：4

必要：否

-m, --manifestpath

指向資訊清單檔案的路徑。

必要：您必須指定 --prefix 或 --manifest。

-p, --prefix prefix

綁定的 AMI 檔案名稱字首。請提供完整字首。舉例來說，若字首為 image.img，則使用 -p image.img 而非 -p image。

必要：您必須指定 --prefix 或 --manifest。

--clear

若 Amazon S3 儲存貯體在刪除指定 bundle 後為空白，則加以刪除。

必要：否

--retry

在所有 Amazon S3 錯誤後自動重試，每次操作至多五次。

必要：否

-y, --yes

自動假設所有提示的答案為 Yes (是)。

必要：否

輸出

Amazon EC2 會顯示狀態訊息，指出刪除程序的階段和狀態。

範例

此範例會自 Amazon S3 刪除一個 bundle。


[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

描述

AMIs從 Amazon S3 儲存下載指定的執行個體以商店支援的 Linux。

語法

ec2-download-bundle -b bucket -a access_key_id -s secret_access_key -k path [--url url] [--region region] [--sigv version] [-m file] [-p prefix] [-d directory] [--retry]

選項

-b, --bucket bucket

bundle 所在的 Amazon S3 儲存貯體名稱，其後為選用「/」以分隔路徑字首。

必要：是

-a, --access-key access_key_id

AWS 存取金鑰識別碼。

必要：是

-s, --secret-key secret_access_key

AWS 秘密存取金鑰。

必要：是

-k, --privatekey path

用於解密資訊清單的私有金鑰。

必要：是

--url url

Amazon S3 服務URL。

預設：https://s3.amazonaws.com/

必要：否

--region region

於請求簽章內使用的區域。

預設：us-east-1

必要：若使用簽章第 4 版則為必要

--sigv version

簽署請求時使用的簽章版本。

有效值：2 | 4

預設：4

必要：否

-m, --manifest file

不含路徑的資訊清單檔案名稱。建議您指定資訊清單 (-m) 或字首 (-p)。

必要：否

-p, --prefix prefix

捆綁AMI文件的文件名前綴。

預設：image

必要：否

-d, --directory directory

所下載 bundle 的儲存目錄。此目錄必須存在。

預設：目前使用中的目錄。

必要：否

--retry

在所有 Amazon S3 錯誤後自動重試，每次操作至多五次。

必要：否

輸出

會顯示指出下載程序各個階段的狀態訊息。

範例

此範例會建立 bundled 目錄 (使用 Linux mkdir 命令) 並從 amzn-s3-demo-bucket Amazon S3 儲存貯體下載 bundle。


[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

描述

修改執行個體由商店支援的 Linux AMI (例如，其憑證、核心和RAM磁碟)，使其支援不同的區域。

語法

ec2-migrate-manifest -c path -k path -m path {(-a access_key_id -s secret_access_key --region region) | (--no-mapping)} [--ec2cert ec2_cert_path] [--kernel kernel-id] [--ramdisk ramdisk_id]

選項

-c, --cert path

使用者的PEM編碼RSA公開金鑰憑證檔案。

必要：是

-k, --privatekey path

使用者PEM編碼RSA金鑰檔案的路徑。

必要：是

--manifest path

指向資訊清單檔案的路徑。

必要：是

-a, --access-key access_key_id

AWS 存取金鑰識別碼。

必要：若使用自動映射則為必要。

-s, --secret-key secret_access_key

AWS 秘密存取金鑰。

必要：若使用自動映射則為必要。

--region region

欲在映射檔案內查詢的區域。

必要：若使用自動映射則為必要。

--no-mapping

停用核心和RAM磁碟的自動對應。

在移轉期間，Amazon EC2 會以專為目的地區域設計的核心和RAM磁碟取代資訊清單檔案中的核心和磁碟。RAM除非提供 --no-mapping 參數，否則 ec2-migrate-bundle 可能會使用 DescribeRegions 和 DescribeImages 操作來執行自動映射。

必要：若您未提供用於自動映射的 -a、-s 和 --region 選項則為必要。

--ec2cert path

用於加密映像資訊清單EC2之 Amazon X.509 公開金鑰憑證的路徑。

us-gov-west-1 和 cn-north-1 區域使用非預設的公有金鑰憑證，而該憑證的路徑必須以此選項加以指定。憑證的路徑會根據AMI工具的安裝方法而有所不同。以 Amazon Linux 而言，此憑證位於 /opt/aws/amitools/ec2/etc/ec2/amitools/。如果您從中的ZIP檔案安裝AMI工具設置 Amazon EC2 AMI 工具，則憑證位於$EC2_AMITOOL_HOME/etc/ec2/amitools/。

必要：僅適用於 us-gov-west-1 和 cn-north-1 區域。

--kernel kernel_id

欲選取的核心 ID。

重要

我們建議您使用 PV-GRUB 而不是核心和RAM磁碟。如需詳細資訊，請參閱 Amazon Linux 2 使用者指南中的使用者提供的核心。

必要：否

--ramdisk ramdisk_id

要選取的RAM磁碟 ID。

重要

我們建議您使用 PV-GRUB 而不是核心和RAM磁碟。如需詳細資訊，請參閱 Amazon Linux 2 使用者指南中的使用者提供的核心。

必要：否

輸出

描述綁定程序階段與狀態的狀態訊息。

範例

此範例會將my-ami.manifest.xml清單中AMI指定的內容從美國複製到歐盟。


[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

描述

從執行個體存放區支援的 Linux 重新建立套裝軟體。AMI

語法

ec2-unbundle -k path -m path [-s source_directory] [-d destination_directory]

選項

-k, --privatekey path

PEM編碼RSA金鑰檔案的路徑。

必要：是

-m, --manifest path

指向資訊清單檔案的路徑。

必要：是

-s, --source source_directory

內含 bundle 的目錄。

預設：目前的目錄。

必要：否

-d, --destination destination_directory

要在其中取消捆綁的AMI目錄。此目的地目錄必須存在。

預設：目前的目錄。

必要：否

範例

這個 Linux 和UNIX示例解包image.manifest.xml文件中AMI指定的。


[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

輸出

會顯示指出解開程序各個階段的狀態訊息。

ec2-upload-bundle

描述

將執行個體商店支援之 Linux 的服務包上傳AMI到 Amazon S3，並在上傳的物件上設定適當的存取控制清單 (ACLs)。如需詳細資訊，請參閱建立執行個體存放區支援 AMI。

注意

若要將物件上傳至執行個體商店支援 Linux 的 S3 儲存貯體AMI，ACLs必須為儲存貯體啟用。否則，Amazon EC2 將無法在要上傳的對象ACLs上進行設置。如果您的目標儲存貯體使用儲存貯體擁有者強制執行 S3 物件擁有權的設定，這將無法運作，因ACLs為已停用。如需詳細資訊，請參閱使用 S3 物件擁有權控制上傳物件的擁有權。

語法

ec2-upload-bundle -b bucket -a access_key_id -s secret_access_key [-t token] -m path [--url url] [--region region] [--sigv version] [--acl acl] [-d directory] [--part part] [--retry] [--skipmanifest]

選項

-b, --bucket bucket

存放 bundle 的 Amazon S3 儲存貯體名稱，其後為選用「/」以分隔路徑字首。若該儲存貯體不存在，則會加以建立 (如該儲存貯體名稱為可用)。此外，如果值區不存在且AMI工具版本為 1.5.18 或更新版本，則此命令會ACLs為值區設定。

必要：是

-a, --access-key access_key_id

您的 AWS 存取金鑰 ID。

必要：是

-s, --secret-key secret_access_key

您的 AWS 秘密訪問密鑰。

必要：是

-t, --delegation-token token

要傳遞給 AWS 要求的委派權杖。如需詳細資訊，請參閱使用臨時安全登入資料。

必要：僅適用您使用暫時安全登入資料時。

預設：AWS_DELEGATION_TOKEN 環境變數的值 (如已設定)。

-m, --manifest path

指向資訊清單檔案的路徑。資訊清單檔案會於綁定程序期間建立，位於內含 bundle 的目錄。

必要：是

--url url

已廢除. 改用 --region 選項，除非您的儲存貯體被限制在 EU 位置 (而非 eu-west-1)。--location 旗標是確定該特定位置限制的唯一方法。

Amazon S3 端點服務URL。

預設：https://s3.amazonaws.com/

必要：否

--region region

要在請求簽章內針對目的地 S3 儲存貯體使用的區域。

若該儲存貯體不存在且您未指定區域，此工具會建立不具位置限制的儲存貯體 (位於us-east-1)。
若該儲存貯體不存在且您已指定區域，此工具會在該區域建立儲存貯體。
若該儲存貯體存在但您未指定區域，此工具會使用該儲存貯體的位置。
若該儲存貯體存在且您指定 us-east-1 為區域，此工具會使用該儲存貯體的實際位置，不會出現錯誤訊息，而且會覆寫所有現有的相符檔案。
若該儲存貯體存在且您指定的區域 (us-east-1 之外) 與儲存貯體的實際位置不相符，此工具會退出並顯示錯誤。

若您的儲存貯體被限制在 EU 位置 (而非 eu-west-1)，請改用 --location 旗標。--location 旗標是確定該特定位置限制的唯一方法。

預設：us-east-1

必要：若使用簽章第 4 版則為必要

--sigv version

簽署請求時使用的簽章版本。

有效值：2 | 4

預設：4

必要：否

--acl acl

綁定映像的存取控制清單政策。

有效值：public-read | aws-exec-read

預設：aws-exec-read

必要：否

-d, --directory directory

包含隨附AMI零件的目錄。

預設：內含資訊清單檔案的目錄 (請參閱 -m 選項)。

必要：否

--part part

開始上傳指定組件及所有後續組件。例如：--part 04。

必要：否

--retry

在所有 Amazon S3 錯誤後自動重試，每次操作至多五次。

必要：否

--skipmanifest

不會上傳資訊清單。

必要：否

--location location

已廢除. 改用 --region 選項，除非您的儲存貯體被限制在 EU 位置 (而非 eu-west-1)。--location 旗標是確定該特定位置限制的唯一方法。

目的地 Amazon S3儲存貯體的位置限制。若該儲存貯體存在且您指定的位置與儲存貯體的實際位置不相符，此工具會退出並顯示錯誤。若該儲存貯體存在但您未指定位置，此工具會使用該儲存貯體的位置。若該儲存貯體不存在且您已指定位置，此工具會在該位置建立儲存貯體。若該儲存貯體不存在且您未指定位置，此工具會建立不具位置限制的儲存貯體 (位於 us-east-1)。

預設：若已指定 --region，則位置會設定為該指定區域。若未指定 --region，則位置預設為 us-east-1。

必要：否

輸出

Amazon EC2 會顯示狀態訊息，指出上傳程序的階段和狀態。

範例

此範例會上傳 image.manifest.xml 資訊清單指定的 bundle。


[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.

AMI工具的常用選項

大多數工AMI具都接受以下可選參數。

--help, -h: 顯示協助訊息。
--version: 顯示版本及著作權聲明。
--manual: 顯示手動輸入。
--batch: 以批次模式執行，不使用互動式提示。
--debug: 顯示可用於故障排除問題的資訊。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

設定工AMI具

轉換您的執行個體商店支援 AMI