AMI 工具參考 - Amazon Elastic Compute Cloud

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

AMI 工具參考

您可使用 AMI 工具命令來建立及管理執行個體存放區後端 Linux AMI。欲設定這些工具,請參閱設定 AMI 工具

如需有關存取金鑰的詳細資訊,請參閱《AWS Account Management 參考指南》中的 AWS 帳戶的最佳實務

ec2-ami-tools-version

描述

描述 AMI 工具的版本。

語法

ec2-ami-tools-version

輸出

版本資訊。

範例

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

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

ec2-bundle-image

描述

從迴路檔案中建立之作業系統映像建立執行個體存放區後端 Linux AMI。

語法

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

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

us-gov-west-1cn-north-1 區域使用非預設的公有金鑰憑證,而該憑證的路徑必須以此選項加以指定。憑證的路徑視 AMI 工具的安裝方法而異。以 Amazon Linux 而言,此憑證位於 /opt/aws/amitools/ec2/etc/ec2/amitools/。若您從 RPM 或 ZIP 檔案將 AMI 工具安裝進 設定 AMI 工具,則憑證位於 $EC2_AMITOOL_HOME/etc/ec2/amitools/

必要:僅適用於 us-gov-west-1cn-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

已廢除. 使用 register-image 來視需要設定 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

描述

針對執行個體的根設備磁碟區,透過壓縮、加密並簽署其複本,建立執行個體存放區後端 Linux AMI。

Amazon EC2 會嘗試從執行個體繼承產品代碼、核心設定、RAM 磁碟設定和區塊型設備映射。

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

如需詳細資訊,請參閱 建立執行個體存放區後端 Linux 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

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

us-gov-west-1cn-north-1 區域使用非預設的公有金鑰憑證,而該憑證的路徑必須以此選項加以指定。憑證的路徑視 AMI 工具的安裝方法而異。以 Amazon Linux 而言,此憑證位於 /opt/aws/amitools/ec2/etc/ec2/amitools/。若您從 RPM 或 ZIP 檔案將 AMI 工具安裝進 設定 AMI 工具,則憑證位於 $EC2_AMITOOL_HOME/etc/ec2/amitools/

必要:僅適用於 us-gov-west-1cn-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

已廢除. 使用 register-image 來視需要設定 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。刪除 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

內含綁定 AMI 的 Amazon S3 儲存貯體名稱,其後為選用「/」以分隔路徑字首

必要:是

-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 DOC-EXAMPLE-BUCKET1 -a your_access_key_id -s your_secret_access_key Deleting files: DOC-EXAMPLE-BUCKET1/image.manifest.xml DOC-EXAMPLE-BUCKET1/image.part.00 DOC-EXAMPLE-BUCKET1/image.part.01 DOC-EXAMPLE-BUCKET1/image.part.02 DOC-EXAMPLE-BUCKET1/image.part.03 DOC-EXAMPLE-BUCKET1/image.part.04 DOC-EXAMPLE-BUCKET1/image.part.05 DOC-EXAMPLE-BUCKET1/image.part.06 Continue? [y/n] y Deleted DOC-EXAMPLE-BUCKET1/image.manifest.xml Deleted DOC-EXAMPLE-BUCKET1/image.part.00 Deleted DOC-EXAMPLE-BUCKET1/image.part.01 Deleted DOC-EXAMPLE-BUCKET1/image.part.02 Deleted DOC-EXAMPLE-BUCKET1/image.part.03 Deleted DOC-EXAMPLE-BUCKET1/image.part.04 Deleted DOC-EXAMPLE-BUCKET1/image.part.05 Deleted DOC-EXAMPLE-BUCKET1/image.part.06 ec2-delete-bundle complete.

ec2-download-bundle

描述

從 Amazon S3 儲存體下載指定的執行個體存放區後端 Linux AMIs。

語法

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 命令) 並從 DOC-EXAMPLE-BUCKET1 Amazon S3 儲存貯體下載 bundle。

[ec2-user ~]$ mkdir bundled [ec2-user ~]$ ec2-download-bundle -b DOC-EXAMPLE-BUCKET1/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 DOC-EXAMPLE-BUCKET1 to mybundle/image.manifest.xml ... Downloading part image.part.00 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.00 ... Downloaded image.part.00 from DOC-EXAMPLE-BUCKET1 Downloading part image.part.01 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.01 ... Downloaded image.part.01 from DOC-EXAMPLE-BUCKET1 Downloading part image.part.02 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.02 ... Downloaded image.part.02 from DOC-EXAMPLE-BUCKET1 Downloading part image.part.03 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.03 ... Downloaded image.part.03 from DOC-EXAMPLE-BUCKET1 Downloading part image.part.04 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.04 ... Downloaded image.part.04 from DOC-EXAMPLE-BUCKET1 Downloading part image.part.05 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.05 ... Downloaded image.part.05 from DOC-EXAMPLE-BUCKET1 Downloading part image.part.06 from DOC-EXAMPLE-BUCKET1/bundles/bundle_name to mybundle/image.part.06 ... Downloaded image.part.06 from DOC-EXAMPLE-BUCKET1

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 可能會使用 DescribeRegionsDescribeImages 操作來執行自動映射。

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

--ec2cert path

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

us-gov-west-1cn-north-1 區域使用非預設的公有金鑰憑證,而該憑證的路徑必須以此選項加以指定。憑證的路徑視 AMI 工具的安裝方法而異。以 Amazon Linux 而言,此憑證位於 /opt/aws/amitools/ec2/etc/ec2/amitools/。若您從 ZIP 檔案將 AMI 工具安裝進 設定 AMI 工具,則憑證位於 $EC2_AMITOOL_HOME/etc/ec2/amitools/

必要:僅適用於 us-gov-west-1cn-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 重新建立 bundle。

語法

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,並在所上傳的物件上設定適當的存取控制清單 (ACL)。如需詳細資訊,請參閱 建立執行個體存放區後端 Linux AMI

注意

若要為您的執行個體存放區後端 Linux AMI 將物件上傳到 S3 儲存貯體,必須為儲存貯體啟用 ACL。否則,Amazon EC2 將無法在要上傳的物件上設定 ACL。如果您的目的地儲存貯體將儲存貯體擁有者強制設定用於 S3 物件擁有權,這將無法運作,因為 ACL 已停用。如需詳細資訊,請參閱使用 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 或更新版本,則此命令會設定儲存貯體的 ACL。

必要:是

-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 DOC-EXAMPLE-BUCKET1/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 DOC-EXAMPLE-BUCKET1 ... 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

顯示可用於故障排除問題的資訊。