在 Snow Family 裝置上使用 Amazon EC2相容端點 - AWS Snowball Edge 開發人員指南

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

在 Snow Family 裝置上使用 Amazon EC2相容端點

接下來,您可以找到 Amazon EC2相容端點的概觀。使用此端點,您可以使用 Amazon EC2相容API操作,以程式設計方式管理您的 Amazon Machine Images (AMIs) 和運算執行個體。

將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

當您使用 AWS CLI 向 AWS Snowball Edge 裝置發出命令時,您可以指定端點是 Amazon EC2相容端點。您可以選擇使用HTTPS端點或不安全的HTTP端點,如下所示。

HTTPS 安全端點

aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate

HTTP 不安全的端點

aws ec2 describe-instances --endpoint http://192.0.2.0:8008

如果您使用 的HTTPS端點8243,傳輸中的資料會加密。使用 Snowball Edge 在解除鎖定時產生的憑證來確保此加密。有了憑證之後,就可以將其儲存到本機 ca-bundle.pem 檔案。然後,您可以設定 AWS CLI 設定檔,以包含憑證的路徑,如下所述。

將您的憑證與 Amazon EC2相容端點建立關聯
  1. 將 Snowball Edge 連接至電源和網路,然後開啟。

  2. 在裝置完成解鎖後,請記下其在本機網路上的 IP 地址。

  3. 從您網路上的終端機,確定您可以 ping Snowball Edge。

  4. 在您的終端機中執行 snowballEdge get-certificate 命令。如需此命令的詳細資訊,請參閱在 Snow Family 裝置上管理公有金鑰憑證

  5. snowballEdge get-certificate 命令的輸出儲存至檔案,例如 ca-bundle.pem

  6. 從您的終端機中執行下列命令。

    aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem

完成程序後,您可以使用這些本機憑證、憑證和指定的端點來執行CLI命令。

Snow Family 裝置上支援的 Amazon EC2相容 AWS CLI 命令

您可以透過 Amazon EC2相容端點,在 Snow Family 裝置上管理運算執行個體。這種類型的端點支援 的許多 Amazon EC2CLI命令和動作 AWS SDKs。如需有關安裝和設定 的資訊 AWS CLI,包括指定 AWS 區域 您要對哪些 進行 AWS CLI 呼叫,請參閱 AWS Command Line Interface 使用者指南

Snow Family 裝置上支援的 EC2相容 AWS CLI 命令清單

接下來,您可以找到 Snowball Edge 裝置上EC2支援的 Amazon AWS CLI 命令和選項子集的描述。如果某命令或選項未在以下列出,則不受支援。您可以隨著命令宣告某些不受支援的選項。不過,系統會忽略這些部分。

  • associate-address – 將虛擬 IP 地址與執行個體建立關聯,以在裝置上三個實體網路界面的其中一個使用:

    • --instance-id – 單一 sbe 執行個體的 ID。

    • --public-ip – 要用來存取執行個體的虛擬 IP 地址。

  • attach-volume – 將 Amazon EBS磁碟區連接至裝置上的已停止或執行中的執行個體,並使用指定的裝置名稱將其公開至執行個體。

    • --device value – 裝置名稱。

    • --instance-id – 目標 Amazon EC2相容執行個體的 ID。

    • --volume-id value – EBS磁碟區的 ID。

  • authorize-security-group-egress – 將一或多個輸出規則新增至安全群組,以便與 Snowball Edge 裝置搭配使用。具體而言,此動作允許執行個體將流量傳送至一或多個目的地IPv4CIDR地址範圍。如需詳細資訊,請參閱使用 Snow Family 裝置上的安全群組控制網路流量

    • --group-id value – 安全群組的 ID

    • 【--ip-permissions value】 – 一或多個 IP 許可集。

  • authorize-security-group-ingress – 將一或多個傳入規則新增至安全群組。呼叫 authorize-security-group-ingress 時,您必須指定 group-namegroup-id 的值。

    • 【--group-name value】 – 安全群組的名稱。

    • 【--group-id value】 – 安全群組的 ID

    • 【--ip-permissions value】 – 一或多個 IP 許可集。

    • [--protocol value] IP 通訊協定。可能值為 tcpudpicmp。除非已指定 "all protocols" 的值 (-1),否則需要 --port 引數。

    • 【--port value】 – 對於 TCP或 UDP,要允許的連接埠範圍。此值可以是單一整數或範圍 (最小值至最大值)。

      對於 ICMP,單一整數或範圍 (type-code),其中 type代表ICMP類型號碼,而 code代表ICMP代碼。值 -1 表示所有ICMP類型的所有ICMP代碼。值 -1 僅type代表指定ICMP類型的所有ICMP代碼。

    • 【--cidr value】 – CIDR IP 範圍。

  • create-launch-template – 建立啟動範本。啟動範本包含啟動執行個體的參數。當您使用 RunInstances 啟動執行個體時,可以指定啟動範本而無需在請求中提供啟動參數。每個裝置最多可以建立 100 個範本。

    • --launch-template-name string – 啟動範本的名稱。

    • --launch-template-data structure – 啟動範本的資訊。支援以下屬性:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSON 語法:

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • 【--version-description string】 – 啟動範本第一個版本的描述。

    • --endpoint snowballEndpoint – 可讓您使用 Amazon EC2相容API操作以程式設計方式管理運算執行個體的值。如需詳細資訊,請參閱將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

  • create-launch-template-version – 為啟動範本建立新版本。您可以指定現有的啟動範本版本當做新版本的基礎。啟動範本版本會依其建立順序進行編號。您無法指定、變更或替換啟動範本的版本編號。每個啟動範本最多可以建立 100 個版本。

    在請求中指定啟動範本 ID 或啟動範本名稱。

    • --launch-template-id string – 啟動範本的 ID。

    • --launch-template-name string – 啟動範本的名稱。

    • --launch-template-data structure – 啟動範本的資訊。支援以下屬性:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      JSON 語法:

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • 【--source-version string】 – 要作為新版本基礎的啟動範本版本編號。新的版本繼承相同於原始版本的啟動參數,但您在 launch-template-data 中指定的參數除外。

    • 【--version-description string】 – 啟動範本第一個版本的描述。

    • --endpoint snowballEndpoint – 可讓您使用 Amazon EC2相容API操作以程式設計方式管理運算執行個體的值。如需詳細資訊,請參閱將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

  • create-tags – 新增或覆寫指定資源的一或多個標籤。每個資源的上限為 50 個標籤。每個標籤皆包含索引鍵與選用值。資源的標籤索引鍵必須是唯一的。支援以下資源:

    • AMI

    • 執行個體

    • 啟動範本

    • 安全群組

    • 金鑰對

  • create-security-group – 在 Snowball Edge 上建立安全群組。您最多可以建立 50 個安全群組。建立安全群組時,您可以指定您所選易記名稱:

    • --group-name value – 安全群組的名稱。

    • --description value – 安全群組的描述。此資訊僅供參考。此值的長度最多為 255 個字元。

  • create-volume – 建立可連接至您裝置上的執行個體的 Amazon EBS磁碟區。

    • 【--size value】 – 中磁碟區的大小 GiBs,可以是 1 GiB 到 1 TB (1000 GiBs)。

    • 【--snapshot-id value】 – 從中建立磁碟區的快照。

    • 【--volume-type value】 – 磁碟區類型。如未指定任何值,預設為 sbg1。可能的值包括以下:

      • sbg1 適用於磁性磁碟區

      • sbp1 磁碟SSD區

    • 【--tag-specification value】 – 建立期間要套用至磁碟區的標籤清單。

  • delete-launch-template – 刪除啟動範本。刪除啟動範本會刪除它的所有版本。

    在請求中指定啟動範本 ID 或啟動範本名稱。

  • delete-launch-template-version – 刪除啟動範本的一或多個版本。您無法刪除啟動範本的預設版本;您必須先指派不同的版本做為預設值。如果預設版本是啟動範本的唯一版本,則使用 delete-launch-template 命令來刪除整個啟動範本。

    在請求中指定啟動範本 ID 或啟動範本名稱。

    • --launch-template-id string – 啟動範本的 ID。

    • --launch-template-name string – 啟動範本的名稱。

    • --versions (清單) "string" "string" – 要刪除的一或多個啟動範本版本的版本編號。

    • --endpoint snowballEndpoint – 可讓您使用 Amazon EC2相容API操作以程式設計方式管理運算執行個體的值。如需詳細資訊,請參閱將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

  • delete-security-group – 刪除安全群組。

    如果您嘗試刪除的安全群組與執行個體相關聯,或其為另一個安全群組所參考的對象,則該操作會失敗並傳回 DependencyViolation

    • --group-name value – 安全群組的名稱。

    • --description value – 安全群組的描述。此資訊僅供參考。此值的長度最多為 255 個字元。

  • delete-tags – 從指定的資源 (AMI、運算執行個體、啟動範本或安全群組) 中刪除指定的標籤集。

  • delete-volume – 刪除指定的 Amazon EBS磁碟區。磁碟區必須位在 available 狀態 (未連接到執行個體)。

    • --volume-id value – 磁碟區的 ID。

  • describe-addresses – 描述與裝置上的相同sbe執行個體數量相關聯的一個或多個虛擬 IP 地址。

    • --public-ips – 與執行個體相關聯的一或多個虛擬 IP 地址。

  • describe-images – 描述您可用的一或多個影像 (AMIs)。工作建立期間,會將您可用的影像新增至 Snowball Edge 裝置。

    • --image-id – 的 Snowball AMI IDAMI。

  • describe-instance-attribute – 描述指定執行個體的指定屬性。您一次只能指定一個屬性。支援以下屬性:

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances – 描述一或多個執行個體。回應會傳回指派給執行個體的任何安全群組。

    • --instance-ids – 在裝置上停止的一或多個sbe執行個體IDs的 。

    • --page-size – 要在通話中取得的每個頁面大小。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。

    • --max-items – 命令輸出中要傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供 NextToken。若要繼續分頁,請在後續命令的 starting-token 引數中提供 NextToken 值。

    • --starting-token – 指定在何處開始分頁的權杖。此符記是來自先前已截斷回應的 NextToken 值。

  • describe-instance-status – 描述指定執行個體或所有執行個體的狀態。根據預設,只會描述執行中的執行個體,除非您特別指示 傳回所有執行個體的狀態。執行個體狀態包括下列元件:

    • 狀態檢查 – Snow 裝置會在執行 Amazon EC2相容執行個體時執行狀態檢查,以識別硬體和軟體問題。

    • 執行個體狀態 – 您可以從啟動執行個體的那一刻開始管理執行個體,直到其終止為止。

    使用此命令時,支援下列篩選條件。

    • [--filters] (清單)

      篩選條件。

      • instance-state-code – 執行個體狀態的程式碼,作為 16 位元未簽署整數。高位元組用於內部服務報告目的,應予以忽略。低位元組是根據表示的狀態設定。有效值為 0 (待定)、16 (執行中)、32 (倒轉)、48 (已終止)、64 (停止) 和 80 (已停止)。

      • instance-state-name – 執行個體的狀態 (pending | running | shutting-down | terminated | stopping | stopped )。

      • instance-status.reachability – 依名稱為 reachabilitypassed | failed | initializing | ) insufficient-data 的執行個體狀態進行篩選。

      • instance-status.status – 執行個體的狀態 (ok | impaired | initializing | insufficient-data | not-applicable )。

      • system-status.reachability – 依名稱可連線的系統狀態進行篩選 (passed | failed | initializing | insufficient-data )。

      • system-status.status – 執行個體的系統狀態 (ok | impaired | initializing | insufficient-data | not-applicable )。

    • JSON 語法:

      [ { "Name": "string", "Values": ["string", ...] } ... ]
    • [--instance-ids] (清單)

      執行個體 IDs。

      預設:描述您的所有執行個體。

    • [--dry-run|--no-dry-run] (布林值)

      檢查您是否具有動作所需的許可,而不實際提出請求,並提供錯誤回應。如果您有所需的許可,則錯誤回應為 DryRunOperation

      否則為 UnauthorizedOperation

    • [--include-all-instances | --no-include-all-instances] (布林值)

      當 時true, 會包含所有執行個體的運作狀態。當 時false, 只會包含執行中執行個體的運作狀態。

      預設:false

    • [--page-size] (整數) – 要在通話中取得的每個頁面的大小。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。

    • [--max-items] (整數) – 命令輸出中要傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供 NextToken。若要繼續分頁,請在後續命令的 starting-token 引數中提供 NextToken 值。

    • [--starting-token] (字串) – 用於指定從何處開始分頁的權杖。此符記是來自先前已截斷回應的 NextToken 值。

  • describe-launch-templates – 描述一或多個啟動範本。describe-launch-templates 命令是一項分頁操作。您可以進行多個呼叫,以擷取結果的整個資料集。

    在請求中指定啟動範本IDs或啟動範本名稱。

    • --launch-template-ids (清單) "string" "string" – 啟動範本IDs的清單。

    • --launch-template-names (清單) "string" "string" – 啟動範本的名稱清單。

    • --page-size – 要在通話中取得的每個頁面的大小。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。

    • --max-items – 命令輸出中要傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供 NextToken。若要繼續分頁,請在後續命令的 starting-token 引數中提供 NextToken 值。

    • --starting-token – 指定在何處開始分頁的權杖。此符記是來自先前已截斷回應的 NextToken 值。

    • --endpoint snowballEndpoint – 可讓您使用 Amazon EC2相容API操作以程式設計方式管理運算執行個體的值。如需詳細資訊,請參閱將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

  • describe-launch-template-versions – 描述指定啟動範本的一或多個版本。您可以描述所有版本、個別版本或多種版本。describe-launch-template-versions 命令是一項分頁操作。您可以進行多個呼叫,以擷取結果的整個資料集。

    在請求中指定啟動範本IDs或啟動範本名稱。

    • --launch-template-id string – 啟動範本的 ID。

    • --launch-template-name string – 啟動範本的名稱。

    • 【--versions (list) "string" "string"】 – 要刪除的一或多個啟動範本版本的版本編號。

    • 【--min-version string】 – 描述啟動範本版本的版本編號。

    • 【--max-version string】 – 用來描述啟動範本版本的版本編號。

    • --page-size – 要在通話中取得的每個頁面的大小。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。

    • --max-items – 命令輸出中要傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供 NextToken。若要繼續分頁,請在後續命令的 starting-token 引數中提供 NextToken 值。

    • --starting-token – 指定在何處開始分頁的權杖。此符記是來自先前已截斷回應的 NextToken 值。

    • --endpoint snowballEndpoint – 可讓您使用 Amazon EC2相容API操作以程式設計方式管理運算執行個體的值。如需詳細資訊,請參閱將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

  • describe-security-groups – 描述一或多個安全群組。

    describe-security-groups 命令是一項分頁操作。您可以發出多個API呼叫來擷取結果的整個資料集。

    • 【--group-name value】 – 安全群組的名稱。

    • 【--group-id value】 – 安全群組的 ID。

    • 【--page-size value】 – 加入 AWS 服務呼叫的每個頁面的大小。此大小不會影響命令輸出中傳回的項目數。設定較小的頁面大小會導致對 AWS 服務的呼叫次數增加,每次呼叫中擷取的項目減少。此方法有助於防止 AWS 服務呼叫逾時。如需使用範例,請參閱 AWS Command Line Interface 使用者指南 中的分頁

    • 【--max-items value】 – 命令輸出中要傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供 NextToken。若要繼續分頁,請在後續命令的 starting-token 引數中提供 NextToken 值。請勿在 之外直接使用NextToken回應元素 AWS CLI。如需使用範例,請參閱 AWS Command Line Interface 使用者指南 中的分頁

    • 【--starting-token value】 – 指定在何處開始分頁的權杖。此符記是來自先前已截斷回應的 NextToken 值。如需使用範例,請參閱 AWS Command Line Interface 使用者指南 中的分頁

  • describe-tags – 描述指定資源 (imageinstance或 安全群組) 的一或多個標籤。系統會透過此命令,支援以下篩選條件:

    • launch-template

    • resource-id

    • resource-type – imageinstance

    • 金錀

    • value

  • describe-volumes – 描述指定的 Amazon EBS磁碟區。

    • 【--max-items value】 – 命令輸出中要傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供 NextToken。若要繼續分頁,請在後續命令的 starting-token 引數中提供 NextToken 值。

    • 【--starting-token value】 – 指定在何處開始分頁的權杖。此符記是來自先前已截斷回應的 NextToken 值。

    • 【--volume-ids value】 – 一或多個磁碟區 IDs。

  • 分離磁碟區 – 從已停止或執行的執行個體分離 Amazon 磁碟EBS區。

    • 【--device value】 – 裝置名稱。

    • 【--instance-id】 – 目標 Amazon EC2執行個體的 ID。

    • --volume-id value – 磁碟區的 ID。

  • disassociate-address – 將虛擬 IP 地址從相關聯的執行個體取消關聯。

    • --public-ip – 您要與執行個體取消關聯的虛擬 IP 地址。

  • get-launch-template-data – 擷取指定執行個體的組態資料。此資料可用來建立啟動範本。

  • modify-launch-template – 修改啟動範本。您可以指定要將啟動範本的哪些版本設定為預設版本。如果您啟動執行個體但未指定啟動範本版本,系統會套用預設的啟動範本版本。

    在請求中指定啟動範本 ID 或啟動範本名稱。

    • --launch-template-id string – 啟動範本的 ID。

    • --launch-template-name string – 啟動範本的名稱。

    • --default-version string – 要設定為預設版本的啟動範本版本編號。

    • --endpoint snowballEndpoint – 可讓您使用 Amazon EC2相容API操作以程式設計方式管理運算執行個體的值。如需詳細資訊,請參閱將 EC2相容的端點指定為 Snow Family 裝置上的 AWS CLI 端點

  • modify-instance-attribute – 修改指定執行個體的屬性。支援以下屬性:

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress – 從安全群組移除一或多個輸出規則:

    • 【--group-id value】 – 安全群組的 ID

    • 【--ip-permissions value】 – 一或多個 IP 許可集。

  • revoke-security-group-ingress – 撤銷一或多個傳入規則至安全群組。呼叫 revoke-security-group-ingress 時,您必須指定 group-namegroup-id 的值。

    • 【--group-name value】 – 安全群組的名稱。

    • 【--group-id value】 – 安全群組的 ID。

    • 【--ip-permissions value】 – 一或多個 IP 許可集。

    • [--protocol value] IP 通訊協定。可能值為 tcpudpicmp。除非已指定 "all protocols" 的值 (-1),否則需要 --port 引數。

    • 【--port value】 – 對於 TCP或 UDP,要允許的連接埠範圍。單一整數或範圍 (最小值至最大值)。

      對於 ICMP,單一整數或範圍 (type-code),其中 type代表ICMP類型號碼,而 code代表ICMP代碼。值 -1 表示所有ICMP類型的所有ICMP代碼。值 -1 僅type代表指定ICMP類型的所有ICMP代碼。

    • 【--cidr value】 – CIDR IP 範圍。

  • Run-instances – 使用 的 Snowball AMI ID 啟動許多運算執行個體AMI。

    注意

    根據執行個體的大小和類型,在 Snowball Edge 上啟動運算執行個體最多可能需要一小時半的時間。

    • 【--block-device-mappings (list)] – 區塊型裝置映射項目。支援參數 DeleteOnTerminationVolumeSizeVolumeType。開機磁碟區類型必須是 sbg1

      此命令的JSON語法如下所示。

      { "DeviceName": "/dev/sdh", "Ebs": { "DeleteOnTermination": true|false, "VolumeSize": 100, "VolumeType": "sbp1"|"sbg1" } }
    • --count – 要啟動的執行個體數目。如果提供單個數目,會假定為要啟動的最小數目 (預設為 1)。如果以 min:max 的格式提供某個範圍,會將第一個數目視為要啟動的最小執行個體數目,而第二個則視為要啟動的最大執行個體數目。

    • --image-id – 的 Snowball AMI IDAMI,您可以呼叫 取得。 describe-imagesAMI 啟動執行個體需要 。

    • --InstanceInitiatedShutdownBehavior – 依預設,當您從執行個體啟動關機 (使用關機或關機等命令) 時,執行個體會停止。您可以變更這項預設動作,讓執行個體改為終止。支援參數 stopterminate。預設值為 stop。如需詳細資訊,請參閱 Amazon Linux EC2執行個體使用者指南 中的變更執行個體啟動的關閉行為

    • --instance-type – sbe 執行個體類型。

    • --launch-template structure – 用來啟動執行個體的啟動範本。任何您在 run-instances 命令中指定的參數都會覆寫啟動範本中的相同參數。您可以指定啟動範本的名稱或 ID,但不能同時指定兩者。

      { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" }
    • --security-group-ids – 一或多個安全群組 IDs。您可以使用 建立安全群組CreateSecurityGroup。如果未提供任何值,則會對建立的執行個體指派預設安全群組的 ID。

    • --tag-specifications – 在啟動期間套用至資源的標籤。您只能在啟動時對執行個體加上標籤。指定的標籤會套用至所有於啟動期間建立的執行個體。若要在資源建立後為其加上標籤,請使用 create-tags

    • --user-data – 要提供給執行個體的使用者資料。如果您使用的是 AWS CLI,則會為您執行 base64 編碼,而且您可以從檔案載入文字。否則,您必須提供 base64 編碼的文字。

    • --key-name (字串) – 金鑰對的名稱。您可以使用 CreateKeyPair或 建立金鑰對ImportKeyPair

      警告

      如果您未指定金鑰對,除非您選擇設定為允許使用者以其他方式登入的 AMI,否則無法連線至執行個體。

  • start-instances – 啟動您先前已停止的sbe執行個體。連接到該執行個體的所有資源在啟動和停止的整個過程中都會持續存在,但若執行個體已終止,就會予以清除。

    • --instance-ids – 在裝置上停止的一或多個sbe執行個體IDs的 。

  • stop-instances – 停止執行中的sbe執行個體。連接到該執行個體的所有資源在啟動和停止的整個過程中都會持續存在,但若執行個體已終止,就會予以清除。

    • --instance-ids – 在裝置上要停止IDs的一或多個sbe執行個體的 。

  • terminate-instances – 關閉一或多個執行個體。這是等冪操作,如果您多次終止執行個體,每個呼叫都會成功。連接到該執行個體的所有資源在啟動和停止的整個過程中都會持續存在,但若執行個體已終止,就會清除資料。

    注意

    根據預設,使用如 shutdownpoweroff 等命令時,該執行個體會停止。不過,您可以使用 InstanceInitiatedShutdownBehavior 屬性來變更此行為,以便這些命令終止您的執行個體。如需詳細資訊,請參閱 Amazon Linux EC2執行個體使用者指南 中的變更執行個體啟動的關閉行為

    • --instance-ids – 裝置上要終止IDs的一或多個sbe執行個體的 。為這些執行個體存放的所有相關聯資料都將遺失。

  • create-key-pair – 建立具有指定名稱的 2048 位元RSA金鑰對。Amazon 會EC2儲存公有金鑰,並顯示私有金鑰供您儲存至檔案。私有金鑰會傳回為未加密的編碼 PKCS#1 PEM私有金鑰。如果具有指定名稱的金鑰已存在,Amazon 會EC2傳回錯誤。

    • --key-name (字串) – 金鑰對的唯一名稱。

      限制條件:最多 255 ASCII 個字元。

    • 【--tag-specifications】 (list) – 要套用至新金鑰對的標籤。

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ...
  • import-key-pair

    • --key-name (字串) – 金鑰對的唯一名稱。

      限制條件:最多 255 ASCII 個字元。

    • --public-key-material (blob) – 公有金鑰。對於API呼叫,文字必須是 base64 編碼。對於命令列工具,會為您執行 base64 編碼。

    • 【--tag-specifications】 (list) – 要套用至新金鑰對的標籤。

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] }
  • describe-key-pairs

    【--filters】 (清單) – 篩選條件。

    • key-pair-id – 金鑰對的 ID。

    • key-name – 金鑰對的名稱。

    • tag-key – 指派給資源之標籤的索引鍵。使用此篩選條件來尋找指派具有特定金鑰之標籤的所有資源,無論標籤值為何。

    • 【--tag-specifications】 (list) – 要套用至新金鑰對的標籤。

    • tag :key – 指派給資源之標籤的金鑰/值組合。使用篩選條件名稱中的標籤鍵,並將標籤值作為篩選條件值。例如,要尋找標籤帶有鍵 Owner 和值 Team A 的所有資源,將篩選條件名稱指定為 tag:Owner,將篩選條件值指定為 Team A

    { "Name": "string", "Values": ["string", ...] } ...
  • 【--key-names】 (清單) – 金鑰對名稱。

    預設:描述所有金鑰對。

  • 【--key-pair-ids】 (清單) – 金鑰對IDs的 。

  • delete-key-pair

    • 【--key-name】 (字串) – 金鑰對的名稱。

    • 【--key-pair-id】 (字串) – 金鑰對的 ID。

Snow Family 裝置上支援的 Amazon EC2相容API操作

接下來,您可以在 Amazon 參考中找到與 Snowball Edge 搭配使用的 Amazon EC2相容API操作,以及其描述的連結。 EC2 API Amazon EC2相容API呼叫需要簽署 Signature Version 4 (SigV4)。如果您使用 AWS CLI 或 AWS SDK進行這些API呼叫,則會為您處理 SigV4 簽署。否則,您需要實作自己的 SigV4 簽署解決方案。如需詳細資訊,請參閱在 Snow Family 裝置上取得和使用本機 Amazon S3 憑證