本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 Snow 系列裝置上使用與 Amazon EC2 相容的端點
接下來,您可以找到 Amazon EC2 相容端點的概觀。使用此端點,您可以使用與 Amazon EC2 相容的API操作,以程式設計方式管理 Amazon 機器映像 (AMIs) 和運算執行個體。
指定EC2與相容的端點作為 Snow 系列裝置上的 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 相容端點建立關聯
-
將 Snowball 邊緣 Connect 到電源和網絡,然後將其打開。
-
在裝置完成解鎖後,請記下其在本機網路上的 IP 地址。
-
從網路上的終端機,確定您可以偵測到 Snowball Edge。
-
在您的終端機中執行
snowballEdge get-certificate
命令。如需此命令的詳細資訊,請參閱管理 Snow 系列裝置上的公開金鑰憑證。 -
將
snowballEdge get-certificate
命令的輸出儲存至檔案,例如ca-bundle.pem
。 -
從您的終端機中執行下列命令。
aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem
完成程序後,您可以使用這些本機認證、憑證和指定的端點執行CLI命令。
Snow 系列EC2裝置上支援的 Amazon 相容 AWS CLI 命令
您可以透過與 Amazon EC2 相容的端點在 Snow 系列裝置上管理運算執行個體。這種類型的端點支援的許多 Amazon EC2 CLI 命令和動作 AWS SDKs。有關安裝和設置(包括指定 AWS 區域 要對其進行 AWS CLI 呼叫)的更多信息,請參閱《用AWS Command Line Interface 戶指南》。 AWS CLI
EC2Snow 系列裝置上支援的相容 AWS CLI 指令清單
接下來,您可以找到 Snowball Edge 裝置支援的 Amazon AWS CLI EC2 指令子集和選項子集的說明。如果某命令或選項未在以下列出,則不受支援。您可以隨著命令宣告某些不受支援的選項。不過,系統會忽略這些部分。
-
associate-address – 將虛擬 IP 地址與執行個體建立關聯,以在裝置上三個實體網路界面的其中一個使用:
-
--instance-id – 單一
sbe
執行個體的 ID。 -
--public-ip – 要用來存取執行個體的虛擬 IP 地址。
-
-
附加磁碟區 — 將 Amazon 磁EBS碟區附加到裝置上已停止或執行中的執行個體,並使用指定裝置名稱將其公開給執行個體。
-
-設備
value
-設備名稱。 -
-執行個體識別碼 — 目標 Amazon 相容執行個體的 ID。EC2
-
-磁碟區 ID
value
— 磁碟區的識別碼。EBS
-
-
authorize-security-group-egress— 將一或多個輸出規則新增至安全性群組,以便與 Snowball Edge 裝置搭配使用。具體而言,此動作允許執行個體將流量傳送到一或多個目的IPv4CIDR地位址範圍。如需詳細資訊,請參閱 使用 Snow 系列裝置上的安全性群組控制網路流量。
-
-組 ID
value
-安全組的 ID -
[-ip-ip 權限
value
] — 一組或多組 IP 權限。
-
-
authorize-security-group-ingress— 將一或多個輸入規則新增至安全性群組。呼叫
authorize-security-group-ingress
時,您必須指定group-name
或group-id
的值。-
[-群組名稱
value
] — 安全性群組的名稱。 -
[-組 ID
value
]-安全組的 ID -
[-ip-ip 權限
value
] — 一組或多組 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代碼。僅用於 -1 的值type
表示指定ICMP類型的所有ICMP代碼。 -
[--cidr
value
] — IP 範圍。CIDR
-
-
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" }
-
-
[-版本說明
string
] — 啟動範本第一個版本的說明。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 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" }
-
-
[-來源版本
string
] — 新版本所依據的啟動範本版本號碼。新的版本繼承相同於原始版本的啟動參數,但您在launch-template-data
中指定的參數除外。 -
[-版本說明
string
] — 啟動範本第一個版本的說明。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
建立標籤 — 新增或覆寫指定資源的一或多個標籤。每個資源的上限為 50 個標籤。每個標籤皆包含索引鍵與選用值。資源的標籤索引鍵必須是唯一的。支援以下資源:
-
AMI
-
執行個體
-
啟動範本
-
安全群組
-
金鑰對
-
-
create-security-group— 在您的 Snowball 邊緣上創建一個安全組。您最多可以建立 50 個安全群組。建立安全群組時,您可以指定您所選易記名稱:
-
-群組名稱
value
— 安全性群組的名稱。 -
--description
value
— 安全性群組的說明。此資訊僅供參考。此值的長度最多為 255 個字元。
-
-
建立磁碟區 — 建立可連接至裝置上執行個體的 Amazon EBS 磁碟區。
-
[-大小
value
] — 磁碟區的大小 GiBs,可以是從 1 GiB 到 1 TB (1000)。 GiBs -
[-快照-id
value
] — 要從中建立磁碟區的快照。 -
[-磁碟區類型
value
] — 磁碟區類型。如未指定任何值,預設為sbg1
。可能的值包括以下:-
sbg1
適用於磁性磁碟區 -
sbp1
針對SSD磁碟區
-
-
[-標籤規格
value
] — 建立期間套用至磁碟區的標籤清單。
-
-
delete-launch-template— 刪除啟動範本。刪除啟動範本會刪除它的所有版本。
在請求中指定啟動範本 ID 或啟動範本名稱。
-
--launch-template-id
string
-啟動範本的 ID。 -
--launch-template-name
string
-啟動範本的名稱。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
delete-launch-template-version-刪除啟動範本的一或多個版本。您無法刪除啟動範本的預設版本;您必須先指派不同的版本做為預設值。如果預設版本是啟動範本的唯一版本,則使用
delete-launch-template
命令來刪除整個啟動範本。在請求中指定啟動範本 ID 或啟動範本名稱。
-
--launch-template-id
string
-啟動範本的 ID。 -
--launch-template-name
string
-啟動範本的名稱。 -
-versions (清單)
"string" "string"
— 要刪除之一或多個啟動範本版本的版本號碼。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
delete-security-group— 刪除安全性群組。
如果您嘗試刪除的安全群組與執行個體相關聯,或其為另一個安全群組所參考的對象,則該操作會失敗並傳回
DependencyViolation
。-
-群組名稱
value
— 安全性群組的名稱。 -
--description
value
— 安全性群組的說明。此資訊僅供參考。此值的長度最多為 255 個字元。
-
-
刪除標籤 — 從指定的資源 (計算執行個體AMI、啟動範本或安全性群組) 中刪除指定的一組標籤。
-
刪除磁碟區 — 刪除指定的 Amazon EBS 磁碟區。磁碟區必須位在
available
狀態 (未連接到執行個體)。-
-磁碟區 ID
value
— 磁碟區的識別碼。
-
-
描述位址 — 說明與裝置上相同數目的
sbe
執行個體相關聯的一或多個虛擬 IP 位址。-
--public-ips – 與執行個體相關聯的一或多個虛擬 IP 地址。
-
-
描述影像 — 說明一或多個可供您使用的影像 (AMIs)。在建立任務期間,您可以使用的影像會新增至 Snowball Edge 裝置。
-
-圖像 ID — 的 Snowball AMI ID. AMI
-
-
describe-instance-attribute— 說明指定執行個體的指定屬性。您一次只能指定一個屬性。支援以下屬性:
-
instanceInitiatedShutdownBehavior
-
instanceType
-
userData
-
-
describe-instances – 描述一或多個執行個體。回應會傳回指派給執行個體的任何安全群組。
-
--instance ID — 在裝置上停止IDs的一個或多個
sbe
執行個體。 -
-頁面大小-每個頁面的大小進入通話。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。
-
--max-項目 — 要在命令輸出中返回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供
NextToken
。若要繼續分頁,請在後續命令的starting-token
引數中提供NextToken
值。 -
-開始令牌-用於指定從何處開始分頁的令牌。此符記是來自先前已截斷回應的
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
— 過濾器名稱為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
值。
-
describe-launch-templates— 說明一或多個啟動範本。
describe-launch-templates
命令是一項分頁操作。您可以進行多個呼叫,以擷取結果的整個資料集。在請求中指定啟動範本IDs或啟動範本名稱。
-
--launch-template-ids (清單)
"string" "string"
-啟動範本IDs的清單。 -
--launch-template-names (清單)
"string" "string"
-啟動範本的名稱清單。 -
-頁面大小-每個頁面的大小進入通話。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。
-
--max-項目 — 要在命令輸出中返回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供
NextToken
。若要繼續分頁,請在後續命令的starting-token
引數中提供NextToken
值。 -
-開始令牌-用於指定從何處開始分頁的令牌。此符記是來自先前已截斷回應的
NextToken
值。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
describe-launch-template-versions— 說明指定啟動範本的一或多個版本。您可以描述所有版本、個別版本或多種版本。
describe-launch-template-versions
命令是一項分頁操作。您可以進行多個呼叫,以擷取結果的整個資料集。在請求中指定啟動範本IDs或啟動範本名稱。
-
--launch-template-id
string
-啟動範本的 ID。 -
--launch-template-name
string
-啟動範本的名稱。 -
[-versions (清單)
"string" "string"
] — 要刪除之一或多個啟動範本版本的版本號碼。 -
[-最小版本
string
] — 版本號碼,之後用來描述啟動範本版本。 -
[-最大版本
string
] — 用來描述啟動範本版本的版本號碼。 -
-頁面大小-每個頁面的大小進入通話。此值不會影響命令輸出中傳回的項目數。設定的頁面大小愈小,對裝置發出的呼叫就愈多,在每個呼叫中擷取的項目也愈少。這有助避免呼叫逾時。
-
--max-項目 — 要在命令輸出中返回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供
NextToken
。若要繼續分頁,請在後續命令的starting-token
引數中提供NextToken
值。 -
-開始令牌-用於指定從何處開始分頁的令牌。此符記是來自先前已截斷回應的
NextToken
值。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
describe-security-groups— 說明一或多個安全性群組。
describe-security-groups
命令是一項分頁操作。您可以發出多個API呼叫以擷取整個結果資料集。-
[-群組名稱
value
] — 安全性群組的名稱。 -
[-群組識別碼
value
] — 安全性群組的識別碼。 -
[-頁面大小
value
] — 要在服務呼叫中取得的每個頁面的大小。 AWS 此大小不會影響命令輸出中傳回的項目數。設定較小的頁面大小會導致對 AWS 服務的呼叫次數越多,在每次呼叫中擷取的項目較少。此方法有助於防止 AWS 服務呼叫逾時。如需使用範例,請參閱使AWS Command Line Interface 用指南中的「分頁」。 -
[--max-項目
value
] — 要在命令輸出中傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供NextToken
。若要繼續分頁,請在後續命令的starting-token
引數中提供NextToken
值。請勿使NextToken
用直接在 AWS CLI. 如需使用範例,請參閱使AWS Command Line Interface 用指南中的「分頁」。 -
[-開始令牌
value
] — 用於指定從何處開始分頁的令牌。此符記是來自先前已截斷回應的NextToken
值。如需使用範例,請參閱使AWS Command Line Interface 用指南中的「分頁」。
-
-
描述-tags — 說明指定資源 (
image
、instance
或安全群組) 的一或多個標籤。系統會透過此命令,支援以下篩選條件:-
launch-template
-
resource-id
-
resource-type –
image
或instance
-
金錀
-
value
-
-
說明磁碟區 — 描述指定的 Amazon 磁碟區。EBS
-
[--max-項目
value
] — 要在命令輸出中傳回的項目總數。如果可用的總項目數超過指定的值,會在命令的輸出中提供NextToken
。若要繼續分頁,請在後續命令的starting-token
引數中提供NextToken
值。 -
[-開始令牌
value
] — 用於指定從何處開始分頁的令牌。此符記是來自先前已截斷回應的NextToken
值。 -
[-體積-IDS
value
] — 一個或多個磁碟區。IDs
-
-
卸離磁碟區 — 從停止或執行中的執行個體卸離 Amazon EBS 磁碟區。
-
[-設備
value
] — 設備名稱。 -
[-執行個體 ID] — 目標 Amazon 執行個體的識別碼。EC2
-
-磁碟區 ID
value
— 磁碟區的識別碼。
-
-
disassociate-address – 將虛擬 IP 地址從相關聯的執行個體取消關聯。
-
-public-ip — 您想要取消與執行個體關聯的虛擬 IP 位址。
-
-
get-launch-template-data— 擷取指定執行個體的組態資料。此資料可用來建立啟動範本。
-
--instance-id – 單一
sbe
執行個體的 ID。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
modify-launch-template-修改啟動範本。您可以指定要將啟動範本的哪些版本設定為預設版本。如果您啟動執行個體但未指定啟動範本版本,系統會套用預設的啟動範本版本。
在請求中指定啟動範本 ID 或啟動範本名稱。
-
--launch-template-id
string
-啟動範本的 ID。 -
--launch-template-name
string
-啟動範本的名稱。 -
-預設版本
string
— 要設定為預設版本的啟動範本的版本號碼。 -
-端點
snowballEndpoint
— 可讓您使用 Amazon EC2 相容操作,以程式設計方式管理運算執行個體的值。API如需詳細資訊,請參閱 指定EC2與相容的端點作為 Snow 系列裝置上的 AWS CLI 端點。
-
-
modify-instance-attribute— 修改指定執行個體的屬性。支援以下屬性:
-
instanceInitiatedShutdownBehavior
-
userData
-
-
revoke-security-group-egress— 從安全性群組移除一或多個輸出規則:
-
[-組 ID
value
]-安全組的 ID -
[-ip-ip 權限
value
] — 一組或多組 IP 權限。
-
-
revoke-security-group-ingress— 撤銷安全性群組的一或多個輸入規則。呼叫
revoke-security-group-ingress
時,您必須指定group-name
或group-id
的值。-
[-群組名稱
value
] — 安全性群組的名稱。 -
[-群組識別碼
value
] — 安全性群組的識別碼。 -
[-ip-ip 權限
value
] — 一組或多組 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代碼。僅用於 -1 的值type
表示指定ICMP類型的所有ICMP代碼。 -
[--cidr
value
] — IP 範圍。CIDR
-
-
執行執行個體 — 使用 Snowball AMI ID 來啟動數個運算執行個體。AMI
注意
視執行個體的大小和類型而定,在 Snowball Edge 上啟動運算執行個體最多可能需要一個半小時的時間。
-
[--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
的格式提供某個範圍,會將第一個數目視為要啟動的最小執行個體數目,而第二個則視為要啟動的最大執行個體數目。 -
-圖像 ID — 的 Snowball AMI IDAMI, 你可以通過調用獲得.
describe-images
啟動執行個AMI體需要有一個。 -
--InstanceInitiatedShutdownBehavior — 依預設,當您從執行個體啟動關機時 (使用關機或電源關閉等指令),執行個體就會停止。您可以變更這項預設動作,讓執行個體改為終止。支援參數
stop
和terminate
。預設值為stop
。如需詳細資訊,請參閱 Amazon Linux 執行個體EC2使用者指南中的變更執行個體啟動的關機行為。 -
--instance-type –
sbe
執行個體類型。 -
-啟動範本
structure
— 用來啟動執行個體的啟動範本。任何您在run-instances
命令中指定的參數都會覆寫啟動範本中的相同參數。您可以指定啟動範本的名稱或 ID,但不能同時指定兩者。{ "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" }
-
--security-group-ids -一個或多個安全組IDs。您可以使用建立安全性群組CreateSecurityGroup。如果未提供任何值,則會對建立的執行個體指派預設安全群組的 ID。
-
-標籤規格 — 啟動期間套用至資源的標籤。您只能在啟動時對執行個體加上標籤。指定的標籤會套用至所有於啟動期間建立的執行個體。若要在資源建立後為其加上標籤,請使用
create-tags
。 -
-使用者資料 — 要提供給執行個體使用的使用者資料。如果您使用的是 AWS CLI,則會為您執行 base64 編碼,並且您可以從檔案載入文字。否則,您必須提供 base64 編碼的文字。
-
-金鑰名稱 (字串) — key pair 的名稱。您可以使用
CreateKeyPair
或建立 key pairImportKeyPair
。警告
如果您未指定 key pair,則無法連線至執行個體,除非您選擇設AMI定為允許使用者以其他方式登入的方式。
-
-
啟動執行個體 — 啟動先前已
sbe
停止的執行個體。連接到該執行個體的所有資源在啟動和停止的整個過程中都會持續存在,但若執行個體已終止,就會予以清除。-
--instance ID — 在裝置上停止IDs的一個或多個
sbe
執行個體。
-
-
停止執行個體 — 停止正在執行的
sbe
執行個體。連接到該執行個體的所有資源在啟動和停止的整個過程中都會持續存在,但若執行個體已終止,就會予以清除。-
--Instance ID — 要在裝置上停止IDs的一個或多個
sbe
執行個體。
-
-
終止執行個體 — 關閉一或多個執行個體。這是等冪操作,如果您多次終止執行個體,每個呼叫都會成功。連接到該執行個體的所有資源在啟動和停止的整個過程中都會持續存在,但若執行個體已終止,就會清除資料。
注意
根據預設,使用如
shutdown
或poweroff
等命令時,該執行個體會停止。不過,您可以使用InstanceInitiatedShutdownBehavior
屬性來變更此行為,讓這些命令終止您的執行個體。如需詳細資訊,請參閱 Amazon Linux 執行個體EC2使用者指南中的變更執行個體啟動的關機行為。-
---instance ID — 要在裝置上終止IDs的一個或多個執行個體的
sbe
執行個體。為這些執行個體存放的所有相關聯資料都將遺失。
-
-
create-key-pair— 建立具有指定名稱的 2048 位元 RSA key pair。Amazon 會EC2存放公開金鑰,並顯示私密金鑰供您儲存至檔案。私密金鑰會傳回為未加密的 PKCS #1 私PEM密金鑰。如果具有指定名稱的密鑰已經存在,Amazon EC2 返回一個錯誤。
-
-金鑰名稱 (字串) — key pair 的唯一名稱。
限制條件:最多 255 個ASCII字元。
-
[-標籤規格] (清單) — 要套用至新 key pair 的標籤。
{ "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ...
-
-
-
-金鑰名稱 (字串) — key pair 的唯一名稱。
限制條件:最多 255 個ASCII字元。
-
--public-key-material (斑點)-公共密鑰。對於API通話,文本必須以 base64 編碼。對於命令行工具,系統會為您執行 base64 編碼。
-
[-標籤規格] (清單) — 要套用至新 key pair 的標籤。
{ "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] }
-
-
[-過濾器](列表)-過濾器。
-
key-pair-id — key pair 的識別碼。
-
金鑰名稱 — key pair 的名稱。
-
標籤鍵 — 指定給資源的標籤鍵。使用此篩選器可尋找指派具有特定索引鍵之標籤的所有資源,而不論標籤值為何。
-
[-標籤規格] (清單) — 要套用至新 key pair 的標籤。
-
tag: key — 分配給資源的標籤的鍵/值組合。使用篩選條件名稱中的標籤鍵,並將標籤值作為篩選條件值。例如,要尋找標籤帶有鍵
Owner
和值Team A
的所有資源,將篩選條件名稱指定為tag:Owner
,將篩選條件值指定為Team A
。
{ "Name": "string", "Values": ["string", ...] } ...
-
-
[-鍵名] (清單) — key pair 名稱。
預設值:說明您所有的金鑰配對。
-
[--key-pair-ids] (清單) — 金鑰配對IDs的。
-
-
[-金鑰名稱] (字串) — key pair 的名稱。
-
[--key-pair-id] (字串) — key pair 的識別碼。
-
Snow 系列EC2裝置上支援的 Amazon 相容API操作
接下來,您可以找到可與 Snowball Edge 搭配使用的 Amazon EC2 相容API操作,並在 Amazon EC2 API 參考中提供其說明的連結。與 Amazon EC2 相容的API呼叫需要簽名版本 4 (SIGv4) 簽署。如果您使用 AWS CLI 或 AWS SDK來進行這些API呼叫,則會為您處理 Sigv4 簽署。否則,您需要實作自己的 SigV4 簽署解決方案。如需詳細資訊,請參閱 在雪家族設備上獲取和使用本地 Amazon S3 登入資料。
-
AssociateAddress— 將彈性 IP 位址與執行個體或網路介面建立關聯。
-
AttachVolume— 支援下列要求參數:
-
Device
-
InstanceId
-
VolumeId
-
-
AuthorizeSecurityGroupEgress— 將一或多個輸出規則新增至安全性群組,以便與 Snowball Edge 裝置搭配使用。具體而言,此動作允許執行個體將流量傳送到一或多個目的IPv4CIDR地位址範圍。
-
AuthorizeSecurityGroupIngress— 將一或多個輸入規則新增至安全性群組。呼叫時 AuthorizeSecurityGroupIngress,您必須為
GroupName
或指定值GroupId
。 -
CreateVolume— 支援下列要求參數:
-
SnapshotId
-
Size
-
VolumeType
-
TagSpecification.N
-
-
CreateLaunchTemplate— 支援下列要求參數:
-
ImageId
-
InstanceType
-
SecurityGroupIds
-
TagSpecifications
-
UserData
-
-
CreateTags— 支援下列要求參數:
-
AMI
-
Instance
-
Launch template
-
Security group
-
-
CreateSecurityGroup— 在您的 Snowball 邊緣上創建一個安全組。您最多可以建立 50 個安全群組。建立安全群組時,您可以指定您所選易記名稱。
-
DeleteSecurityGroup— 刪除安全性群組。如果您嘗試刪除的安全群組與執行個體相關聯,或其為另一個安全群組所參考的對象,則該操作會失敗並傳回
DependencyViolation
。 -
DeleteTags— 從指定的資源集中刪除指定的標籤集。
-
DeleteVolume— 支援下列要求參數:
-
VolumeId
-
-
DescribeInstanceAttribute— 支援下列屬性:
-
instanceType
-
userData
-
-
DescribeSecurityGroups— 說明一或多個安全性群組。
DescribeSecurityGroups
是一個分頁操作。您可以發出多個API呼叫以擷取整個結果資料集。 -
DescribeTags— 使用此指令,支援下列篩選器:
-
resource-id
-
resource-type
— AMI 或僅限運算執行個體 -
key
-
value
-
-
DescribeVolume— 支援下列要求參數:
-
MaxResults
-
NextToken
-
VolumeId.N
-
-
DetachVolume— 支援下列要求參數:
-
Device
-
InstanceId
-
VolumeId
-
-
ModifyInstanceAttribute— 僅支援
userData
屬性。 -
RevokeSecurityGroupEgress— 從安全性群組移除一或多個輸出規則。
-
RevokeSecurityGroupIngress— 撤銷安全性群組的一或多個輸入規則。呼叫時 RevokeSecurityGroupIngress,您必須為
group-name
或指定值group-id
。 -
注意
視執行個體的大小和類型而定,在 Snowball Edge 上啟動運算執行個體最多可能需要一個半小時的時間。
-
StopInstances— 與已停止執行個體相關聯的資源會保留。您可以終止執行個體來釋放這些資源。不過,任何相關資料會遭到刪除。