在 Snowball Edge 上使用與 Amazon EC2-compatible端點

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

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

• --device value – 裝置名稱。

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

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

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

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

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

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

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

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

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

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

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

• --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-compatible API 操作，以程式設計方式管理運算執行個體的值。如需詳細資訊，請參閱將 EC2-compatible端點指定為 Snowball Edge 上的 AWS CLI 端點。

• --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-compatible API 操作，以程式設計方式管理運算執行個體的值。如需詳細資訊，請參閱將 EC2-compatible端點指定為 Snowball Edge 上的 AWS CLI 端點。

• AMI

• 執行個體

• 啟動範本

• 安全群組

• 金鑰對

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

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

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

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

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

  • sbg1 適用於磁性磁碟區

  • sbp1 適用於 SSD 磁碟區

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

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

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

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

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

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

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

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

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

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

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

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

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

• instanceInitiatedShutdownBehavior

• instanceType

• userData

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

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

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

• --starting-token – 指定開始分頁位置的字符。此符記是來自先前已截斷回應的 NextToken 值。

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

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

• [--filters] （清單）

  篩選條件。

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

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

  • instance-status.reachability – 依名稱為 reachability(passed | 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 值。

• --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-compatible API 操作，以程式設計方式管理運算執行個體的值。如需詳細資訊，請參閱將 EC2-compatible端點指定為 Snowball Edge 上的 AWS CLI 端點。

• --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-compatible API 操作，以程式設計方式管理運算執行個體的值。如需詳細資訊，請參閱將 EC2-compatible端點指定為 Snowball Edge 上的 AWS CLI 端點。

• 【--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 《 使用者指南》中的分頁。

• launch-template

• resource-id

• resource-type – image 或 instance

• 金錀

• value

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

• 【--starting-token value】 – 指定開始分頁位置的字符。此符記是來自先前已截斷回應的 NextToken 值。

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

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

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

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

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

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

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

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

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

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

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

• instanceInitiatedShutdownBehavior

• userData

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

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

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

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

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

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

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

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

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

• 【--block-device-mappings (list)] – 區塊型設備映射項目。支援參數 DeleteOnTermination、VolumeSize 和 VolumeType。開機磁碟區類型必須是 sbg1。

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

  {
     "DeviceName": "/dev/sdh",
     "Ebs": 
     {
        "DeleteOnTermination": true|false,
        "VolumeSize": 100,
        "VolumeType": "sbp1"|"sbg1"
     }
  }                                      

• --count – 要啟動的執行個體數量。如果提供單個數目，會假定為要啟動的最小數目 (預設為 1)。如果以 min:max 的格式提供某個範圍，會將第一個數目視為要啟動的最小執行個體數目，而第二個則視為要啟動的最大執行個體數目。

• --image-id – AMI 的 Snowball AMI ID，您可以透過呼叫 取得describe-images。必須具有 AMI 才可啟動執行個體。

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

• --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，否則無法連線至執行個體。

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

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

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

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

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

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

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

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

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

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

【--filters】 （清單） – 篩選條件。

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

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

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

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

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

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

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

• Device

• InstanceId

• VolumeId

• SnapshotId

• Size

• VolumeType

• TagSpecification.N

• ImageId

• InstanceType

• SecurityGroupIds

• TagSpecifications

• UserData

• AMI

• Instance

• Launch template

• Security group

• VolumeId

• instanceType

• userData

• resource-id

• resource-type – 僅限 AMI 或運算執行個體

• key

• value

• MaxResults

• NextToken

• VolumeId.N

• Device

• InstanceId

• VolumeId