翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Snowball Edge での Amazon EC2-compatibleエンドポイントの使用 以下は、Amazon EC2 互換エンドポイントの概要です。このエンドポイントでは、Amazon EC2 互換 API オペレーションを使用して、Amazon マシンイメージ (AMI) とコンピューティングインスタンスをプログラムで管理できます。 ## Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する を使用して AWS Snowball Edge デバイスにコマンド AWS CLI を発行する場合、エンドポイントが Amazon EC2-compatibleエンドポイントであることを指定できます。次に示すように、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 ``` `8243` の HTTPS エンドポイントを使用すると、転送中のデータは暗号化されます。この暗号化は、ロックの解除時に Snowball Edge によって生成される証明書を使用して行われます。証明書を取得したら、ローカルの `ca-bundle.pem` ファイルに保存できます。次に、以下に示すように AWS CLI プロファイルを設定し、証明書へのパスを含めます。 **証明書を Amazon EC2 互換エンドポイントに関連付けるには** 1. Snowball Edge を電源とネットワークに接続し、電源を入れます。 1. デバイスのロック解除が終了したら、ローカルネットワークでの IP アドレスを書き留めておきます。 1. ネットワーク上のターミナルから Snowball Edge に ping を送信できることを確認します。 1. ターミナルで `snowballEdge get-certificate` コマンドを実行します。このコマンドの詳細については、「[Snowball Edge でのパブリックキー証明書の管理](snowball-edge-certificates-cli.md)」を参照してください。 1. `snowballEdge get-certificate` コマンドの出力をファイルに保存します (例: `ca-bundle.pem`)。 1. ターミナルから次のコマンドを実行します。 ``` aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem ``` この手順を完了したら、これらのローカル認証情報、証明書、および指定されたエンドポイントを使用して CLI コマンドを実行できます。 ## Snowball Edge でサポートされている Amazon EC2-compatible AWS CLI コマンド Snowball Edge デバイスのコンピューティングインスタンスは、Amazon EC2-compatibleエンドポイントを介して管理できます。このタイプのエンドポイントは、 AWS SDKs の多くの Amazon EC2 CLI コマンドとアクションをサポートしています。 AWS リージョン AWS CLI の呼び出し先を指定するなど AWS CLI、 のインストールと設定については、 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)を参照してください。 ### Snowball Edge でサポートされている EC2-compatible AWS CLI コマンドのリスト 以下は、Snowball Edge デバイスでサポートされている Amazon EC2 の AWS CLI コマンドとオプションのサブセットの説明です。コマンドまたはオプションが以下に示されていない場合、そのコマンドまたはオプションはサポートされていません。サポートされていない一部のオプションを、コマンドとともに宣言できます。ただし、それらのオプションは無視されます。 + [associate-address](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-address.html) – デバイスの 3 つの物理ネットワークインターフェイスのいずれかで使用するために、仮想 IP アドレスをインスタンスに関連付けます。 + --instance-id – 単一の `sbe` インスタンスの ID。 + --public-ip – インスタンスへのアクセスに使用する仮想 IP アドレス。 + [attach-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/attach-volume.html) – デバイスで停止したか実行中のインスタンスに Amazon EBS ボリュームをアタッチし、指定したデバイス名でインスタンスに公開します。 + --device `value` — デバイス名。 + --instance-id – ターゲットの Amazon EC2 互換インスタンスの ID。 + -volume-id `value` — EBS ボリュームの ID。 + [authorize-security-group-egress](https://docs.aws.amazon.com/cli/latest/reference/ec2/authorize-security-group-egress.html) — Snowball Edge デバイスで使用するために、1 つ以上の Egress ルールをセキュリティグループに追加します。具体的には、このアクションでは、1 つ以上の IPv4 CIDR アドレス範囲にインスタンスがトラフィックを送信できます。詳細については、「[Snowball Edge のセキュリティグループによるネットワークトラフィックの制御](edge-security-groups.md)」を参照してください。 + --group-id `value` — セキュリティグループの ID + [--ip-permissions `value`] — IP アクセス許可の 1 つ以上のセット。 + [authorize-security-group-ingress](https://docs.aws.amazon.com/cli/latest/reference/ec2/authorize-security-group-ingress.html) — 1 つ以上の Ingress ルールをセキュリティグループに追加します。`authorize-security-group-ingress` を呼び出すときは、`group-name` または `group-id` のどちらかの値を指定する必要があります。 + [--group-name `value`] — セキュリティグループ名。 + [--group-id `value`] — セキュリティグループの ID + [--ip-permissions `value`] — IP アクセス許可の 1 つ以上のセット。 + [--protocol `value`] IP プロトコル。指定できる値は `tcp`、`udp`、および `icmp` です。「すべてのプロトコル」が指定されている場合を除き、`--port` 引数は必須です (-1)。 + [--port `value`] — TCP または UDP 用に許可するポートの範囲。この値は、1 つの整数または範囲 (最小/最大) です。 ICMP の場合、1 つの整数または範囲 (`type`-`code`) です。この場合、`type` は ICMP タイプ番号を表し、`code` は ICMP コード番号を表します。-1 の値は、すべての ICMP タイプのすべての ICMP コードを示します。`type` だけの -1 の値は、特定の ICMP タイプのすべての ICMP コードを示します。 + [--cidr `value`] — CIDR IP の範囲。 + [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html) — 起動テンプレートを作成します。*起動テンプレート*には、インスタンスを起動するためのパラメータが含まれています。`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 オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [create-launch-template-version](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template-version.html) — 起動テンプレートの新しいバージョンを作成します。新しいバージョンの基になる起動テンプレートの既存のバージョンを指定できます。起動テンプレートのバージョンには、作成された順序で番号が付けられます。起動テンプレートのバージョン番号を指定、変更、または置き換えることはできません。起動テンプレートごとに最大 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 オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html) — 指定したリソースの 1 つ以上のタグを追加または上書きします。各リソースには、最大 50 個のタグを設定できます。各タグはキーとオプションの値で構成されます。タグキーは、リソースごとに一意にする必要があります。以下のリソースがサポートされています。 + AMI + インスタンス + 起動テンプレート + セキュリティグループ + キーペア + [create-security-group](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-security-group.html) — Snowball Edge にセキュリティグループを作成します。最大で 50 個のセキュリティグループを作成できます。セキュリティグループを作成するときに、任意のフレンドリ名を指定します。 + --group-name `value` — セキュリティグループ名。 + --description `value` — セキュリティグループの説明。これは、情報提供のみを目的としています。この値の長さは最大 255 文字とすることができます。 + [create-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-volume.html) — デバイスのインスタンスにアタッチできる Amazon EBS ボリュームを作成します。 + [--size `value`] — GiB 単位のボリュームのサイズで、1 GiB～1 TB (1000 GiB) とすることができます。 + [--snapshot-id `value`] — ボリュームの作成元となるスナップショット。 + [--volume-type `value`] — ボリュームのタイプ。値が指定されていない場合、デフォルト値は `sbg1` です。以下に示しているのは、可能な値です。 + マグネティックボリュームの `sbg1` + SSD ボリュームの `sbp1` + [--tag-specification `value`] — 作成中にボリュームに適用するタグのリスト。 + [delete-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-launch-template.html) — 起動テンプレートを削除します。起動テンプレートを削除すると、すべてのバージョンが削除されます。 リクエストで起動テンプレート ID または起動テンプレート名を指定します。 + --launch-template-id `string` — 起動テンプレートの ID。 + --launch-template-name `string` — 起動テンプレート名。 + --endpoint `snowballEndpoint` – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [delete-launch-template-version](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-launch-template-version.html) — 起動テンプレートの 1 つ以上のバージョンを削除します。起動テンプレートのデフォルトバージョンは削除できません。まずデフォルトとして別のバージョンを割り当てる必要があります。デフォルトバージョンが起動テンプレートの唯一のバージョンである場合は、`delete-launch-template` コマンドを使用して起動テンプレート全体を削除します。 リクエストで起動テンプレート ID または起動テンプレート名を指定します。 + --launch-template-id `string` — 起動テンプレートの ID。 + --launch-template-name `string` — 起動テンプレート名。 + --versions (list) `"string" "string"` — 削除する 1 つ以上の起動テンプレートバージョンのバージョン番号。 + --endpoint `snowballEndpoint` – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [delete-security-group](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-security-group.html) — セキュリティグループを削除します。 インスタンスに関連付けられている、または他のセキュリティグループによって参照されているセキュリティグループを削除しようとすると、`DependencyViolation` でそのオペレーションは失敗します。 + --group-name `value` — セキュリティグループ名。 + --description `value` — セキュリティグループの説明。これは、情報提供のみを目的としています。この値の長さは最大 255 文字とすることができます。 + [delete-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-tags.html) — 指定したリソース (AMI、コンピューティングインスタンス、起動テンプレート、セキュリティグループ) から、指定したタグのセットを削除します。 + [delete-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-volume.html) — 指定した Amazon EBS ボリュームを削除します。ボリュームは `available` 状態である必要があります (インスタンスにアタッチされていません)。 + --volume-id `value` — ボリュームの ID。 + [describe-addresses](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-addresses.html) — デバイスで同じ数の `sbe` インスタンスに関連付けられている 1 つ以上の仮想 IP アドレスを定義します。 + --public-ips – インスタンスに関連付けられている 1 つ以上の仮想 IP アドレス。 + [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) — 使用可能な 1 つ以上のイメージ (AMI) について説明します。使用可能なイメージは、ジョブの作成時に Snowball Edge デバイスに追加されます。 + --image-id — AMI の Snowball AMI ID。 + [describe-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-attribute.html) — 指定したインスタンスの指定した属性について説明します。一度に 1 つの属性のみ指定できます。以下の属性がサポートされています。 + `instanceInitiatedShutdownBehavior` + `instanceType` + `userData` + [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) – 1 つ以上のインスタンスを記述します。レスポンスは、インスタンスに割り当てられているすべてのセキュリティグループを返します。 + --instance-ids – デバイスで停止した 1 つ以上の `sbe` インスタンスの ID。 + --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。 + --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で `NextToken` が提供されます。ページ分割を再開するには、後続コマンドの `starting-token` 引数で `NextToken` 値を指定します。 + --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの `NextToken` 値です。 + [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html) – 指定したインスタンスまたはすべてのインスタンスのステータスを説明します。デフォルトでは、すべてのインスタンスのステータスを返すよう特に指定しない限り、実行中のインスタンスのみが説明されます。インスタンスステータスには、以下の要素が含まれます。 + **ステータスチェック** – Snow デバイスは、実行中の Amazon EC2 互換インスタンスのステータスチェックを実行して、ハードウェアおよびソフトウェアの問題を特定します。 + **インスタンスの状態** – インスタンスを起動した瞬間から終了時までインスタンスを管理できます。 このコマンドでは、次のフィルタがサポートされます。 + `[--filters]` (リスト) フィルター。 + `instance-state-code` – 16 ビットの符号なし整数としてのインスタンスの状態のコード。上位バイトは内部サービスレポート目的で使用されるため、無視します。下位バイトは表示されている状態に基づいて設定されます。有効な値は 0 (保留中)、16 (実行中)、32 (シャットダウン中)、48 (終了)、64 (停止中)、80 (停止) です。 + `instance-state-name` – インスタンスの状態 (`pending` \$1 `running` \$1 `shutting-down` \$1 `terminated` \$1 `stopping` \$1 `stopped` )。 + `instance-status.reachability` – 名前が `reachability` (`passed` \$1 `failed` \$1 `initializing` \$1 `insufficient-data` ) のインスタンスステータスに基づいてフィルタリングします。 + `instance-status.status` – インスタンスのステータス (`ok` \$1 `impaired` \$1 `initializing` \$1 `insufficient-data` \$1 `not-applicable` )。 + `system-status.reachability` – 名前が reachability (`passed` \$1 `failed` \$1 `initializing` \$1 `insufficient-data` ) のシステムステータスに基づいてフィルタリングします。 + `system-status.status` – インスタンスのシステムステータス (`ok` \$1 `impaired` \$1 `initializing` \$1 `insufficient-data` \$1 `not-applicable` )。 + JSON 構文: ``` [ { "Name": "string", "Values": ["string", ...] } ... ] ``` + `[--instance-ids]` (リスト) インスタンス ID。 デフォルト: すべてのインスタンスについて説明します。 + `[--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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-templates.html) — 1 つ以上の起動テンプレートを定義します。`describe-launch-templates` コマンドはページ分割されたオペレーションです。複数の呼び出しを行って、結果のデータセット全体を取得できます。 リクエストで起動テンプレート ID または起動テンプレート名を指定します。 + --launch-template-ids (list) `"string" "string"` — 起動テンプレートの ID のリスト。 + --launch-template-names (list) `"string" "string"` — 起動テンプレート名のリスト。 + --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。 + --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で `NextToken` が提供されます。ページ分割を再開するには、後続コマンドの `starting-token` 引数で `NextToken` 値を指定します。 + --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの `NextToken` 値です。 + --endpoint `snowballEndpoint` – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [describe-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html) — 指定した起動テンプレートの 1 つ以上のバージョンを定義します。すべてのバージョン、個々のバージョン、またはバージョンの範囲を定義できます。`describe-launch-template-versions` コマンドはページ分割されたオペレーションです。複数の呼び出しを行って、結果のデータセット全体を取得できます。 リクエストで起動テンプレート ID または起動テンプレート名を指定します。 + --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 EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [describe-security-groups](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-security-groups.html) — 1 つ以上のセキュリティグループを説明します。 `describe-security-groups` コマンドはページ分割されたオペレーションです。複数の API コールを発行して、結果のデータセット全体を取得できます。 + [--group-name `value`] — セキュリティグループ名。 + [--group-id `value`] — セキュリティグループの ID。 + [--page-size `value`] – AWS サービスコールで取得する各ページのサイズ。このサイズは、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、 AWS サービスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。このアプローチは、 AWS サービス呼び出しがタイムアウトするのを防ぐのに役立ちます。使用例については、*AWS Command Line Interface ユーザーガイド*の[ページ割り](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)を参照してください。 + [--max-items `value`] — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で `NextToken` が提供されます。ページ分割を再開するには、後続コマンドの `starting-token` 引数で `NextToken` 値を指定します。 AWS CLIの範囲外で `NextToken` レスポンス要素を直接使用しないでください。使用例については、*AWS Command Line Interface ユーザーガイド*の[ページ割り](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)を参照してください。 + [--starting-token `value`] — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの `NextToken` 値です。使用例については、*AWS Command Line Interface ユーザーガイド*の[ページ割り](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html)を参照してください。 + [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html) — 指定したリソース (`image`、`instance`、またはセキュリティグループ) の1 つ以上のタグを説明します。このコマンドでは、次のフィルタがサポートされています。 + launch-template + resource-id + resource-type – `image` または `instance` + キー + value + [describe-volumes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-volumes.html) — 指定した Amazon EBS ボリュームについて説明します。 + [--max-items `value`] — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で `NextToken` が提供されます。ページ分割を再開するには、後続コマンドの `starting-token` 引数で `NextToken` 値を指定します。 + [--starting-token `value`] — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの `NextToken` 値です。 + [--volume-ids `value`] — 1 つ以上のボリュームの ID。 + [detach-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/detach-volume.html) — 停止したか、実行中のインスタンスから Amazon EBS ボリュームをデタッチします。 + [--device `value`] — デバイス名。 + [--instance-id] — ターゲットの Amazon EC2 インスタンスの ID。 + --volume-id `value` — ボリュームの ID。 + [disassociate-address](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-address.html) – 仮想 IP アドレスとインスタンスの関連付けを解除します。 + --public-ip — インスタンスからの関連付けを解除する仮想 IP アドレス。 + [get-launch-template-data](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-launch-template-data.html) — 指定したインスタンスの設定データを取得します。このデータを使用して起動テンプレートを作成できます。 + --instance-id – 単一の `sbe` インスタンスの ID。 + --endpoint `snowballEndpoint` – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [modify-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-launch-template.html) — 起動テンプレートを変更します。起動テンプレートのどのバージョンをデフォルトバージョンとして設定するかを指定できます。起動テンプレートのバージョンを指定せずにインスタンスを起動すると、起動テンプレートのデフォルトバージョンが適用されます。 リクエストで起動テンプレート ID または起動テンプレート名を指定します。 + --launch-template-id `string` — 起動テンプレートの ID。 + --launch-template-name `string` — 起動テンプレート名。 + --default-version `string` — デフォルトバージョンとして設定された起動テンプレートのバージョン番号。 + --endpoint `snowballEndpoint` – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「[Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する](#using-ec2-adapter-cli-endpoint)」を参照してください。 + [modify-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html) — 指定したインスタンスの属性を変更します。以下の属性がサポートされています。 + `instanceInitiatedShutdownBehavior` + `userData` + [revoke-security-group-egress](https://docs.aws.amazon.com/cli/latest/reference/ec2/revoke-security-group-egress.html) — セキュリティグループから 1 つ以上の Egress ルールを削除します。 + [--group-id `value`] — セキュリティグループの ID + [--ip-permissions `value`] — IP アクセス許可の 1 つ以上のセット。 + [revoke-security-group-ingress](https://docs.aws.amazon.com/cli/latest/reference/ec2/revoke-security-group-ingress.html) — セキュリティグループに対する 1 つ以上の Ingress ルールを取り消します。`revoke-security-group-ingress` を呼び出すときは、`group-name` または `group-id` のどちらかの値を指定する必要があります。 + [--group-name `value`] — セキュリティグループ名。 + [--group-id `value`] — セキュリティグループの ID。 + [--ip-permissions `value`] — IP アクセス許可の 1 つ以上のセット。 + [--protocol `value`] IP プロトコル。指定できる値は `tcp`、`udp`、および `icmp` です。「すべてのプロトコル」が指定されている場合を除き、`--port` 引数は必須です (-1)。 + [--port `value`] — TCP または UDP 用に許可するポートの範囲。単一の整数または範囲 (最小/最大)。 ICMP の場合、1 つの整数または範囲 (`type`-`code`) です。この場合、`type` は ICMP タイプ番号を表し、`code` は ICMP コード番号を表します。-1 の値は、すべての ICMP タイプのすべての ICMP コードを示します。`type` だけの -1 の値は、特定の ICMP タイプのすべての ICMP コードを示します。 + [--cidr `value`] — CIDR IP の範囲。 + [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) — AMI 用の Snowball AMI ID を使用して、複数のコンピューティングインスタンスを起動します。 **注記** インスタンスのサイズとタイプに応じて、Snowball Edge 上でコンピューティングインスタンスを起動する際に、最大で 1 時間半かかることがあります。 + [--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` の形式で範囲が指定されている場合、最初の数字は起動するインスタンスの最小数と解釈され、2 番目は起動するインスタンスの最大数として解釈されます。 + --image-id — `describe-images` を呼び出して取得できる、AMI の Snowball AMI ID。インスタンスを起動するには、AMI が必要です。 + --InstanceInitiatedShutdownBehavior — デフォルトでは、インスタンスから (shutdown や poweroff などのコマンドを使用して) シャットダウンを開始すると、インスタンスが停止します。この動作を変更して、インスタンスの停止ではなく終了させることができます。パラメータ `stop` および `terminate` がサポートされています。デフォルトは `stop` です。詳細については、*Amazon EC2 Linux インスタンス用ユーザーガイド*の[インスタンスによって開始されるシャットダウン動作の変更](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingInstanceInitiatedShutdownBehavior)を参照してください。 + --instance-type – `sbe` インスタンスタイプ。 + --launch-template `structure` — インスタンスの起動に使用する起動テンプレート。`run-instances` コマンドで指定したパラメータはすべて、起動テンプレート内の同じパラメータを上書きします。起動テンプレートの名前または ID のいずれかを指定できますが、両方を指定することはできません。 ``` { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" } ``` + --security-group-ids — 1 つ以上のセキュリティグループの ID。[CreateSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html) を使用してセキュリティグループを作成できます。値を指定しない場合、デフォルトのセキュリティグループの ID が作成したインスタンスに割り当てられます。 + --tag-specifications — 起動中にリソースに適用されるタグ。起動時にのみインスタンスにタグ付けできます。指定されたタグは、起動時に作成されたすべてのインスタンスに適用されます。作成後のリソースにタグを付けるには、`create-tags` を使用します。 + --user-data — インスタンスで使用可能なユーザーデータ。を使用している場合は AWS CLI、base64 エンコードが実行され、ファイルからテキストをロードできます。それ以外の場合は、base64 でエンコードされたテキストを指定する必要があります。 + --key-name (文字列) — キーペア名。キーペアは、`CreateKeyPair` または `ImportKeyPair` を使用して作成できます。。 **警告** キーペアを指定しない場合、ユーザーが別の方法でログインすることを許可する設定の AMI を選択した場合を除き、インスタンスに接続することはできません。 + [start-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/start-instances.html) — 以前に停止した `sbe` インスタンスを開始します。インスタンスにアタッチされたすべてのリソースは、開始や停止の間は保持されますが、インスタンスを終了させると消去されます。 + --instance-ids – デバイスで停止した 1 つ以上の `sbe` インスタンスの ID。 + [stop-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/stop-instances.html) — 実行中の `sbe` インスタンスを停止します。インスタンスにアタッチされたすべてのリソースは、開始や停止の間は保持されますが、インスタンスを終了させると消去されます。 + --instance-ids – デバイスで停止する 1 つ以上の `sbe` インスタンスの ID。 + [terminate-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/terminate-instances.html) — 1 つ以上のインスタンスをシャットダウンします。このオペレーションはべき等です。インスタンスを複数回終了させると、各コールは成功します。インスタンスにアタッチされたすべてのリソースは、開始や停止の間は保持されますが、インスタンスを終了させるとデータは消去されます。 **注記** デフォルトでは、`shutdown` や `poweroff` などのコマンドを使用してインスタンスからシャットダウンを開始すると、インスタンスは停止します。ただし、`InstanceInitiatedShutdownBehavior` 属性を使用してこの動作を変更し、これらのコマンドでインスタンスを終了させることができます。詳細については、*Amazon EC2 Linux インスタンス用ユーザーガイド*の[インスタンスによって開始されるシャットダウン動作の変更](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingInstanceInitiatedShutdownBehavior)を参照してください。 + --instance-ids — デバイスで終了する 1 つ以上の `sbe` インスタンスの ID。これらのインスタンスに保存されたすべての関連するデータは失われます。 + [create-key-pair](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-key-pair.html) — 指定した名前で 2,048 ビットの RSA キーペアを作成します。Amazon EC2 は公開キーを保存し、ファイルに保存するプライベートキーを表示します。PEM エンコードされた PKCS\$11 形式 (暗号化なし) で、プライベートキーが返されます。指定した名前のキーがすでに存在する場合、Amazon EC2 からエラーが返されます。 + —key-name (文字列) — キーペアの一意の名前。 制約: 最大 255 字の ASCII 文字。 + [--tag-specifications] (リスト) — 新しいキーペアに適用するタグ。 ``` { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ... ``` + [import-key-pair](https://docs.aws.amazon.com/cli/latest/reference/ec2/import-key-pair.html) — + —key-name (文字列) — キーペアの一意の名前。 制約: 最大 255 字の ASCII 文字。 + --public-key-material (blob) — 公開キー。API コールの場合、テキストは base64 でエンコードされている必要があります。コマンドラインツールでは、base64 エンコーディングが自動的に実行されます。 + [--tag-specifications] (リスト) — 新しいキーペアに適用するタグ。 ``` { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ``` + [describe-key-pairs](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-key-pairs.html) — [--filters] (リスト) — フィルター。 + key-pair-id — キーペアの ID。 + key-name — キーペア名。 + tag-key — リソースに割り当てられたタグのキー。このフィルターを使用して、タグの値に関係なく、特定のキーでタグが割り当てられているすべてのリソースを検索します。 + [--tag-specifications] (リスト) — 新しいキーペアに適用するタグ。 + tag :key — リソースに割り当てられたタグのキーと値の組み合わせ。フィルター名にタグキーを使用し、タグ値をフィルター値として使用します。例えば、キー `Owner` と値 `Team A` のタグを持つすべてのリソースを検索するには、`tag:Owner` のフィルター名と `Team A` のフィルター値を指定します。 ``` { "Name": "string", "Values": ["string", ...] } ... ``` + [--key-names] (リスト) — キーペア名。 デフォルト: すべてのキーペアを説明します。 + [--key-pair-ids] (リスト) — キーペアの ID。 + [delete-key-pair](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-key-pair.html) — + [--key-name] (文字列) — キーペア名。 + [--key-pair-id] (文字列) — キーペアの ID。 ## Snowball Edge でサポートされている Amazon EC2-compatible API オペレーション 以下は、Snowball Edge で使用できる Amazon EC2 互換 API オペレーションと、「Amazon EC2 API リファレンス」**内の説明へのリンクです。Amazon EC2 互換 API コールでは、Signature Version 4 (SigV4) 署名が必要です。 AWS CLI または AWS SDK を使用してこれらの API コールを行う場合、SigV4 署名が処理されます。それ以外の場合は、お客様独自の SigV4 署名ソリューションを実装する必要があります。詳細については、「[Snowball Edge でのローカル Amazon S3 認証情報の取得と使用](using-adapter.md#adapter-credentials)」を参照してください。 + [AssociateAddress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AssociateAddress.html) — Elastic IP アドレスをインスタンスまたはネットワークインターフェイスに関連付けます。 + [AttachVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AttachVolume.html) — 以下のリクエストパラメータがサポートされます。 + `Device` + `InstanceId` + `VolumeId` + [AuthorizeSecurityGroupEgress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AuthorizeSecurityGroupEgress.html) — Snowball Edge デバイスで使用するために、1 つ以上の Egress ルールをセキュリティグループに追加します。具体的には、このアクションでは、1 つ以上の IPv4 CIDR アドレス範囲にインスタンスがトラフィックを送信できます。 + [AuthorizeSecurityGroupIngress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AuthorizeSecurityGroupIngress.html) — 1 つ以上の Ingress ルールをセキュリティグループに追加します。AuthorizeSecurityGroupIngress を呼び出すときは、`GroupName` または `GroupId` のどちらかの値を指定する必要があります。 + [CreateVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html) — 次のリクエストパラメータがサポートされます。 + `SnapshotId` + `Size` + `VolumeType` + `TagSpecification.N` + [CreateLaunchTemplate](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateLaunchTemplate.html) — 次のリクエストパラメータがサポートされます。 + `ImageId` + `InstanceType` + `SecurityGroupIds` + `TagSpecifications` + `UserData` + [CreateLaunchTemplateVersion](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateLaunchTemplateVersion.html) + [CreateTags](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html) — 次のリクエストパラメータがサポートされます。 + `AMI` + `Instance` + `Launch template` + `Security group` + [CreateSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html) — Snowball Edge にセキュリティグループを作成します。最大で 50 個のセキュリティグループを作成できます。セキュリティグループを作成するときに、任意のフレンドリ名を指定します。 + [DeleteLaunchTemplate](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteLaunchTemplate.html) + [DeleteLaunchTemplateVersions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteLaunchTemplateVersions.html) + [DeleteSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSecurityGroup.html) — セキュリティグループを削除します。インスタンスに関連付けられている、または他のセキュリティグループによって参照されているセキュリティグループを削除しようとすると、`DependencyViolation` でそのオペレーションは失敗します。 + [DeleteTags](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteTags.html) — 指定したリソースのセットから指定したタグのセットを削除します。 + [DeleteVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteVolume.html) — 次のリクエストパラメータがサポートされます。 + `VolumeId` + [DescribeAddresses](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAddresses.html) + [DescribeImages](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html) + [DescribeInstanceAttribute](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceAttribute.html) – 次の属性がサポートされています。 + `instanceType` + `userData` + [DescribeInstanceStatus](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceStatus.html) + [DescribeLaunchTemplates](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeLaunchTemplates.html) + [DescribeLaunchTemplateVersions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeLaunchTemplateVersions.html) + [DescribeInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) + [DescribeSecurityGroups](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroups.html) – 1 つ以上のセキュリティグループを説明します。`DescribeSecurityGroups` はページ割りされたオペレーションです。複数の API コールを発行して、結果のデータセット全体を取得できます。 + [DescribeTags](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeTags.html) – このコマンドでは、次のフィルタがサポートされています。 + `resource-id` + `resource-type` — AMI あるいはコンピューティングインスタンスのみ + `key` + `value` + [DescribeVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html) — 次のリクエストパラメータがサポートされます。 + `MaxResults` + `NextToken` + `VolumeId.N` + [DetachVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DetachVolumes.html) — 次のリクエストパラメータがサポートされます。 + `Device` + `InstanceId` + `VolumeId` + [DisassociateAddress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DisassociateAddress.html) + [GetLaunchTemplateData](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetLaunchTemplateData.html) + [ModifyLaunchTemplate](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyLaunchTemplate.html) + [ModifyInstanceAttribute](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html) — `userData` の属性のみがサポートされます。 + [RevokeSecurityGroupEgress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RevokeSecurityGroupEgress.html) — セキュリティグループから 1 つ以上の Egress ルールを削除します。 + [RevokeSecurityGroupIngress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RevokeSecurityGroupIngress.html) — セキュリティグループに対する 1 つ以上の Ingress ルールを取り消します。RevokeSecurityGroupIngress を呼び出すときは、`group-name` または `group-id` のどちらかの値を指定する必要があります。 + [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) – **注記** インスタンスのサイズとタイプに応じて、Snowball Edge 上でコンピューティングインスタンスを起動する際に、最大で 1 時間半かかることがあります。 + [StartInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StartInstances.html) + [StopInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html) — 停止したインスタンスに関連付けられているリソースは保持されます。これらのリソースを解放するには、インスタンスを終了させます。ただし、関連付けられているすべてのデータが削除されます。 + [TerminateInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TerminateInstances.html)