Amazon EC2互換エンドポイントの使用 - AWS Snowcone ユーザーガイド

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon EC2互換エンドポイントの使用

以下は、Amazon Elastic Compute Cloud 互換 (Amazon EC2) エンドポイントの概要です。このエンドポイントを使用すると、Amazon マシンイメージ (AMIs) を管理し、Amazon EC2互換APIオペレーションを使用してプログラムでインスタンスを計算できます。

Amazon EC2互換エンドポイントを AWS CLI エンドポイントとして指定する

を使用して AWS Snowcone デバイスにコマンド AWS CLI を発行する場合、エンドポイントが 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、転送中のデータは暗号化されます。この暗号化は、ロックが解除されるたびに、Snowcone によって生成される証明書を使用して保持されます。証明書を取得したら、ローカルの ca-bundle.pem ファイルに保存できます。次に、以下に示すように AWS CLI プロファイルを設定し、証明書へのパスを含めます。

証明書を Amazon EC2互換エンドポイントに関連付けるには
  1. Snowcone を電源とネットワークに接続し、電源を入れます。

  2. デバイスのロック解除が終了したら、ローカルネットワークでの IP アドレスを書き留めておきます。

  3. ネットワーク上のターミナルから、Snowcone デバイスに ping を送信できることを確認します。

  4. ターミナルで snowballEdge get-certificate コマンドを実行します。このコマンドの詳細については、データ転送の証明書の取得 を参照してください。

  5. snowballEdge get-certificate コマンドの出力をファイルに保存します (例: ca-bundle.pem)。

  6. ターミナルから次のコマンドを実行します。

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

手順が完了したら、これらのローカル認証情報、証明書、および指定されたエンドポイントを使用してCLIコマンドを実行できます。

Snowcone でサポートされていない Amazon EC2 機能

Amazon EC2互換エンドポイントを使用すると、Amazon EC2互換APIオペレーションを使用して Snowcone で インスタンスAMIsと インスタンスをプログラムで管理できます。ただし、Snowcone デバイスで使用できる機能やAPIオペレーションはサポートされていません。

このガイドでサポート対象として明示的にリストされていない機能またはアクションは、サポートされていません。例えば、次の Amazon EC2アクションは Snowcone での使用にはサポートされていません。

Snowcone でサポートされている Amazon EC2互換 AWS CLI コマンド

Amazon EC2互換エンドポイントを使用して、Snow Family デバイスのコンピューティングインスタンスを管理できます。このタイプのエンドポイントは、 の多くの Amazon EC2 CLI コマンドとアクションをサポートしています AWS SDKs。 AWS リージョン AWS CLI の呼び出し先を指定するなど AWS CLI、 のインストールと設定の詳細については、 AWS Command Line Interface ユーザーガイド を参照してください。

Snowcone でサポートされている Amazon EC2互換 AWS CLI コマンドのリスト

以下は、Snowcone デバイスでEC2サポートされている Amazon の AWS CLI コマンドとオプションのサブセットの説明です。コマンドまたはオプションが以下に示されていない場合、そのコマンドまたはオプションはサポートされていません。サポートされていない一部のオプションを、コマンドとともに宣言できます。ただし、それらのオプションは無視されます。

  • associate-address – デバイスの 3 つの物理ネットワークインターフェイスのいずれかで使用するために、仮想 IP アドレスをインスタンスに関連付けます。

    • --instance-id – 単一の sbe インスタンスの ID。

    • --public-ip – インスタンスへのアクセスに使用する仮想 IP アドレス。

  • attach-volume – Amazon EBSボリュームを AWS Snowcone デバイスの停止または実行中のインスタンスにアタッチし、指定したデバイス名でインスタンスに公開します。

    • --device value — デバイス名。

    • --instance-id – ターゲット Amazon EC2インスタンスの ID。

    • --volume-id value – EBSボリュームの ID。

  • authorize-security-group-egress – Snowcone デバイスで使用する 1 つ以上のエグレスルールをセキュリティグループに追加します。具体的には、このアクションにより、インスタンスは 1 つ以上の送信先IPv4CIDRアドレス範囲にトラフィックを送信できます。詳細については、「Snow デバイスのセキュリティグループ」を参照してください。

    • --group-id value — セキュリティグループの ID

    • [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

  • authorize-security-group-ingress – セキュリティグループに 1 つ以上の進入ルールを追加します。authorize-security-group-ingress を呼び出すときは、group-name または group-id のどちらかの値を指定する必要があります。

    • [--group-name value] — セキュリティグループ名。

    • [--group-id value] — セキュリティグループの ID

    • [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

    • [--protocol value] IP プロトコル。指定できる値は tcpudp、および icmp です。「すべてのプロトコル」が指定されている場合を除き、--port 引数は必須です (-1)。

    • [--port value] – TCPまたは の場合UDP、許可するポートの範囲。この値は、1 つの整数または範囲 (最小/最大) です。

      の場合ICMP、単一の整数または範囲 (type-code) はICMP型番号typeを表し、 はICMPコード番号codeを表します。-1 の値は、すべてのICMPタイプのすべてのICMPコードを示します。の のみの値 -1 は、指定されたICMPタイプのすべてのICMPコードtypeを示します。

    • [--cidr value] – CIDR IP 範囲。

  • create-launch-template – 起動テンプレートを作成します。起動テンプレートには、インスタンスを起動するためのパラメータが含まれています。RunInstances を使用してインスタンスを起動するときに、リクエストで起動パラメータを指定する代わりに起動テンプレートを指定できます。 AWS Snowcone デバイスごとに最大 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" } ] } ] }
    • [--version-description string] — 起動テンプレートの最初のバージョンの説明。

    • --endpoint snowballEndpoint – Amazon EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。詳細については、「Amazon EC2互換エンドポイントを 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 EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。詳細については、「Amazon EC2互換エンドポイントを AWS CLI エンドポイントとして指定する」を参照してください。

  • create-tags — 指定したリソースの 1 つ以上のタグを追加または上書きします。各リソースには、最大 50 個のタグを設定できます。各タグはキーとオプションの値で構成されます。タグキーは、リソースごとに一意にする必要があります。以下のリソースがサポートされています。

    • AMI

    • インスタンス

    • 起動テンプレート

    • セキュリティグループ

  • create-security-group – Snowcone デバイスにセキュリティグループを作成します。最大で 50 個のセキュリティグループを作成できます。セキュリティグループを作成するときに、任意のフレンドリ名を指定します。

    • --group-name value — セキュリティグループ名。

    • --description value — セキュリティグループの説明。これは、情報提供のみを目的としています。この値の長さは最大 255 文字とすることができます。

  • create-volume – AWS Snowcone デバイスのインスタンスにアタッチできる 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 または起動テンプレート名を指定します。

    • --launch-template-id string – 起動テンプレートの ID。

    • --launch-template-name string – 起動テンプレートの名前。

    • --endpoint snowballEndpoint – Amazon EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。詳細については、「Amazon EC2互換エンドポイントを AWS CLI エンドポイントとして指定する」を参照してください。

  • delete-launch-template-version – 起動テンプレートの 1 つ以上のバージョンを削除します。起動テンプレートのデフォルトバージョンは削除できません。まずデフォルトとして別のバージョンを割り当てる必要があります。デフォルトバージョンが起動テンプレートの唯一のバージョンである場合は、delete-launch-template コマンドを使用して起動テンプレート全体を削除します。

    リクエストで起動テンプレート ID または起動テンプレート名を指定します。

    • --launch-template-id string – 起動テンプレートの ID。

    • --launch-template-name string – 起動テンプレートの名前。

    • --versions (list) "string" "string" — 削除する 1 つ以上の起動テンプレートバージョンのバージョン番号。

    • --endpoint snowballEndpoint – Amazon EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。

  • 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 インスタンスに関連付けられている 1 つ以上の仮想 IP アドレスを定義します。

    • --public-ips – インスタンスに関連付けられている 1 つ以上の仮想 IP アドレス。

  • describe-images – 利用可能な 1 つ以上のイメージ (AMIs) について説明します。使用可能なイメージは、ジョブの作成時に Snowcone デバイスに追加されます。

    • --image-id – の Snowcone AMI IDAMI。

  • describe-instance-attribute – 指定されたインスタンスの指定された属性を記述します。一度に 1 つの属性のみ指定できます。以下の属性がサポートされています。

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances – 1 つ以上のインスタンスを記述します。レスポンスは、インスタンスに割り当てられているすべてのセキュリティグループを返します。

    • --instance-ids – デバイスで停止された IDs1 つ以上のsbeインスタンス。

    • --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。

    • --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

    • --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

  • describe-launch-templates – 1 つ以上の起動テンプレートについて説明します。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 EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。詳細については、「Amazon EC2互換エンドポイントを AWS CLI エンドポイントとして指定する」を参照してください。

  • describe-launch-template-versions – 指定された起動テンプレートの 1 つ以上のバージョンについて説明します。すべてのバージョン、個々のバージョン、またはバージョンの範囲を定義できます。describe-launch-template-versions コマンドはページ分割されたオペレーションです。複数の呼び出しを行って、結果のデータセット全体を取得できます。

    リクエストで起動テンプレート名IDsまたは起動テンプレート名を指定します。

    • --launch-template-id string – 起動テンプレートの ID。

    • --launch-template-name string – 起動テンプレートの名前。

    • [--versions (list) "string" "string"] — 削除する 1 つ以上の起動テンプレートバージョンのバージョン番号。

    • [--min-version string] — 起動テンプレートバージョンを説明する最小のバージョン番号。

    • [--max-version string] — 起動テンプレートバージョンを説明する最大のバージョン番号。

    • --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。

    • --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

    • --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

    • --endpoint snowballEndpoint – Amazon EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。詳細については、「Amazon EC2互換エンドポイントを AWS CLI エンドポイントとして指定する」を参照してください。

  • describe-security-groups – 1 つ以上のセキュリティグループについて説明します。

    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 値を指定します。 AWS CLIの範囲外で NextToken レスポンス要素を直接使用しないでください。使用例については、AWS Command Line Interface ユーザーガイドページ割りを参照してください。

    • [--starting-token value] — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。使用例については、AWS Command Line Interface ユーザーガイドページ割りを参照してください。

  • describe-tags — 指定したリソース (imageinstance、またはセキュリティグループ) の1 つ以上のタグを説明します。このコマンドでは、次のフィルタがサポートされています。

    • launch-template

    • resource-id

    • resource-type – image または instance

    • キー

    • value

  • describe-volumes – 指定された Amazon EBSボリュームを記述します。

    • [--max-items value] — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

    • [--starting-token value] — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

    • [--volume-ids value] – 1 つ以上のボリューム 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 EC2APIオペレーションを使用してコンピューティングインスタンスをプログラムで管理できる値。詳細については、「Amazon EC2互換エンドポイントを AWS CLI エンドポイントとして指定する」を参照してください。

  • modify-instance-attribute – 指定されたインスタンスの属性を変更します。以下の属性がサポートされています。

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress — セキュリティグループから 1 つ以上のエグレスルールを削除します。

    • [--group-id value] — セキュリティグループの ID

    • [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

  • revoke-security-group-ingress – 1 つ以上のイングレスルールをセキュリティグループに取り消します。revoke-security-group-ingress を呼び出すときは、group-name または group-id のどちらかの値を指定する必要があります。

    • [--group-name value] — セキュリティグループ名。

    • [--group-id value] — セキュリティグループの ID。

    • [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

    • [--protocol value] IP プロトコル。指定できる値は tcpudp、および icmp です。「すべてのプロトコル」が指定されている場合を除き、--port 引数は必須です (-1)。

    • [--port value] – TCPまたは の場合UDP、許可するポートの範囲。単一の整数または範囲 (最小/最大)。

      の場合ICMP、単一の整数または範囲 (type-code) はICMP型番号typeを表し、 はICMPコード番号codeを表します。-1 の値は、すべてのICMPタイプのすべてのICMPコードを示します。の のみの値 -1 は、指定されたICMPタイプのすべてのICMPコードtypeを示します。

    • [--cidr value] – CIDR IP 範囲。

  • run-instances — の Snowcone AMI ID を使用して、多数のコンピューティングインスタンスを起動しますAMI。

    注記

    インスタンスのサイズとタイプに応じて、Snowcone デバイス上でコンピューティングインスタンスを起動する際に、最大で 1 時間半かかることがあります。

    • [--block-device-mappings (list)] – ブロックデバイスマッピングエントリ。パラメータ DeleteOnTerminationVolumeSize、および VolumeType がサポートされています。ブートボリュームのタイプは sbg1 である必要があります。

      このコマンドのJSON構文は次のとおりです。

      { "DeviceName": "/dev/sdh", "Ebs": { "DeleteOnTermination": true|false, "VolumeSize": 100, "VolumeType": "sbp1"|"sbg1" } }
    • --count — 起動するインスタンスの数。単一の数字が指定されている場合は、起動する最小値と見なされます (デフォルトは 1)。min:max の形式で範囲が指定されている場合、最初の数字は起動するインスタンスの最小数と解釈され、2 番目は起動するインスタンスの最大数として解釈されます。

    • --image-id – を呼び出すことで取得AMIできる の Snowcone AMI IDdescribe-images。インスタンスを起動するには、 AMIが必要です。

    • --InstanceInitiatedShutdownBehavior - デフォルトでは、インスタンスからシャットダウンを開始すると (シャットダウンや電源オフなどのコマンドを使用して)、インスタンスは停止します。この動作を変更して、インスタンスの停止ではなく終了させることができます。パラメータ stop および terminate がサポートされています。デフォルト: stop。詳細については、「Linux インスタンス用 Amazon ユーザーガイド」の「インスタンス開始シャットダウン動作の変更」を参照してください。 EC2

    • --instance-type – sbe インスタンスタイプ。

    • --launch-template structure — インスタンスの起動に使用する起動テンプレート。run-instances コマンドで指定したパラメータはすべて、起動テンプレート内の同じパラメータを上書きします。起動テンプレートの名前または ID のいずれかを指定できますが、両方を指定することはできません。

      { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" }
    • --security-group-ids - 1 つ以上のセキュリティグループ IDs。を使用してセキュリティグループを作成できますCreateSecurityGroup。値を指定しない場合、デフォルトのセキュリティグループの ID が作成したインスタンスに割り当てられます。

    • --tag-specifications — 起動中にリソースに適用されるタグ。起動時にのみインスタンスにタグ付けできます。指定されたタグは、起動時に作成されたすべてのインスタンスに適用されます。作成後のリソースにタグを付けるには、create-tags を使用します。

    • --user-data — インスタンスで使用可能なユーザーデータ。を使用している場合 AWS CLI、base64 エンコードが実行され、ファイルからテキストをロードできます。それ以外の場合は、base64 でエンコードされたテキストを指定する必要があります。

  • start-instances – 以前に停止した sbe インスタンスを開始します。インスタンスにアタッチされたすべてのリソースは、開始や停止の間は保持されますが、インスタンスを終了させると消去されます。

    • --instance-ids – デバイスで停止された IDs1 つ以上のsbeインスタンス。

  • stop-instances — 実行中の sbe インスタンスを停止します。インスタンスにアタッチされたすべてのリソースは、開始や停止の間は保持されますが、インスタンスを終了させると消去されます。

    • --instance-ids – デバイス上で停止される 1 つ以上のsbeインスタンスIDsの 。

  • terminate-instances — 1 つ以上のインスタンスをシャットダウンします。このオペレーションはべき等です。インスタンスを複数回終了させると、各コールは成功します。インスタンスにアタッチされたすべてのリソースは、開始や停止の間は保持されますが、インスタンスを終了させるとデータは消去されます。

    注記

    デフォルトでは、shutdownpoweroff などのコマンドを使用してインスタンスからシャットダウンを開始すると、インスタンスは停止します。ただし、InstanceInitiatedShutdownBehavior 属性を使用してこの動作を変更し、これらのコマンドでインスタンスを終了させることができます。詳細については、「Linux インスタンス用 Amazon ユーザーガイド」の「インスタンス開始シャットダウン動作の変更」を参照してください。 EC2

    • --instance-ids – デバイス上で終了する 1 つ以上のsbeインスタンスIDsの 。これらのインスタンスに保存されたすべての関連するデータは失われます。

サポートされている Amazon EC2APIオペレーション

次に、Snowcone デバイスで使用できる Amazon EC2APIオペレーションと、その説明へのリンクを Amazon EC2APIリファレンスで確認できます。 Amazon EC2APIコールでは、署名バージョン 4 (SigV4) の署名が必要です。 AWS CLI または AWS SDK を使用してこれらのAPI呼び出しを行う場合、SigV4 署名が処理されます。それ以外の場合は、お客様独自の SigV4 署名ソリューションを実装する必要があります。

  • AssociateAddress – Elastic IP アドレスをインスタンスまたはネットワークインターフェイスに関連付けます。

  • AttachVolume – 次のリクエストパラメータがサポートされています。

    • Device

    • InstanceId

    • VolumeId

  • AuthorizeSecurityGroupEgress – Snowcone デバイスで使用する 1 つ以上のエグレスルールをセキュリティグループに追加します。具体的には、このアクションにより、インスタンスは 1 つ以上の送信先IPv4CIDRアドレス範囲にトラフィックを送信できます。

  • AuthorizeSecurityGroupIngress – セキュリティグループに 1 つ以上の進入ルールを追加します。を呼び出すときは AuthorizeSecurityGroupIngress、 GroupName または の値を指定する必要がありますGroupId

  • CreateVolume – 次のリクエストパラメータがサポートされています。

    • SnapshotId

    • Size

    • VolumeType

    • TagSpecification.N

  • CreateLaunchTemplate – 次のリクエストパラメータがサポートされています。

    • ImageId

    • InstanceType

    • SecurityGroupIds

    • TagSpecifications

    • UserData

  • CreateLaunchTemplateVersion

  • CreateTags – 次のリクエストパラメータがサポートされています。

    • AMI

    • Instance

    • Launch template

    • Security group

  • CreateSecurityGroup – Snowcone にセキュリティグループを作成します。最大で 50 個のセキュリティグループを作成できます。セキュリティグループを作成するときに、任意のフレンドリ名を指定します。

  • DeleteLaunchTemplate

  • DeleteLaunchTemplateVersions

  • DeleteSecurityGroup — セキュリティグループを削除します。インスタンスに関連付けられている、または他のセキュリティグループによって参照されているセキュリティグループを削除しようとすると、DependencyViolation でそのオペレーションは失敗します。

  • DeleteTags – 指定されたリソースセットから、指定されたタグセットを削除します。

  • DeleteVolume – 次のリクエストパラメータがサポートされています。

    • VolumeId

  • DescribeAddresses

  • DescribeImages

  • DescribeInstanceAttribute – 次の属性がサポートされています。

    • instanceType

    • userData

  • DescribeLaunchTemplates

  • DescribeLaunchTemplateVersions

  • DescribeInstances

  • DescribeSecurityGroups – 1 つ以上のセキュリティグループについて説明します。 DescribeSecurityGroupsはページ分割されたオペレーションです。複数のAPI呼び出しを発行して、結果のデータセット全体を取得できます。

  • DescribeTags – このコマンドでは、次のフィルターがサポートされています。

    • resource-id

    • resource-type – AMIまたはコンピューティングインスタンスのみ

    • key

    • value

  • DescribeVolume – 次のリクエストパラメータがサポートされています。

    • MaxResults

    • NextToken

    • VolumeId.N

  • DetachVolume – 次のリクエストパラメータがサポートされています。

    • Device

    • InstanceId

    • VolumeId

  • DisassociateAddress

  • GetLaunchTemplateData

  • ModifyLaunchTemplate

  • ModifyInstanceAttributeuserData 属性のみがサポートされています。

  • RevokeSecurityGroupEgress — セキュリティグループから 1 つ以上のエグレスルールを削除します。

  • RevokeSecurityGroupIngress – セキュリティグループに 1 つ以上の進入ルールを取り消します。を呼び出すときは RevokeSecurityGroupIngress、 group-name または の値を指定する必要がありますgroup-id

  • RunInstances

    注記

    インスタンスのサイズとタイプに応じて、Snowcone 上でコンピューティングインスタンスを起動するために最大 1 時間半程度かかります。

  • StartInstances

  • StopInstances – 停止したインスタンスに関連付けられたリソースは保持されます。これらのリソースを解放するには、インスタンスを終了させます。ただし、関連付けられているすべてのデータが削除されます。

  • TerminateInstances