本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
您可使用 AMI 工具命令來建立及管理執行個體存放區後端 Linux AMI。欲設定這些工具,請參閱設定 Amazon EC2 AMI 工具。
如需有關存取金鑰的詳細資訊,請參閱「IAM 使用者指南」中的管理 IAM 使用者的存取金鑰。
命令
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-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-
已廢除. 使用 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
選項。
如需詳細資訊,請參閱 建立執行個體儲存體支援的 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-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 個執行個體存放磁碟區
必要:否
-
-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
來設定核心。 必要:否
--ramdisk
ramdisk_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 存取金鑰 ID。
必要:是
-s, --secret-key
secret_access_key-
AWS 秘密存取金鑰。
必要:是
-t, --delegation-token
token-
要傳遞至 AWS 請求的委派字符。如需詳細資訊,請參閱《IAM 使用者指南》中的臨時安全登入資料。
必要:僅適用您使用暫時安全登入資料時。
預設:
AWS_DELEGATION_TOKEN
環境變數的值 (如已設定)。 --region
region-
於請求簽章內使用的區域。
預設:
us-east-1
必要:若使用簽章第 4 版則為必要
--sigv
version-
簽署請求時使用的簽章版本。
有效值:
2
|4
預設:
4
必要:否
-m, --manifest
path-
指向資訊清單檔案的路徑。
必要:您必須指定
--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
-ayour_access_key_id
-syour_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
描述
從 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 存取金鑰 ID。
必要:是
-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
-syour_secret_access_key
-k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -d mybundleDownloading 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 存取金鑰 ID。
必要:若使用自動映射則為必要。
-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-
用於加密映像資訊清單的 Amazon EC2 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 重新建立 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)。如需詳細資訊,請參閱 建立執行個體儲存體支援的 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 請求的委派字符。如需詳細資訊,請參閱《IAM 使用者指南》中的臨時安全登入資料。
必要:僅適用您使用暫時安全登入資料時。
預設:
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
-syour_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
-
顯示可用於故障排除問題的資訊。